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.
{ "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.