✨ Positive vibes delivered via REST ✨

Welcome to the Happy API

The Happy API powers joyful training exercises with encouraging messages, healthy status checks, and an easy-to-love developer experience. Explore the endpoints below and start building smiles into your apps.

💖 Check API status live

🌈 GET /v1/automessage

GET https://happy.industrial-linguistics.com/v1/automessage

Fetch a random encouraging message personalized with the recipient's name.

Required query parameters:

Optional: session_id to track training progress.

curl "https://happy.industrial-linguistics.com/v1/automessage?name=Nova&session_id=go_bootcamp"

💌 POST /v1/message

POST https://happy.industrial-linguistics.com/v1/message

Send a heartfelt message from one student to another. Perfect for peer encouragement!

curl -X POST https://happy.industrial-linguistics.com/v1/message \
  -H "Content-Type: application/json" \
  -d '{
        "from": "Sky",
        "to": "River",
        "message": "Your code review kindness made my day!",
        "session_id": "happy_hour"
      }'

Response: Message ID, timestamp, and delivery status.

📬 GET /v1/messages

GET https://happy.industrial-linguistics.com/v1/messages

Gather all the encouraging notes for a specific recipient.

Required query parameters:

Optional: limit (default 10, max 50).

curl "https://happy.industrial-linguistics.com/v1/messages?recipient=River&limit=5"

🩺 GET /v1/status

GET https://happy.industrial-linguistics.com/v1/status

Quick health check. Use this endpoint in your uptime monitors or training scripts.

curl https://happy.industrial-linguistics.com/v1/status

Response: JSON including service status, version, and request counts.

🛠️ Developer Goodies

Level up your integrations with utilities tailored for workshops and classrooms.

# Watch live activity
happywatch

# See summary statistics
happywatch -mode summary

# Export a single student's activity
happywatch -mode export -student "River" > river.csv