---
title: "Autorización y formato de solicitud de la API del servidor"
description: ""
---

## Autorización \{#authorization\}

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**](https://app.adapty.io/settings/general). El formato del valor es `Api-Key {your-secret-api-key}`, por ejemplo, `Api-Key secret_live_...`.

:::important
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 \{#request-format\}

**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**       | <p>El ID de perfil de Adapty del usuario. Visible en el campo **Adapty ID** en [Adapty Dashboard -> **Profiles**](https://app.adapty.io/profiles/users) -> página del perfil específico. </p><p>Es intercambiable con **adapty-customer-user-id**; usa cualquiera de los dos.</p> |
| **adapty-customer-user-id** | <p>El ID del usuario en tu sistema. Visible en el campo **Customer user ID** en [Adapty Dashboard -> **Profiles**](https://app.adapty.io/profiles/users) -> página del perfil específico. </p><p>Es intercambiable con **adapty-profile-id**; usa cualquiera de los dos.</p><p> ⚠️ Solo funciona si <InlineTooltip tooltip="identificas usuarios en tu app">[iOS](identifying-users), [Android](android-identifying-users), [React Native](react-native-identifying-users), [Flutter](flutter-identifying-users), y [Unity](unity-identifying-users)</InlineTooltip> en el código de tu app usando el SDK de Adapty.</p> |
| **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](api-adapty/operations/createProfile) y [Actualizar perfil](api-adapty/operations/updateProfile) al modificar el objeto [Installation Meta](server-side-api-objects#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 \{#rate-limits\}

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 \{#rotate-api-keys\}

Si necesitas rotar las claves de API secretas:

1. En **Settings → General**, haz clic en **Generate new key** y luego en el icono de papelera junto a la clave antigua.
2. Actualiza la clave utilizada en tu app.

---

**Próximos pasos — solicitudes:**

- [Obtener perfil](api-adapty/operations/getProfile)
- [Crear perfil](api-adapty/operations/createProfile)
- [Actualizar perfil](api-adapty/operations/updateProfile)
- [Eliminar perfil](api-adapty/operations/deleteProfile)
- [Conceder nivel de acceso](api-adapty/operations/grantAccessLevel)
- [Revocar nivel de acceso](api-adapty/operations/revokeAccessLevel)
- [Establecer transacción](api-adapty/operations/setTransaction)
- [Validar compra, proporcionar nivel de acceso al cliente e importar su historial de transacciones](api-adapty/operations/validateStripePurchase)
- [Obtener paywall](api-adapty/operations/getPaywall)
- [Listar paywalls](api-adapty/operations/listPaywalls)
- [Actualizar paywall](api-adapty/operations/updatePaywall)