Authentication
Every request needs a bearer token. Request one from support@smart11.ai. A token is shown once, at creation.
Header
GET /analyses/{id}/summary
Authorization: Bearer YOUR_API_TOKEN
Accept: application/json
A token inherits the permissions of the user account it belongs to, and reaches only the videos and analyses of that account. Store it in an environment variable or a secrets manager, keep it out of version control, and rotate it periodically.
Error responses
| Status | Meaning |
|---|---|
| 401 | Missing, malformed or invalid token |
| 403 | Valid token without access to this video or analysis |
{ "message": "Unauthenticated." }
These two errors always carry message, also on result endpoints. Other errors from result endpoints carry detail. See Response format.