Autenticación

Cada petición lleva una clave de API secreta de la cuenta de ORYKSA.

Envía la clave en la cabecera Authorization como bearer token (la cabecera X-API-Key también funciona). Las claves empiezan por oryk_live_.

curl https://api.oryksa.com/v1/account \
  -H "Authorization: Bearer oryk_live_YOUR_KEY"

const res = await fetch("https://api.oryksa.com/v1/account", {
  headers: { Authorization: "Bearer " + process.env.ORYKSA_API_KEY },
});

requests.get("https://api.oryksa.com/v1/account",
             headers={"Authorization": f"Bearer {os.environ['ORYKSA_API_KEY']}"})

Gestionar claves

Crea y revoca claves en la página Claves de API. Hasta 10 claves activas por cuenta; una por app o entorno es buena práctica.
La clave completa se muestra una sola vez. ORYKSA solo guarda un hash SHA-256, así que una clave perdida no se recupera: revócala y crea otra.
Una clave revocada deja de funcionar al instante.

Guarda las claves en el servidor. Una clave de API da acceso al agente de IA, al conocimiento y a las conversaciones de la cuenta. Nunca la pongas en un sitio web, en el paquete de una app móvil ni en un repositorio público. Para sitios web usa el widget de chat, cuyo token es público a propósito.

URL base y versiones

Todos los endpoints están en https://api.oryksa.com/v1 y devuelven siempre JSON. Las respuestas de error llevan la cabecera ORYKSA-Version. Los cambios incompatibles solo saldrán en una versión nueva (/v2).