Ir al contenido

Beta privada · apertura 23 de diciembre

Consulta una aprobación pendiente

GET /v1/confirmaciones/{id}

Estado de una operación que respondió 202 requiere_confirmacion. Basta una clave válida, pero solo la ve la clave que la pidió, y consultarla no la cambia. Cuando está aprobada, repite la misma petición (misma Idempotency-Key y mismo cuerpo) antes de expira_en para hacerla; entonces queda usada.

Dato Valor
Permiso clave_valida
Cobro No cobra.
Idempotency-Key No aplica
Herramienta MCP confirmacion_ver (Próximamente)
Nombre En Requerido Tipo Descripción
id path Sí string Identificador que empieza con op_.
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/confirmaciones/op_8f2c1a7d9e" \
-H "Authorization: Bearer onx_test_…"

Estado de la aprobación.

Campo Tipo Requerido Descripción
id string Sí Identificador que empieza con op_.
estado “pendiente” | “aprobada” | “rechazada” | “vencida” | “usada” Sí aprobada: repite la misma petición (misma Idempotency-Key y mismo cuerpo) antes de expira_en. usada: ya corrió con esa aprobación. rechazada y vencida no se hacen.
operacion string Sí operationId de la ruta que pidió aprobación.
resumen string Sí Lo que se aprueba, en palabras para una persona.
motivo_rechazo string | null Sí Lo que escribió la persona al rechazarla, si escribió algo.
siguiente_paso string Sí Qué hacer ahora, en palabras para el agente.
confirmacion_url string (uri) Sí URL pública con https (sin IP literal, localhost, dominios internos ni usuario y clave).
creada_en string (date-time) Sí Fecha y hora ISO 8601 con la zona de Lima (-05:00).
expira_en string (date-time) Sí Fecha y hora ISO 8601 con la zona de Lima (-05:00).
decidida_en string (date-time) | null Sí
usada_en string (date-time) | null Sí

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