🌈 GET /v1/automessage
Fetch a random encouraging message personalized with the recipient's name.
Required query parameters:name— the lucky person who needs a boost (1–50 chars)
Optional: session_id to track training progress.
curl "https://happy.industrial-linguistics.com/v1/automessage?name=Nova&session_id=go_bootcamp"
💌 POST /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
Gather all the encouraging notes for a specific recipient.
Required query parameters:recipient— whose inbox to peek at
Optional: limit (default 10, max 50).
curl "https://happy.industrial-linguistics.com/v1/messages?recipient=River&limit=5"
🩺 GET /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.
- happywatch — real-time CLI monitor to track student progress.
- Rate limiting — friendly 100 requests/minute per IP to keep things smooth.
- Session tracking — use
session_idto group activity by cohort. - SQLite backend — easy to inspect and reset between training runs.
# Watch live activity
happywatch
# See summary statistics
happywatch -mode summary
# Export a single student's activity
happywatch -mode export -student "River" > river.csv