Sample Chat - API Docs

Login

• POST /api/sessions
  {"sub":"<email>"}

  # Ask for an auth code (swap sub)
  
  curl -X POST http://localhost:4080/api/sessions \
    -H 'Content-Type: application/json; charset=utf-8' \
    -d '{"sub":"jon@example.com"}'
      

• POST /api/sessions/<id>
  {"otp":"<auth-code>"}

  # Validate auth code (swap session id, sub, and otp)
  
  curl -X POST http://localhost:4080/api/sessions/xyz \
    -H 'Content-Type: application/json; charset=utf-8' \
    -d '{"otp":"secret123"}'
      

Messages

• POST /api/rooms/general
  Authorization: Bearer <api-token>
{"message":"<msg>"}

  # Post a message (swap api-token)
  
  curl -X POST http://localhost:4080/api/rooms/general \
    -H 'Authorization: Bearer api-token' \
    -H 'Content-Type: application/json; charset=utf-8' \
    -d '{"message":"Hello, World!"}'
      

• GET /api/rooms/general
  Authorization: Bearer <api-token>

  # Get a room's messages (swap api-token, since unix-epoch)
  
  curl http://localhost:4080/api/rooms/general \
    -H 'Authorization: Bearer api-token'