Ir a la documentación
DocumentaciónPeticiones y errores

Peticiones y errores.

Formato

Usa GET para leer y POST con Content-Type: application/json para escribir. Los campos inesperados se rechazan. Las respuestas devuelven directamente objetos o listas.

Reintentos

Conserva requestKey y los parámetros al reintentar la misma operación. Un 202 o pending:true no indica finalización. Consulta taskKey, el pago o el pedido; no vuelvas a comprar por un resultado incierto.

Errores

Comprueba el estado HTTP y el resultado. Una capacidad no disponible puede devolver HTTP 200 con supported:false. El texto de error no es un código estable.

Ejemplo de petición
{ "error": "invalid request" }

Límites

HTTP y MCP tienen límites separados de 120 peticiones por minuto, IP y proceso. La autenticación de billetera por HTTP añade 10 por minuto. Un 429 incluye Retry-After: 60.

Paginación e importes

Historial: cursor opaco; mensajes: 8 por página; eventos: 10. Los saldos y cotizaciones USD usan cadenas de centavos enteros. El catálogo usa cadenas de dólares decimales.

Operaciones destructivas

Revisa los avisos de cada endpoint. La terminación y reinstalación por IA requieren consentimiento de billetera. La renovación no está integrada; guardar una preferencia no amplía el servicio.