Autenticación

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

• Enviar y Recibir Mensajes - Aprende a interactuar con la API
• Referencia HTTP - Consulta todos los códigos de estado