Beta privada · apertura 23 de diciembre
Autenticación
Toda la API usa una clave de API en la cabecera Authorization:
Authorization: Bearer onx_live_…Producción y sandbox
Sección titulada «Producción y sandbox»| Clave | Entorno | Dirección |
|---|---|---|
onx_live_… |
Producción | https://api.opennexum.com |
onx_test_… |
Sandbox, con SUNAT beta | https://api-sandbox.opennexum.com |
Una clave solo funciona en su entorno. Empieza siempre por el sandbox.
Cómo es una clave
Sección titulada «Cómo es una clave»- Se crea en el panel y se muestra una sola vez. Después solo verás su inicio (por ejemplo
onx_live_a1b2) para reconocerla. - Si se pierde o se filtra, revócala en el panel y crea otra: cada clave se puede revocar sin afectar a las demás.
- Guárdala en una variable de entorno o en un gestor de secretos. Nunca en el código, en un repositorio ni en un chat.
- Una clave nunca ve datos de otra cuenta.
Lo que configura cada clave
Sección titulada «Lo que configura cada clave»Una persona de tu cuenta elige estos límites para cada clave, de modo que cada agente tenga la suya:
- Permisos: qué familias de rutas puede usar. Mira la lista en Permisos. Si falta uno, la API responde
permiso_faltante. - Tope de gasto: un máximo diario o mensual en soles. Al llegar a él, la API responde
tope_alcanzado(HTTP 402). Mira Saldo y error 402. - Alcance por RUC: a qué RUC emisores puede acceder; sin alcance, a todos los de tu cuenta.
- Aprobación humana: qué operaciones esperan el visto bueno de una persona (notas, bajas, mensajes o comprobantes desde cierto monto). Mira Para agentes de IA.
Si la clave falla
Sección titulada «Si la clave falla»- Sin clave, mal escrita, vencida o revocada:
clave_invalida(HTTP 401). - Clave válida sin el permiso de la ruta, o sin acceso a ese RUC:
permiso_faltante(HTTP 403).
Los datos de otra cuenta responden no_encontrado: no revelamos que existen.