Empezar
Errores
Forma de los errores de la API y códigos que vas a ver.
Los endpoints REST devuelven un JSON con la clave error y el código de estado HTTP
correspondiente. Las colecciones exitosas devuelven { "data": [...] }.
{ "error": "unauthorized" }Códigos de estado
| HTTP | error típico | Cuándo |
|---|---|---|
401 | unauthorized | Falta sesión o la credencial no es válida |
403 | forbidden_for_agent_key | Una agent key intentó una tool prohibida (crear agente, allocate) |
404 | not_found | El recurso no existe o no pertenece al usuario |
409 | agent_mismatch | La credencial no corresponde al agente indicado |
201 | — | Recurso creado (ej. una agent key nueva) |
Por seguridad, ownership y existencia colapsan en 404: si un recurso no es tuyo, la
API responde not_found, no forbidden, para no filtrar qué existe.
Límite superado (no es un error)
Cuando un pago supera un cap del agente no recibís un error: la respuesta es exitosa, la plata no se mueve, y se crea un approval pendiente. El detalle del breach viaja en la respuesta:
{
"type": "limitExceeded",
"limitType": "dailyAmount",
"limitAmount": 20000000,
"actualAmount": 23500000,
"currency": "ARS"
}limitType es uno de perTransactionAmount, dailyAmount o monthlyAmount. Ver
Approvals y Límites.