Autenticación

Autenticación

rCAPI soporta dos métodos de autenticación:

1. API Keys (Recomendado para integraciones)

Las API Keys son el método recomendado para integrar rCAPI en tu aplicación.

Obtener una API Key

1. Accede al panel de administración de tu tenant
2. Ve a Configuración > API Keys
3. Crea una nueva API Key con los permisos necesarios

Usar la API Key

Incluye el header X-API-Key en todas tus peticiones:

curl -X GET "https://api.redcumbre.cl/tu-tenant/bhe" \
  -H "X-API-Key: tu-api-key-aqui"

Modo Sandbox

Para pruebas, puedes crear API Keys en modo sandbox:

• No se emiten documentos reales al SII
• No se genera billing
• RUTs de prueba disponibles:

RUT	Comportamiento
78012039-8	Respuesta exitosa
77425402-1	Múltiples resultados
99999999-9	Error simulado

---

2. OAuth2 (Para aplicaciones web)

Si estás construyendo una aplicación web que actúa en nombre de usuarios, usa OAuth2.

Flujo de Autenticación

1. Redirige al usuario a la página de login de Zitadel
2. El usuario autoriza tu aplicación
3. Recibes un access token
4. Usa el token en el header Authorization: Bearer {token}

curl -X GET "https://api.redcumbre.cl/tu-tenant/bhe" \
  -H "Authorization: Bearer eyJhbGciOiJSUzI1NiIs..."

---

Referencia de Endpoints

👉 Ver endpoints de autenticación en Swagger