Referencia
Errores
Todos los errores siguen RFC 7807 Problem Details. El campo code es machine-readable — los clientes deberían hacer switch sobre eso, no sobre el title. En v2, los errores de validación responden 422.
Revise la API Key
401 · 403
Falta, está mal, se revocó o no tiene el permiso. Reintentar igual no sirve.
Corrija la petición
400 · 404 · 409 · 413 · 415 · 422
El body, un parámetro o el recurso no son válidos. Lea detail, corrija y vuelva a enviar.
Espere y reintente
429
Si superó el tope por minuto, espere lo que diga Retry-After. Si tiene demasiados jobs activos, espere a que termine alguno.
Reintente con backoff
5xx
Falla de nuestro lado. Reintente esperando 1, 2, 4 y 8 segundos; si sigue, escríbanos con el X-Request-Id.
HTTP/1.1 422 Unprocessable Entity
Content-Type: application/problem+json
{
"type": "https://api.automeli.com/errors/E_PRODUCT_INVALID_SKU",
"title": "SKU inválido",
"status": 422,
"code": "E_PRODUCT_INVALID_SKU",
"instance": "/api/v2/products",
"detail": "items[3].sku no cumple el formato (10 chars alfanum)."
}code en su cliente. El title es human-readable y puede cambiar; el code es contrato público y estable. El catálogo es compartido entre v1 y v2 (mismo backend).Catálogo completo (33)
Parámetro de query o path inválido (fecha, UUID, estado fuera de rango). Sólo v2; en v1 estos casos devuelven E_PRODUCT_INVALID_BODY
Sólo v2 (GET /products): la consulta superó su tope de tiempo. Trae Retry-After: 30; reintente una sola vez y, si se repite, quite sort_by, use un término más general o busque por sku o listing_id exactos
Sólo v2 (GET /bestsellers): la lista se recalculó desde que empezó a paginar. Pida de nuevo la primera página, sin cursor
Acción real sobre Mercado Libre con key test (con test solo se permite dry_run)
Acción real con expected_count (obligatorio en close/republish por filtros): el conteo real supera expected_count más la tolerancia
El servicio de acciones rechazó la solicitud (p. ej. supera el máximo de publicaciones a cerrar); el detalle trae el motivo