Tiendas
Buscar Tiendas
Aprenda a listar todas las tiendas registradas en la Cabra API usando el endpoint GET /stores.
GET
List stores
🏬 Buscar Tiendas
Este endpoint permite listar todas las tiendas asociadas a su cuenta. Las tiendas se devuelven en el orden deposition (ascendente).
Es ideal para:
- Mostrar tiendas en paneles administrativos
- Integrar datos con otros sistemas
- Automatizar consultas de tiendas
🔐 Autenticación
Esta ruta exige autenticación vía API Key, enviada en el header de la petición:📋 Ejemplo de Petición
📊 Ejemplo de Respuesta (200)
La primera llamada (sincursor) ya devuelvenextCursoryhasMoreen la paginación, permitiendo iniciar la paginación por cursor sin llamadas adicionales.
📌 Parámetros
Parámetros de consulta
Caso no existan tiendas en la página consultada,
stores se devuelve como array vacío.
🔄 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 petición para obtener la página siguiente.
nextCursor, hasMore y limit:
cursorypageno pueden usarse juntos (400 INVALID_PAGINATION).nextCursor: nullconhasMore: falseindican el final de la lista (la API responde200con array vacío).
⚠️ Posibles errores
400 INVALID_PAGINATION_LIMIT→limitfuera del intervalo permitido (1a100)400 INVALID_PAGINATION_PAGE→pageinválida400 INVALID_PAGINATION_CURSOR→cursorinválido o malformado400 INVALID_PAGINATION→pageycursorutilizados juntos401 API_KEY_NOT_PROVIDED→ headerAuthorizationno enviado401 INVALID_API_KEY→ API Key inválida o no encontrada401 UNAUTHENTICATED→ sesión/usuario no autenticado403 USER_DISABLED→ cuenta de usuario desactivada o eliminada403 NO_ACTIVE_SUBSCRIPTION→ cuenta sin plan activo429 RATE_LIMIT_EXCEEDED→ límite de solicitudes por minuto del plan excedido500 INTERNAL_SERVER_ERROR→ error interno503 SERVICE_UNAVAILABLE→ servicio temporalmente no disponible