Authentication & Authorization
Learn how to properly authenticate your API requests and understand the rate limits.
Basic Authentication with API Key and Secret
To authenticate with Rdentify, you’ll need an API Key and an API Secret. These can be generated within your account or provided by your account manager.
How to Authenticate
Your API Key and Secret should be base64 encoded in a string, separated by a colon (:), and included in the Authorization header of your HTTP request using Basic Authentication.
Authorization: Basic base64(API_KEY:API_SECRET)
For example, if your API Key is abc123 and your API Secret is xyz789, you would first concatenate them with a colon: abc123:xyz789, then base64 encode that string and include it in the Authorization header:
Authorization: Basic YWJjMTIzOnh5ejc4OQ==
Rate Limits
Rdentify imposes a rate limit of 500 requests per minute per IP address. If you exceed this rate limit, the server will respond with a 429 status code.
HTTP Status Code: 429
If you exceed the rate limit, you’ll receive an HTTP 429 status code. You should wait for a minute before attempting additional requests.