Ir al contenido

Beta privada · apertura 23 de diciembre

Autenticación

Toda la API usa una clave de API en la cabecera Authorization:

Authorization: Bearer onx_live_…
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.

  • 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.

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.
  • 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.