Listar tiendas - Fire spark

{
  "data": [
    {
      "id": "downtown-kitchen",
      "uid": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
      "merchant_id": "22222222-2222-2222-2222-222222222222",
      "brand_id": "0001",
      "name": "Downtown Kitchen",
      "status": "ACTIVE",
      "timezone": "America/Guayaquil",
      "contact": {
        "email": "downtown@merchant.com",
        "phone": "+593991234567",
        "name": "Downtown Kitchen"
      },
      "location": {
        "latitude": -2.1894,
        "longitude": -79.8891,
        "address_line_1": "Av. 9 de Octubre 123",
        "city": "Guayaquil",
        "country": "Ecuador",
        "postal_code": "090101",
        "business_name": "Downtown Kitchen S.A."
      },
      "instructions": null,
      "coverage_zones": [],
      "availability": {
        "schedules": null,
        "temporary_closed_reason": null,
        "temporary_closed_until": null,
        "status": "OPEN"
      },
      "channel_ids": ["web", "app"],
      "fulfillment_ids": ["delivery", "pickup"],
      "labels": [],
      "tags": {},
      "cms_template_id": null,
      "cms": null
    }
  ],
  "pagination": {
    "next_cursor": null,
    "prev_cursor": null
  }
}

Devuelve una lista paginada de tiendas desde las que un cliente puede pedir. Para buscar por coordenadas, usa listar tiendas cercanas.

Requiere un access token de Fire spark obtenido con intercambio de token.

Parámetros de query

Parámetro	Tipo	Default	Descripción
`brand_id`	string	—	Filtra por marca. Identificador externo — alfanumérico, `_` y `-`. 1–64 caracteres.
`channel_id`	string	—	Solo devuelve tiendas que tengan este canal activo en `channel_ids`.
`fulfillment_id`	string	—	Solo devuelve tiendas que tengan este fulfillment activo en `fulfillment_ids`.
`limit`	integer	`20`	Máximo de tiendas por página. Mínimo `1`, máximo `100`.
`cursor`	string	—	Cursor de `pagination.next_cursor`. Omítelo en la primera página.

Pide la primera página con limit=20. Pasa pagination.next_cursor como cursor hasta que next_cursor sea null.

Solicitud

curl "https://firespark.cloud/api/storefront/v1/stores?brand_id=0001&limit=20" \
  -H "Authorization: Bearer ACCESS_TOKEN"

Respuesta

La respuesta envuelve una página de tiendas en data y paginación en pagination. Cada tienda incluye contacto, ubicación, disponibilidad, canales y fulfillments activos, zonas de cobertura y metadatos de plantilla CMS. Un channel_ids o fulfillment_ids vacío significa que la tienda no ofrece ninguno.

{
  "data": [
    {
      "id": "downtown-kitchen",
      "uid": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
      "merchant_id": "22222222-2222-2222-2222-222222222222",
      "brand_id": "0001",
      "name": "Downtown Kitchen",
      "status": "ACTIVE",
      "timezone": "America/Guayaquil",
      "contact": {
        "email": "downtown@merchant.com",
        "phone": "+593991234567",
        "name": "Downtown Kitchen"
      },
      "location": {
        "latitude": -2.1894,
        "longitude": -79.8891,
        "address_line_1": "Av. 9 de Octubre 123",
        "city": "Guayaquil",
        "country": "Ecuador",
        "postal_code": "090101",
        "business_name": "Downtown Kitchen S.A."
      },
      "instructions": null,
      "coverage_zones": [],
      "availability": {
        "schedules": null,
        "temporary_closed_reason": null,
        "temporary_closed_until": null,
        "status": "OPEN"
      },
      "channel_ids": ["web", "app"],
      "fulfillment_ids": ["delivery", "pickup"],
      "labels": [],
      "tags": {},
      "cms_template_id": null,
      "cms": null
    }
  ],
  "pagination": {
    "next_cursor": null,
    "prev_cursor": null
  }
}