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) |
Parámetros
Sección titulada «Parámetros»| 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. |
Ejemplo
Sección titulada «Ejemplo»Contra el sandbox, con una clave onx_test_…:
curl "https://api-sandbox.opennexum.com/v1/claves" \ -H "Authorization: Bearer onx_test_…"Respuestas
Sección titulada «Respuestas»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. |
Errores
Sección titulada «Errores»Cada código tiene su explicación en Errores.
- 400
validacion - 401
clave_invalida - 403
permiso_faltante - 429
limite_uso - 500
error_interno - 501
operacion_no_disponible - 503
no_disponible