Beta privada · apertura 23 de diciembre
Dice quién eres
GET /v1/yo
Devuelve la cuenta (id público y nombre), el entorno, el tipo de credencial (clave o token OAuth), sus permisos, los RUC a los que llega y su tope. Basta una credencial válida y no cobra. Nunca devuelve la clave ni el token.
| Dato | Valor |
|---|---|
| Permiso | clave_valida |
| Cobro | No cobra. |
Idempotency-Key |
No aplica |
| Herramienta MCP | yo_ver (Próximamente) |
Parámetros
Sección titulada «Parámetros»| Nombre | En | Requerido | Tipo | Descripción |
|---|---|---|---|---|
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/yo" \ -H "Authorization: Bearer onx_test_…"Respuestas
Sección titulada «Respuestas»La cuenta y lo que puede hacer tu credencial.
| Campo | Tipo | Requerido | Descripción |
|---|---|---|---|
cuenta |
object | Sí | La cuenta a la que pertenece la credencial. |
cuenta.id |
string | Sí | Identificador público de tu cuenta. |
cuenta.nombre |
string | Sí | Nombre de la cuenta. |
entorno |
“live” | “test” | Sí | live en producción; test en sandbox (SUNAT beta). |
credencial |
“clave” | “oauth” | Sí | Con qué preguntas: una clave onx_live_/onx_test_ o el token OAuth de un agente conectado. |
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í | Lo que puede hacer esta credencial. |
emisores |
string[] | null | Sí | RUC a los que llega: null = todos los de tu cuenta; una lista vacía = ninguno. |
tope |
object | null | Sí | Tope de gasto de la credencial; null si no tiene. Lo consumido está en GET /v1/cuenta/saldo. |
tope.periodo |
“diario” | “semanal” | “mensual” | “total” | Sí | |
tope.limite |
string | Sí | Monto como texto con dos decimales y punto decimal, sin separador de miles. “1250.50” es S/ 1,250.50. |
Errores
Sección titulada «Errores»Cada código tiene su explicación en Errores.
- 401
clave_invalida - 403
permiso_faltante - 429
limite_uso - 500
error_interno - 501
operacion_no_disponible - 503
no_disponible