DocumentaciónClaves de API
Empezar
Claves de API
Una clave identifica tu aplicación ante la API. Se guarda en tu servidor, como una contraseña.
Cómo es una clave
Una clave siempre empieza por lya, seguido de su tipo. El tipo indica en nombre de quién actúa.
| Prefijo | Tipo | Para |
|---|---|---|
lya_svc_ | Servicio | Una aplicación o un servidor de tu espacio de trabajo |
lya_usr_ | Personal | Una persona, con sus propios permisos |
lya_prt_ | Socio | Una integración construida con Learnya |
Learnya solo guarda una huella, que no permite volver a leerla. Una clave perdida no se recupera, se sustituye.
Dónde enviarla
En la cabecera Authorization, después de Bearer. Los SDK de OpenAI lo hacen por ti. También se acepta la cabecera x-api-key.
| Cabecera | Ejemplo |
|---|---|
Authorization | Bearer lya_svc_… |
x-api-key | lya_svc_… |
Una clave rechazada recibe una respuesta 401, sin indicar el motivo. Así, un tercero que prueba claves no averigua nada.
Obtener una clave
Las claves están disponibles para los espacios de trabajo Team y los socios. La creamos contigo y elegimos juntos:
- su nombre, para reconocerla en tu espacio de trabajo
- su ámbito, que debe incluir llm:invoke para llamar a los modelos
- una fecha de caducidad si la clave es para un proyecto limitado en el tiempo
La clave se te muestra una sola vez, al crearla.
Mantenerla en secreto
- Una clave por aplicación, para poder desactivar una sin detener las demás
- En una variable de entorno o un gestor de secretos, nunca en el repositorio de código
- Una clave revocada deja de funcionar en menos de un minuto