Autenticación
La API de Apertur utiliza claves API para la autenticación. Las claves están asociadas a un proyecto.
Formato de clave API
Las claves API siguen el formato:
aptr_{random}| Parte | Valor | Descripción |
|---|---|---|
| aptr | Prefijo fijo | Identifica una clave de Apertur |
| random | 32 caracteres hexadecimales | Secreto criptográficamente aleatorio |
Ejemplo:
aptr_z9y8x7w6v5u4t3s2r1q0p9o8n7m6l5k4
Envío de la clave API
Incluya su clave API en el encabezado Authorization de cada solicitud utilizando el esquema Bearer:
Authorization: Bearer aptr_xxxx
Las claves API deben mantenerse en secreto. Nunca las exponga en JavaScript del lado del cliente ni las incluya en el control de versiones. Utilice variables de entorno en su servidor.
Límites de tasa
La API aplica límites de tasa por clave API. Los límites se devuelven en los encabezados de respuesta:
X-RateLimit-Limit: 100 X-RateLimit-Remaining: 97 X-RateLimit-Reset: 1711627200
| Endpoint | Límite | Ventana |
|---|---|---|
| POST /api/v1/sessions | 100 solicitudes | por minuto |
| GET /api/v1/sessions | 300 solicitudes | por minuto |
| Todos los demás endpoints | 200 solicitudes | por minuto |
Cuando se excede un límite de tasa, la API devuelve 429 Too Many Requests. Consulte la página de Errores para más detalles.