Cupones
Buscar Cupones
Aprenda a listar cupones de una tienda usando el endpoint GET /stores//coupons.
GET
List coupons
📌 Endpoint
GET /stores/{storeId}/coupons
Lista los cupones de la tienda (no expirados).
Los cupones se devuelven en el orden de position (ascendente).
🔐 Autenticación
- Ruta privada.
- Requiere header
Authorizationcon su API key y plan activo.
🧾 Parámetros de ruta
✅ Ejemplo de solicitud
🔎 Parámetros de consulta
🔄 Paginación por cursor
Para listas grandes (más de ~100 elementos), prefiera la paginación por cursor en lugar depage:
- Realice la primera llamada sin
cursor. - Si
hasMoreestrue, la respuesta incluye el camponextCursor. - Envíe ese
nextCursoren el parámetrocursorde la siguiente solicitud para obtener la página siguiente.
nextCursor, hasMore y limit:
cursorypageno pueden usarse juntos (400 INVALID_PAGINATION).nextCursor: nullconhasMore: falseindican el fin de la lista (solo en modo cursor la API responde200con array vacío[]; en modo offset conpage, cuando el total es0, la API devuelve404 COUPONS_NOT_FOUND).
Snippet estándar (cURL)
Use el ejemplo cURL de la sección Ejemplo de solicitud anterior como snippet oficial.📦 Respuesta exitosa (200)
La primera llamada (sincursor) ya devuelvenextCursoryhasMoreen la paginación, permitiendo iniciar la paginación por cursor sin llamadas adicionales.
⚠️ Posibles errores
400 INVALID_DATA→ parámetros inválidos400 INVALID_PAGINATION_LIMIT→limitfuera del rango permitido (1a100)400 INVALID_PAGINATION_PAGE→pageinválida400 INVALID_PAGINATION_CURSOR→cursorinválido o malformado400 INVALID_PAGINATION→pageycursorusados juntos401 API_KEY_NOT_PROVIDED→ headerAuthorizationno enviado401 INVALID_API_KEY→ API key inválida401 UNAUTHENTICATED→ usuario no autenticado403 USER_DISABLED→ usuario deshabilitado403 NO_ACTIVE_SUBSCRIPTION→ sin plan activo404 STORE_NOT_FOUND→ tienda no encontrada404 COUPONS_NOT_FOUND→ ningún cupón encontrado (devuelto en modo offset cuando el total es0; solo el modo cursor devuelve200con[])429 RATE_LIMIT_EXCEEDED→ límite de solicitudes por minuto excedido500 INTERNAL_SERVER_ERROR→ error interno503 SERVICE_UNAVAILABLE→ servicio no disponible