Authentication
All requests to the Shiftkeeper API must be authenticated using anx-api-key header with your API key.
Go to Settings > API Keys to generate your API key.
Content types
The API accepts JSON in the request body and returns JSON in the response body. Make sure to include thecontent-type: application/json header in your requests.
Response codes
The API uses standard HTTP status codes to indicate the success or failure of your request. Generally2xx HTTP status codes indicate success, 4xx codes indicate client errors and 5xx indicate errors originating from Shiftkeeper servers.
Check out the Errors page for a detailed list of errors.
Rate limits
Responses include rate limit headers that indicate the number of requests you can make in a given time period.| Header | Description |
|---|---|
x-ratelimit-limit | Maximum number of requests allowed within a time window |
x-ratelimit-remaining | Number of requests remaining in the current time window |
x-ratelimit-reset | Time in seconds until the rate limit window resets |
retry-after | Time in seconds you need to wait before making another request (only present when rate limits are exceeded) |