Errores

Problem details (RFC 9457) con un code estable y el campo exacto a corregir.

Los errores siguen RFC 9457 (application/problem+json), con un code estable para decidir qué hacer y, cuando aplica, el campo exacto a corregir en errors:

{
  "type": "/problems/validation-failed",
  "title": "Unprocessable Content",
  "status": 422,
  "code": "VALIDATION_FAILED",
  "detail": "The request does not match the API contract. See `errors` for each field.",
  "errors": [
    {
      "path": "currency",
      "message": "Set `currency` (USD or VES) to filter or sort by price; other currencies are converted at the official BCV rate."
    }
  ],
  "requestId": "821d2935-0359-4a69-945e-cfa0b69696f6"
}

Status	`code`	Qué pasó
401	`UNAUTHORIZED`	La key es desconocida o está revocada.
429	`RATE_LIMITED`	Se agotó la cuota; reintenta después de `Retry-After` segundos.
422	`VALIDATION_FAILED`	Algún parámetro no cumple el contrato; `errors` dice cuál y por qué.
422	`INVALID_CURSOR`	El cursor es de otra búsqueda; repítela sin él.
422	`INVALID_GTIN`	El código de barras no tiene un dígito verificador válido.
422	`NO_BARCODE`	El producto no tiene código de barras, así que no se puede comparar; búscalo por nombre.
404	`LISTING_NOT_FOUND`	No hay producto con ese id, o su tienda ya no está activa.
404	`NO_OFFER`, `NO_OFFER_IN_CITY`	El producto no tiene ofertas, o no en esa ciudad (el mensaje lista las que tiene).
404	`ROUTE_NOT_FOUND`	La ruta no existe.
400	`MALFORMED_BODY`	El cuerpo de la petición no se pudo leer.
500	`INTERNAL_ERROR`	Falla de Bazar.

Cada respuesta trae x-request-id; puedes enviar el tuyo en esa cabecera. Al reportar un problema, incluye ese id.