API Overview
Conventions
| Concern | Format |
|---|---|
| Auth | Authorization: Bearer <accessToken> |
| Time | ISO-8601 UTC |
| IDs | uuidv7; did:web:yourdomain.com:users:<uuid> |
| Pagination | ?cursor=&limit= → response contains { "nextCursor"? } |
| Errors | { "code", "message", "details"? } |
Endpoint Families
| Area | Example Paths |
|---|---|
| Auth & Account | /auth/*, /account, /push/register |
| Profile & Avatars | /profiles/*, /avatars/jobs |
| Feed & Matches | /feed, /matches/* |
| Story Mode | /story/* |
| Intents | /intents/* |
| Reveal | /reveal/* |
| Safety | /reports, /blocks/* |
| Labels | /labels/* (read-only) |
| Analytics | /analytics/* |