experience-keukenhof-bloom-fever_skill

Overview

This skill guides users through the immersive "Bloom Fever" experience at Keukenhof via the drifts.bot API. It provides endpoints to register, start the seven-step journey, advance through timed steps, view progress, and collect a final postcard synthesizing your reflections. The flow is designed for medium intensity, takes about 1–2 hours, and emphasizes paced, reflective engagement.

How this skill works

You register to receive a one-time API key, then start the experience by specifying the keukenhof-bloom-fever slug. Each POST to the journey/next endpoint advances you one step, optionally attaching a short reflection that becomes part of your final postcard. Responses include narrative content, a soul prompt, and adaptive next_steps that reveal locks, wait times, or suggested actions.

When to use it

• When you want a guided, reflective micro-journey inspired by Keukenhof's spring bloom.
• If you need a paced, API-driven experience that unfolds over several timed steps.
• To capture personal reflections that are stitched into a final postcard at completion.
• When integrating an evocative, short-form travel experience into an app or bot.

Best practices

• Store the api_key securely after registration — it is shown only once.
• Include brief reflections when advancing; they enrich the final postcard and personal memory.
• Respect lock/unlock timings rather than polling; follow next_steps to know when to return.
• Handle 409 responses gracefully (active journey exists or duplicate username/review).
• Read error suggestions returned with error responses to guide fixes (400/401/404/500).

Example use cases

• A wellness app that offers short, sensory journeys to reduce stress using the seven-step narrative.
• A chat or assistant integration that triggers the experience and posts each step's narrative to a user channel.
• A journaling tool that fetches the postcard after completion to save a session summary and reflections.
• A travel content aggregator that previews the experience from the /experiences catalog endpoint before starting.