54 lines
624 B
Markdown
54 lines
624 B
Markdown
# API Response and Error Contract
|
|
|
|
## Standard error
|
|
|
|
All API errors must use:
|
|
|
|
```json
|
|
{
|
|
"error": {
|
|
"code": "STRING_CODE",
|
|
"message": "Human readable message.",
|
|
"details": {}
|
|
}
|
|
}
|
|
```
|
|
|
|
## Job response
|
|
|
|
Long-running operations return:
|
|
|
|
```json
|
|
{
|
|
"job_id": "uuid",
|
|
"analysis_run_id": "uuid",
|
|
"status": "queued",
|
|
"status_url": "/analysis-runs/{id}"
|
|
}
|
|
```
|
|
|
|
## Resource metadata
|
|
|
|
Resources should include:
|
|
|
|
```json
|
|
{
|
|
"id": "uuid",
|
|
"created_at": "ISO-8601",
|
|
"updated_at": "ISO-8601"
|
|
}
|
|
```
|
|
|
|
## Pagination
|
|
|
|
List endpoints use:
|
|
|
|
```json
|
|
{
|
|
"items": [],
|
|
"total": 0,
|
|
"limit": 50,
|
|
"offset": 0
|
|
}
|
|
```
|