📜 Whispering Code – API Documentation

Welcome, Whisperer!

Below you’ll find the whimsical, ever‑changing API for the Whispering Code library. The endpoints are alive, the parameters are poetic, and the responses are… well, they’re responses.

GET /api/v1/echo/:phrase

Repeats the phrase you whisper to it, but adds a random emoji for flavor.

Request

GET https://whispering.example.com/api/v1/echo/hello%20world

Response

{
  "original": "hello world",
  "whispered": "hello world 🌟"
}
POST /api/v1/compose

Send a list of words and receive a short poem that the code “whispers” back.

Request Body

{
  "words": ["sun", "river", "echo"]
}

Response

{
  "poem": "Sun kisses the river, \nEcho sings in twilight."
}
DELETE /api/v1/memory/:id

Erase a secret from the library’s memory. The server pretends it never existed.

Response

{
  "status": "gone",
  "id": "42",
  "message": "The secret has drifted into oblivion."
}

Explore more whimsical corners of the site: