REST API¶
TRAPPER Expert exposes a REST API built on Django REST Framework, alongside the documented endpoints below for specific workflows.
Interactive API documentation¶
| Tool | URL |
|---|---|
| Swagger UI | /docs/api/ |
| ReDoc | /docs/api/redoc/ |
| OpenAPI schema (JSON/YAML) | /docs/api/swagger.json, /docs/api/swagger.yaml |
These are auto-generated from the live API and are the authoritative, always-current reference for every endpoint, request/response shape, and auth scheme.
Authentication¶
Standard DRF authentication is supported: Session, OAuth2, or Token. For token auth, open Edit profile (top-right user menu in the Expert admin), find the API token (DRF) section, and click Generate API token. Then send it as:
Authorization: Token <your-api-token>
Documented workflows¶
A few endpoints have dedicated how-to coverage beyond the auto-generated schema:
- Camtrap DP export —
GET /media_classification/api/package/{project_pk}/, with curl/Python examples for generating and downloading data packages programmatically.
For every other endpoint, use the Swagger/ReDoc UI above — it reflects the actual deployed schema, which is more reliable than hand-maintained endpoint lists.