Referencia · Catálogo

Detalle de un producto por su slug

GET/products/by-slug/{slug}

Responde lo mismo que GET /products/{id}. La coincidencia es exacta y no admite un id. Un slug mal formado, uno de otra tienda o uno que ya no existe responden el mismo 404 PRODUCT_NOT_FOUND.

Parámetros de ruta

slugtextorequerido

Patrón ^[a-z0-9-]{1,64}$.

Respuestas

EstadoCódigoQué significa
200—

Producto.

401
  • API_KEY_INVALID

Clave ausente, inválida o revocada: API_KEY_INVALID.

403
  • STOREFRONT_API_PLAN_REQUIRED
  • ORIGIN_NOT_ALLOWED
  • SECRET_KEY_IN_BROWSER
  • STORE_INACTIVE
  • ALTCHA_REQUIRED
  • ALTCHA_INVALID
  • ALTCHA_EXPIRED
  • ALTCHA_REPLAY

STOREFRONT_API_PLAN_REQUIRED (la tienda no está en el plan PRO; no aplica a GET /orders/{token} ni a GET /orders/by-payment-hash/{hash}), ORIGIN_NOT_ALLOWED, SECRET_KEY_IN_BROWSER, STORE_INACTIVE (tienda pausada o archivada; solo catálogo, cotización y checkout), o en el checkout ALTCHA_REQUIRED, ALTCHA_INVALID, ALTCHA_EXPIRED, ALTCHA_REPLAY.

404
  • ORDER_NOT_FOUND
  • PRODUCT_NOT_FOUND
  • ALTCHA_NOT_CONFIGURED

No existe o es de otra tienda: la respuesta es la misma en ambos casos. Códigos: ORDER_NOT_FOUND, PRODUCT_NOT_FOUND, ALTCHA_NOT_CONFIGURED.

429
  • RATE_LIMITED

RATE_LIMITED. Respetar Retry-After. Sin datos para servir, también en una lectura de catálogo degradada.

500—

Error del servidor. En el checkout se puede reintentar con la misma Idempotency-Key.

503
  • SERVICE_UNAVAILABLE

SERVICE_UNAVAILABLE: no se pudo verificar la clave o el plan de la tienda, o Stripe no respondió al iniciar un pago. No dice nada de la clave ni del plan: reintentar después de Retry-After.