Un token de API permite que tu propio código hable con Ocoya. Los encontrarás en Settings → API. Settings está en el menú de la cuenta, el avatar que aparece arriba en la barra lateral.
Esta página explica cómo gestionar los tokens. Para saber cómo llamar a la API (la URL base, la cabecera, los endpoints), consulta la documentación de la API REST.
Empieza aquí. El menú de la cuenta es el avatar de la parte superior de la barra lateral: Settings y después API en la barra lateral de ajustes.
Settings → API, con el gráfico de solicitudes arriba y tus tokens debajo.
Crear un token
Selecciona Create token y ponle un nombre. El nombre es solo para ti: sirve para distinguir los tokens más adelante y revocar el correcto.
Pon a los tokens el nombre del lugar donde se usan, no de lo que hacen. Zapier, servidor de pruebas, script de informes te dice qué dejará de funcionar si lo revocas. API key 2 no.
Copia el token en cuanto se cree y guárdalo en un lugar seguro. Después, Ocoya solo muestra los primeros y los últimos caracteres.
A qué puede acceder un token
Cada token puede acceder a todas las marcas de esta cuenta. No se puede limitar un token a una sola marca: la lista de tokens muestra All brands junto a cada uno.
Esto importa si pensabas darle a la persona desarrolladora de un cliente un token solo para su marca. No es posible. Podría acceder a todas las marcas que tienes.
Revocar un token
El menú ⋯ de cada token ofrece Delete token. La eliminación es inmediata y permanente: todo lo que use ese token empieza a fallar al instante, así que asegúrate de saber qué lo usa antes de borrarlo. Para eso sirven los nombres.
No se puede rotar un token en el mismo sitio. Para sustituir uno: crea el token nuevo, pasa tu integración a él y después elimina el antiguo.
Controlar el uso
El gráfico API usage muestra las solicitudes autenticadas de la marca actual durante la última hora, el último día o los últimos 30 días. Es la forma más rápida de comprobar que una integración realmente llama a Ocoya, o de detectar una que llama mucho más de lo esperado.
Ocoya permite 60 solicitudes por minuto por clave y devuelve 429 Too Many Requests si se supera. Encontrarás todos los detalles, incluidas las cabeceras de límite de uso, en Rate limits.