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.

json

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/v1/products",
  "detail": "items[3].sku no cumple el formato (10 chars alfanum)."
}

Hacé switch sobre code en tu cliente. El title es human-readable y puede cambiar; el code es contrato público y estable.

Catálogo completo (20)

Código y descripciónStatus

E_AUTH_MISSING_KEY

Falta el header X-API-Key

401

E_AUTH_INVALID_KEY

Key con formato inválido o no reconocida

401

E_AUTH_KEY_REVOKED

Key revocada por el dueño

401

E_AUTH_KEY_EXPIRED

Key con expires_at vencido

401

E_AUTH_FORBIDDEN_SCOPE

Tu key no tiene el permiso requerido (ver scopes)

403

E_RATE_LIMITED

Excediste el rate limit. Ver Retry-After

429

E_IDEMPOTENCY_CONFLICT

Misma Idempotency-Key con body distinto

409

E_PRODUCT_INVALID_BODY

Body malformado o campos faltantes

422

E_PRODUCT_INVALID_SKU

SKU no cumple regex (10 alfanum)

422

E_PRODUCT_CREDIT_EXHAUSTED

Sin créditos disponibles

400

E_PRODUCT_MAX_CONCURRENT_JOBS

Ya tenés 6 jobs activos

429

E_PROMOTE_NO_CANDIDATES

No hay SKUs en test pendientes que matcheen el filtro

400

E_PROMOTE_REQUIRES_LIVE_KEY

Endpoint /products/test/promote sólo acepta key live

403

E_CATEGORY_INVALID

category_id no cumple formato Meli

422

E_CATEGORY_AND_AUTO_CONFLICT

category_id y auto_categorize juntos

422

E_JOB_NOT_FOUND

jobId no existe o no es de tu seller

404

E_JOB_NOT_RETRYABLE

Job no terminal o sin items retryables

400

E_JOB_ALREADY_TERMINAL

Cancel sobre job ya cerrado

400

E_ACCOUNT_NOT_FOUND

Cuenta Meli no encontrada

404

E_INTERNAL

Error inesperado. Reintentá con backoff

503