Fallas predecibles y fáciles de rastrear.

Códigos HTTP convencionales, cuerpo uniforme e identificador único para cada solicitud.

Formato de error

403 application/json

{
  "error": {
    "code": "insufficient_scope",
    "message": "esta chave precisa do escopo commissions:read",
    "required_scope": "commissions:read"
  },
  "request_id": "req_01J..."
}

El request_id aparece en el encabezado y en el JSON. Envíe esta cantidad a soporte para localizar una llamada.

Códigos HTTP

200ÉxitoOperación completada.

201CreadoNueva oferta pendiente creada.

400Solicitud no válidaJSON, parámetro o URL no válidos.

401No autenticadoClave faltante, inválida, caducada o revocada.

402Plan requeridoRequiere Profesional o superior.

403Alcance insuficienteLa clave no tiene el alcance requerido.

404No encontradoPunto final o recurso inexistente.

413cuerpo muy grandeEl JSON superó los 128 KB.

429Límite excedidoLa clave ha excedido la ventana por minuto.

500error internoFracaso inesperado; utilice request_id.

Límites y encabezados

x-ratelimit-limitLímite total de ventana

x-ratelimit-remainingSolicitudes restantes

x-request-ididentificador de llamadas

cache-controlprivado, sin almacenamiento de datos autenticados

120 req/min

El límite es por clave. Para 429, espere la siguiente ventana y use el retroceso con fluctuación.

Lista de verificación de depuración

Confirme la base https://achadu.com/api/v1.

Valide la clave con GET /me.

Verifique el alcance_requerido en las respuestas 403.

Estado de registro, request_id y tiempo de llamada.

No repita automáticamente los errores 400, 401, 402 o 403.

Habla con soporte técnico →