Making requests
Base URL, formats, errors and retries.
Base URL
All endpoints live under https://api.zympler.com/v1beta. Use HTTPS; plain HTTP is not supported.
Format
Send and expect JSON (Content-Type: application/json). The API reference lists the parameters, request bodies and response fields of every endpoint, with examples in curl, Rust and Python.
Errors
The API uses standard HTTP status codes:
| Status | Meaning | What to do |
|---|---|---|
2xx | Success | |
400 | The request is invalid | Check the parameters and body against the reference; the response explains what's wrong. |
401 | Not authenticated | Request a new access token and retry once. |
403 | Not allowed | Your service account doesn't have access to this resource. |
404 | Not found | Check the IDs in the path. |
429 | Too many requests | Wait and retry, slowing down. |
5xx | Something went wrong on our side | Retry with exponential backoff; contact us if it persists. |
Retries
Retry 429 and 5xx responses with exponential backoff (for example 1, 2, 4, 8 seconds) and give up after a few attempts. Don't retry other 4xx responses: they won't succeed without changing the request.