Cómo generar un token de API en Requiply
Respuesta rápida
En Requiply, los tokens de API se llaman claves de API. Una clave permite que el SDK de TypeScript, la API REST o tu propio agente de IA trabajen con los datos de tu organización. Cada clave pertenece a la organización, no a una persona, así que sigue funcionando cuando alguien deja tu equipo.
1. Abre las claves de API
Ajustes → Organización → Claves de API.
- Claves de API en el menú de ajustes, o abre app.requiply.com/settings/org/api-keys.
- Crear clave abre el formulario.
- Clave: cada clave existente, enmascarada hasta su prefijo y sus cuatro últimos caracteres.
- Acciones: el lápiz cambia el nombre de una clave y el icono de prohibido la revoca.
¿No ves la página? Solo se muestra a los miembros con el rol Administrador.
2. Ponle nombre a la clave y elige su tipo
El diálogo Crear clave de API.
- Nombre: dónde se usa la clave, por ejemplo Web de reservas o Sincronización con contabilidad.
- Tipo: Secreta para código de servidor, Publicable para una web o una app que se ejecuta en el navegador.
- Crear clave.
| Tipo | Empieza por | Para qué sirve |
|---|---|---|
| Secreta | rq_sk_ | Servidores, scripts e integraciones internas. Acceso completo a las reservas, los clientes, las ventas y los informes de la organización. |
| Publicable | rq_pk_ | Tiendas online y widgets. Lee el catálogo, calcula presupuestos y envía solicitudes de reserva que tu equipo aprueba. |
La comparación completa está en Elegir el tipo de clave.
3. Copia la clave y guárdala
La única vez que se muestra la clave completa.
- La clave completa.
- Copiar y después pulsa Listo.
Guarda una clave secreta en una variable de entorno de tu servidor, nunca en código del navegador ni en un repositorio de Git:
REQUIPLY_SECRET_KEY=rq_sk_live_...
4. Usa la clave
Envía la clave como token de portador (bearer token) en cada petición:
curl https://api.requiply.com/api/public/v1/org/info \
-H "Authorization: Bearer $REQUIPLY_SECRET_KEY"
Con el SDK, pásala al cliente. Consulta Cómo empezar a usar el SDK de Requiply.
Preguntas frecuentes
¿Puedo volver a ver una clave después de cerrar el diálogo?
No. Requiply solo guarda un hash de la clave. Si la pierdes, crea una clave nueva, actualiza tu integración y revoca la antigua.
¿Cómo revoco una clave?
Pulsa el icono de prohibido en la fila de la clave. La clave deja de funcionar al momento y no se puede recuperar. Activa Mostrar revocadas para ver las claves revocadas.
¿Hay una clave de prueba?
No. Todas las claves trabajan con datos reales. Haz las pruebas en una organización de demostración cuyas reservas puedas borrar. Consulta Sin modo de prueba.
¿Necesito una clave para conectar Claude o ChatGPT?
No. Los asistentes se conectan con OAuth y no necesitan clave. Consulta Cómo empezar a usar el servidor MCP de Requiply. Una clave secreta solo hace falta para un agente que construyas tú.
¿Cuántas peticiones puede hacer una clave?
100 peticiones por minuto. Las siguientes reciben una respuesta 429 con la cabecera Retry-After. Consulta Límites de peticiones.
Resumen
Crea tiendas online de alquiler, integraciones de servidor y agentes de IA sobre Requiply con el SDK de TypeScript, la API REST pública o el servidor MCP.
Empezar a usar el SDK
Instala @requiply/api-sdk desde npm, crea un RequiplyClient con una clave de API secreta y haz tus primeras llamadas a la API pública de Requiply.