Una clave de API permite que un programa actúe en nombre de tu cuenta. La herramienta de línea de comandos, la REST API, un paso de Zapier o tu propio script usan una. Las apps de IA que admiten inicio de sesión, como Claude y ChatGPT, no necesitan ninguna clave.
Crea una clave
Abre Configuración y elige Claves de API.
- Escribe un nombre en el campo junto a Nueva clave. Ponle el nombre del lugar donde se va a usar, como "cli en mi portátil" o "zapier".
- Haz clic en Crear clave.
- Copia la clave de inmediato. Empieza por
ag_live_y solo se muestra completa una vez. Después, la lista muestra los primeros caracteres, cuándo se creó y cuándo se usó por última vez.
Guarda la clave en un gestor de contraseñas o en la configuración de secretos de tu herramienta. Nunca la pongas en un documento compartido, en una captura de pantalla ni en un chat.
Usa la clave
La herramienta de línea de comandos te pide la clave una vez cuando ejecutas npx argorant login y la guarda en tu equipo. Para la REST API, la envías en una cabecera con cada solicitud.
curl https://app.argorant.com/api/mcp/account \
-H "Authorization: Bearer ag_live_..."Esa primera llamada muestra tu plan y tu saldo, una buena forma de comprobar que la clave funciona. Claves de API y la REST API enumera los endpoints principales, y la CLI de Argorant cubre la herramienta de línea de comandos.
Una clave por herramienta
Da a cada herramienta y a cada persona su propia clave. Así ves qué clave se usó y cuándo, y puedes desactivar una sin romper todo lo demás. Las claves comparten los créditos de tu cuenta, así que una clave no tiene saldo propio. Cada clave tiene su propio límite de velocidad, y las búsquedas tienen límites diarios durante la prueba. Límites de frecuencia y cupos diarios tiene las cifras de cada plan.
Rotar y revocar
Para sustituir una clave, crea primero la nueva, ponla en la herramienta, comprueba que funciona y luego haz clic en Revocar junto a la antigua. La revocación es inmediata. La siguiente solicitud con la clave antigua se rechaza.
Si una clave acaba donde no debería, como un repositorio de código público o una pantalla compartida, revócala de inmediato y crea una nueva. Después revisa tus exportaciones recientes para ver si se ejecutó algo que no iniciaste tú. Qué hacer si se filtra una clave de API tiene la lista de comprobación completa.
Webhooks
Debajo de las claves puedes agregar un webhook. Argorant llamará a tu dirección cuando ocurra algo, por ejemplo cuando una exportación esté lista, una lista termine de llenarse, llegue una respuesta o se pause una campaña. Pega la dirección en Nuevo webhook, elige los eventos y haz clic en Agregar webhook. Cada llamada va firmada, así que tu servidor puede comprobar que viene de nosotros. Webhooks muestra qué contiene cada evento.
