Un token de API permite que tu propio código hable con Ocoya. Encuéntralos en Settings → API — Settings está en el menú de la cuenta, el avatar en la parte superior de la barra lateral.
Esta página trata sobre cómo gestionar los tokens. Para ver cómo llamar realmente a la API — la URL base, la cabecera, los endpoints — consulta la documentación de la REST API.
Empieza aquí. El menú de la cuenta es el avatar en la parte superior de la barra lateral — Settings, luego API en la barra lateral de ajustes.
Settings → API, con la gráfica de peticiones arriba y tus tokens abajo.
Who can use the API
El acceso a la API es solo para owners and admins de una marca.
| Tu rol en una marca | Crear tokens | Un token llega a la marca |
|---|---|---|
| Owner | Sí | Sí |
| Admin | Sí | Sí |
| Manager | No | No |
| Client | No | No |
Un manager que necesite acceso a la API para una marca tiene que ser convertido en admin de esa marca por el owner de la marca (Settings → Members). En la app, la opción de API solo se muestra en Settings a owners y admins.
Create a token
Selecciona Create token y ponle un nombre. El nombre es solo para ti — está ahí para que puedas distinguir los tokens después y revocar el correcto.
Pon nombre a los tokens según dónde se usan, no lo que hacen. Zapier, staging server, reporting script te dicen qué es lo que falla cuando lo revocas. API key 2 no.
Copia el token en cuanto se crea y guárdalo en un lugar seguro. Ocoya solo muestra los primeros y los últimos caracteres después.
What a token can reach
Un token es tuyo y llega a todas las marcas de las que eres owner o admin. Un solo token las cubre todas, incluidas las marcas de las que te conviertan en admin más adelante. No hay forma de limitar un token a una sola marca — la lista de tokens muestra All brands junto a cada uno.
Las marcas a las que llega un token se comprueban en cada petición, según tu rol en ese momento. Si te eliminan de una marca, o dejas de ser su admin, tus tokens dejan de llegar a ella al instante; si te convierten en admin de una marca, empiezan a llegar a ella al instante. Un token puede hacer todo lo que ofrece la API en cada marca a la que llega.
Eso importa si estabas pensando en darle a un desarrollador de un cliente un token solo para su marca. No puedes. Podría llegar a todas las marcas a las que tú puedes.
Un token funciona con todo en la REST API: posts, campañas de IA (crearlas, listarlas y leerlas con sus posts), el perfil y el brand score de cada marca, que también puede actualizar, channels y workflows.
Revoke a token
El menú ⋯ de cualquier token ofrece Delete token. La eliminación es inmediata y permanente — cualquier cosa que use ese token empieza a fallar al instante, así que asegúrate primero de saber qué lo está usando. Para eso están los nombres.
No hay forma de rotar un token en el sitio. Para sustituir uno: crea el token nuevo, pasa tu integración al nuevo y luego elimina el antiguo.
Watching usage
La gráfica API usage muestra las peticiones 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 confirmar que una integración está llamando realmente a Ocoya, o de detectar una que esté llamando mucho más de lo que esperabas.
Ocoya permite 60 requests per minute por key y devuelve 429 Too Many Requests por encima de ese límite. Todos los detalles, incluidas las cabeceras de limitación de velocidad, están en Rate limits.