Best practices

⏱️ Rate limiting

  • Default limit: 60 requests/minute per App Secret
  • Exceeding the limit returns: 429 Too Many Requests

🔁 Retry policy

Recommended exponential backoff:

  • Retry after 2 seconds
  • Double delay each time
  • Stop after 5 attempts max

🔐 Security

  • HTTPS required for all requests
  • Never expose secrets in client-side code
  • Rotate secrets periodically

🔖 Versioning

Falco API is versioned via the URL:

https://api.falco-app.be/v1/