Autorización y formato de solicitud para la API de exportación de analíticas
Autorización
Necesitas autenticar tus solicitudes a la API con tu clave API secreta como cabecera de autorización. Puedes encontrarla en App Settings. El formato es Api-Key {YOUR_SECRET_API_KEY}, por ejemplo: Api-Key secret_live_....
Las claves API son específicas de cada app. Si tienes varias apps, asegúrate de usar claves distintas para cada una.
Formato de solicitud
Cabeceras
Las solicitudes a la API del lado del servidor requieren cabeceras específicas y un cuerpo JSON. Usa los detalles a continuación para estructurar tus solicitudes:
| Cabecera | Descripción |
|---|---|
| Content-Type | (Obligatorio) Establece application/json para que la API procese la solicitud. |
| Adapty-Tz | (Opcional) Define la zona horaria para determinar cómo se agrupan y muestran los datos. Usa el formato de la base de datos de zonas horarias IANA (p. ej., Europe/Berlin). |
Cuerpo
La API espera un cuerpo en formato JSON con los datos necesarios para la solicitud.
Límites de velocidad
El máximo es 2 solicitudes por segundo por aplicación. Todas las claves API de la misma aplicación comparten este límite, por lo que añadir una clave no incrementa la capacidad. Si se supera el límite, se devuelve un error 429 Too Many Requests.
Adapty también limita el tráfico total de la API entre todas las aplicaciones, por lo que una solicitud puede fallar ocasionalmente con 429 aunque tu aplicación esté por debajo de su propio límite. La respuesta no incluye el encabezado Retry-After. Para recuperarte, espera hasta un minuto y vuelve a intentarlo con retroceso exponencial.
Rotar claves API
Si necesitas rotar las claves API secretas:
- En Settings → General, haz clic en Generate new key y luego en el icono de papelera junto a la clave antigua.
- Actualiza la clave utilizada en tu app.
Próximos pasos: Solicitudes: