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