Volver a la documentación

Autenticación

Aprende cómo autenticarte con la API de Arkangel AI usando claves API

por Arkangel AI Team•1 min de lectura

La API de Arkangel AI utiliza claves API para autenticar las solicitudes. Puedes ver y gestionar tus claves API en el panel de tu cuenta.

Obtener tu Clave API

  1. Inicia sesión en tu cuenta de Arkangel AI
  2. Ve a Configuración > API
  3. Haz clic en Generar Nueva Clave API
  4. Copia y guarda tu clave de forma segura

Importante: Tu clave API es secreta. No la compartas ni la expongas en código del lado del cliente.

Usar tu Clave API

Incluye tu clave API en el encabezado Authorization de todas las solicitudes:

curl -X POST https://api.arkangelai.com/v1/chat \
  -H "Authorization: Bearer tu_clave_api" \
  -H "Content-Type: application/json" \
  -d '{"message": "Hola"}'

Ejemplo en JavaScript

const response = await fetch('https://api.arkangelai.com/v1/chat', {
  method: 'POST',
  headers: {
    'Authorization': 'Bearer tu_clave_api',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    message: 'Hola'
  })
});

Ejemplo en Python

import requests

headers = {
    'Authorization': 'Bearer tu_clave_api',
    'Content-Type': 'application/json'
}

response = requests.post(
    'https://api.arkangelai.com/v1/chat',
    headers=headers,
    json={'message': 'Hola'}
)

Seguridad de las Claves API

  • Nunca expongas tu clave API en código del lado del cliente
  • Usa variables de entorno para almacenar tus claves
  • Rota tus claves regularmente
  • Revoca inmediatamente cualquier clave comprometida

Variables de Entorno

# .env
ARKANGEL_API_KEY=tu_clave_api

// Usar la variable de entorno
const apiKey = process.env.ARKANGEL_API_KEY;

Errores de Autenticación

Código Mensaje Descripción
401 invalid_api_key La clave API proporcionada no es válida
401 missing_api_key No se proporcionó clave API
403 api_key_revoked La clave API ha sido revocada
429 rate_limit_exceeded Has excedido el límite de solicitudes

Próximos Pasos