Autenticación y claves de API
Cómo enviar tu clave de API, cuántas claves puedes tener, qué puede hacer y qué no una clave, qué hacer si se filtra y cómo desconectar un asistente de IA.
Envía la clave en el encabezado Authorization
Authorization: Bearer YOUR_API_KEYEse encabezado es el único lugar donde la API lee una clave.
- Nunca pongas una clave en una URL (
?api_key=…). Las URL acaban en registros, en el historial del navegador y en enlaces compartidos. La API rechaza una solicitud así con400 api_key_in_query. Considera esa clave expuesta: revócala y crea una nueva. - Llama exactamente a
https://gloriads.com/api/v1: un cliente que sigue una redirección a otra dirección pierde tu clave por el camino. - Llama a la API desde una hoja de cálculo, un script o un servidor, no desde el código de una página web: cualquiera que visite la página podría leer la clave.
Qué puede hacer una clave
- Leer tu cuenta, en todos los endpoints.
- No cambiar nada. La API es de solo lectura.
- Compartir los límites de tu cuenta: todas tus claves y tus asistentes de IA conectados cuentan juntos, así que una segunda clave no te da más solicitudes. Consulta Límites y errores.
Crear una clave
Configuración → API → Crear una clave.
- El nombre puede tener hasta 40 caracteres. Usa el nombre de la herramienta, para saber más adelante qué clave revocar.
- La clave se muestra una vez. Solo guardamos una huella de ella, así que nadie puede volver a mostrarla, ni siquiera nosotros. Guárdala en un gestor de contraseñas o en la configuración de secretos de tu herramienta.
- Puedes tener 10 claves a la vez.
- La cuenta pública de demostración no puede crear claves.
La lista de claves
Cada clave muestra su nombre, sus primeros caracteres (key_live_ab12…), cuándo
se creó y cuándo se usó por última vez.
“Último uso” se actualiza como mucho una vez por hora, así que una clave usada hace unos minutos puede mostrar todavía una hora anterior.
Revocar una clave
Abre el menú ⋯ de la clave y luego Revocar.
Surte efecto de inmediato: la siguiente solicitud con esa clave recibe
401 unauthorized, la misma respuesta que una clave que nunca existió. Una clave
revocada no se puede restaurar: crea una nueva.
Asistentes de IA conectados sin clave
claude.ai y ChatGPT no usan ninguna clave: inicias sesión en Gloriads desde el asistente y haces clic en Permitir. El asistente obtiene entonces su propio acceso, que solo puede leer. Cómo conectar uno: Conectar un asistente de IA.
- Configuración → API → Aplicaciones conectadas lista cada asistente, la dirección que pidió el acceso, cuándo lo conectaste y cuándo leyó tu cuenta por última vez (se actualiza como mucho una vez por hora).
- Sin verificar junto a un nombre significa que la aplicación se registró sola sin demostrar su dirección. Consérvala solo si la conectaste tú.
- Para detener uno, abre su menú ⋯ y luego Desconectar. Surte efecto de inmediato. Para volver a usarlo, conéctalo de nuevo desde el asistente.
Cuando se rechaza una solicitud
| Respuesta | Por qué | Qué hacer |
|---|---|---|
401 unauthorized | No hay encabezado Authorization, o la clave es incorrecta o está revocada | Revisa el encabezado y la clave |
403 subscription_inactive | Tu suscripción terminó | Suscríbete en Configuración → Facturación |
400 api_key_in_query | La clave estaba en la URL | Pásala al encabezado y luego revócala |
Todos los demás códigos se describen en Límites y errores.
La clave pública de demostración
La referencia de la API rellena de antemano su botón Try it con una clave pública. Solo lee la cuenta de demostración y está limitada a 10 solicitudes por minuto, compartidas por todos los visitantes. No puede leer tu cuenta: para eso, usa tu propia clave.