Appearance
Usage Terms, Rate Limits, and Error Handling
Usage of the Jabra Plus APIs is free during the beta period. After this, APIs may become available as a paid service.
For legal terms, see Jabra Plus legal agreements.
Rate limits and quota
The Jabra Plus APIs are governed by the following general limits (both apply):
- 10,000 API calls every five minutes
- 100 API calls per second
For firmware updates, device setting changes, and reboot operations:
- One API request every minute per device
When limits are exceeded, the API returns HTTP 429 Too Many Requests with a Retry-After header.
Clients should treat HTTP 429 as an expected condition and:
- Respect the
Retry-Afterheader - Apply exponential backoff and jitter
Best practices
- Cache responses when appropriate
- Use pagination efficiently with a page size of 100
- Batch non-urgent operations during off-peak periods
Error handling
Common HTTP status codes:
- 200 OK: Successful request
- 400 Bad Request: Invalid parameters
- 401 Unauthorized: Missing or invalid subscription key
- 404 Not Found: Room or device not found
- 429 Too Many Requests: Rate limit exceeded
- 500 Internal Server Error: Server-side issue