API Reference

This section documents the public API endpoints for the Earthquake Catalogue Platform, including request/response payloads, parameters, and error conditions.

• Catalogues API
• Events API
• Import API
• Upload API
• Merge API
• Export API
• Health Check API
• Error Responses
• Authentication API Overview

Security Features

Security Features

Rate Limiting

All API endpoints are protected by rate limiting to prevent abuse:

• Read operations (GET requests): 120 requests per minute

• Write operations (POST/PUT/DELETE/PATCH): 60 requests per minute

When rate limit is exceeded, the API returns 429 Too Many Requests with the following headers: - X-RateLimit-Limit: Maximum requests allowed - X-RateLimit-Remaining: Remaining requests in current window - X-RateLimit-Reset: Timestamp when the limit resets - Retry-After: Seconds to wait before retrying

Example Rate Limit Response: .. code-block:: json

{

“error”: “Too many requests. Please try again later.”, “retryAfter”: 45

}