Autorización y formato de solicitud de la API del servidor
Autorización
Las solicitudes a la API deben autenticarse con tu clave de API secreta o pública como cabecera de autorización. Puedes encontrarlas en App Settings. El formato del valor es Api-Key {your-secret-api-key}, por ejemplo, Api-Key secret_live_....
Las claves de 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 servidor requieren cabeceras específicas y un cuerpo en JSON. Usa los detalles a continuación para estructurar tus solicitudes.
| Cabecera | Descripción |
|---|---|
| adapty-profile-id | El ID de perfil de Adapty del usuario. Visible en el campo Adapty ID en Adapty Dashboard -> Profiles -> página del perfil específico. Es intercambiable con adapty-customer-user-id; usa cualquiera de los dos. |
| adapty-customer-user-id | El ID del usuario en tu sistema. Visible en el campo Customer user ID en Adapty Dashboard -> Profiles -> página del perfil específico. Es intercambiable con adapty-profile-id; usa cualquiera de los dos. ⚠️ Solo funciona si identificas usuarios en tu app iOS, Android, React Native, Flutter, y Unity en el código de tu app usando el SDK de Adapty. |
| adapty-platform | (opcional) Especifica la plataforma del dispositivo en el que está instalada la app. Recomendamos establecer este parámetro en las solicitudes Crear perfil y Actualizar perfil al modificar el objeto Installation Meta, ya que depende del dispositivo que utilice el usuario y un mismo usuario puede tener varios dispositivos. Valores posibles: iOS, macOS, iPadOS, visionOS, Android o web. |
| Content-Type | Establécelo en application/json para que la API procese la solicitud. |
Cuerpo
La API espera un cuerpo en formato JSON con los datos necesarios para la solicitud.
Límites de frecuencia
Para evitar la limitación de velocidad, asegúrate de que el número de solicitudes (por app) se mantenga por debajo de 40 000 por minuto.
Si se supera este límite, el sistema puede ralentizarse o bloquear temporalmente más solicitudes para mantener un rendimiento óptimo para todos los usuarios.
Rotar claves de API
Si necesitas rotar las claves de 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: