Authentication

To access the various endpoints in the Planet API, you'll need to authenticate your requests. This guide provides an overview of the authentication process. The Planet API primarily uses API key authentication for securing its endpoints.

API Key Authentication

API key authentication is a simple and secure method to authenticate your requests. You'll be provided with an API key, which you should include in the header of your HTTP requests. Here's how to authenticate using cURL:

Example CURL request with an API key

curl https://api.planet.bg/v1/holidays \
  -H "Content-Type: application/json" \
  -H "api_key: YOUR_API_KEY"

Always ensure that your API key remains confidential. Avoid exposing it in client-side code or public repositories. If you suspect that your API key has been compromised, contact us immediately.

Rate Limiting

Rate limits specify the maximum number of requests (GET, POST, PUT, or DELETE) a user can make in a given time period. If you exceed the rate limit, you'll receive a 429 Too Many Requests response. If you need a higher rate limit, contact us.

We apply rate limits at the IP address level.