Ir al contenido

Beta privada · apertura 23 de diciembre

Lista las claves de tu cuenta

GET /v1/claves

Claves activas y revocadas del entorno de tu clave (live o test), con sus permisos, alcance por RUC y tope. Nunca devuelve la clave completa. Los agentes conectados por OAuth no salen aquí: se ven y desconectan en el panel.

Dato Valor
Permiso claves:administrar
Cobro No cobra.
Idempotency-Key No aplica
Herramienta MCP clave_listar (Próximamente)
Nombre En Requerido Tipo Descripción
cursor query No string Cursor opaco que devolvió la página anterior en siguiente_cursor.
limite query No integer Cuántos elementos traer (1 a 100; por defecto 20).
X-Request-Id header No string Identificador de la petición. Va en cada respuesta; menciónalo al escribir a soporte.

Contra el sandbox, con una clave onx_test_…:

Ventana de terminal
curl "https://api-sandbox.opennexum.com/v1/claves" \
-H "Authorization: Bearer onx_test_…"

Página de claves.

Campo Tipo Requerido Descripción
elementos object[] Sí
elementos[].id string Sí Identificador que empieza con clv_.
elementos[].nombre string Sí
elementos[].prefijo string Sí Inicio visible de la clave, para reconocerla. La clave completa solo se muestra al crearla.
elementos[].entorno “live” | “test” Sí live en producción; test en sandbox (SUNAT beta).
elementos[].permisos “datos:leer” | “emisores:administrar” | “comprobantes:emitir” | “comprobantes:leer” | “comprobantes:anular” | “guias:emitir” | “sire:leer” | “conecta:leer” | “conecta:enviar” | “conecta:administrar” | “webhooks:administrar” | “cuenta:leer” | “cuenta:recargar” | “claves:administrar” | “credenciales:por_llamada”[] Sí Puede estar vacía (una clave sin permisos solo autentica).
elementos[].emisores string[] | null Sí RUC a los que puede acceder; null = todos los de tu cuenta.
elementos[].tope object | null Sí
elementos[].tope.periodo “diario” | “semanal” | “mensual” | “total” Sí
elementos[].tope.limite string Sí Monto como texto con dos decimales y punto decimal, sin separador de miles. “1250.50” es S/ 1,250.50.
elementos[].confirmacion object Sí Qué operaciones de esta clave esperan la aprobación de una persona en el panel. Por omisión: notas de crédito, bajas, montos mayores a S/ 5,000.00 y todo lo que pida un agente (token OAuth o MCP).
elementos[].confirmacion.notas boolean Sí Notas de crédito (07).
elementos[].confirmacion.bajas boolean Sí Bajas: comunicación de baja (RA) y resumen diario de anulación (RC).
elementos[].confirmacion.mensajes boolean Sí Envío de mensajes y comprobantes por Conecta.
elementos[].confirmacion.agentes boolean Sí Toda emisión o baja que pida un agente con un token OAuth o por MCP, sea cual sea su tipo o monto.
elementos[].confirmacion.monto_mayor_a string | null Sí Comprobantes cuyo total pasa de este monto (por omisión, “5000.00”); null para no pedirla por monto.
elementos[].vence_el string (date) | null Sí
elementos[].ultimo_uso_en string (date-time) | null Sí
elementos[].creada_en string (date-time) Sí Fecha y hora ISO 8601 con la zona de Lima (-05:00).
elementos[].revocada_en string (date-time) | null Sí
siguiente_cursor string | null Sí Pásalo como cursor para la página siguiente; null si ya no hay más.

Cada código tiene su explicación en Errores.