🐝 Bee API 🐝

The sweetest API for buzzing around!

GET /hive

Returns information about the hive, including its mood, honey stock, and ongoing bee drama.

Request

GET https://api.beehive.com/v1/hive

Response

{
  "hive_mood": "buzzing with passive aggression",
  "honey_stock": "low, but we pretend it's fine",
  "queen_status": "still waiting for the queen to acknowledge our hard work",
  "bee_drama": "Gina won't stop gossiping about Steve stealing nectar"
}

POST /foraging

Send a bee on a foraging mission to collect nectar or pollen.

Request

POST https://api.beehive.com/v1/foraging

Request Body

{
  "bee_name": "Buzz",
  "task": "nectar",
  "flower": "lavender"
}

Response

{
  "status": "success",
  "message": "Buzz is off to get some lavender nectar. Hopefully, he doesn't get distracted.",
  "return_eta": "15 minutes"
}

GET /honey

Retrieve the hive's current honey stock and its quality level.

Request

GET https://api.beehive.com/v1/honey

Response

{
  "total_honey_stock": "5kg",
  "quality": "passable, but definitely not artisan"
}

POST /sting

Triggers a bee to sting a target (use responsibly!).

Request

POST https://api.beehive.com/v1/sting

Request Body

{
  "bee_name": "Buzzy",
  "target": "AnnoyingHuman"
}

Response

{
  "status": "success",
  "message": "Buzzy has stung AnnoyingHuman. Buzzy is now on a heroic farewell journey to bee heaven."
}