GET v1​/ shops

Endpoint to get all the Shops (paged and aka Users) present in Blomming.

Instant gratification

Do it yourself from console!

Assuming that you have a valid token previously exported into BEARER env variable

Discover our Shops
curl -i -H "Authorization: Bearer $BEARER" \
https://api.blomming.com/v1/shops

Request

Example Request

{
  "page": 2,
  "locale": "es"
}

Request Parameters

  • page

    The N page of the results.

    • Required: no
    • Type: integer
    • Example: 2
  • locale

    The locale used in the results.

    • Required: no
    • Type: string
    • Example: "es"

Response

Example Response

[
  {
    "id": "lozoodisimona",
    "url": "http://example.org/shops/lozoodisimona",
    "items_url": "http://example.org/shops/lozoodisimona/items",
    "name": "LOZOODISIMONA®/IDEE DIPINTE_PAINTED IDEAS",
    "image": {
    }
  }
]

Response Parameters

  • Type: array
  • Items

    The list of all the Shops.

    • Required: yes
    • id

      The shop_id (aka username in Blomming web site) of the Shop.

      • Required: yes
      • Type: string
      • Example: "lozoodisimona"
    • url

      The visualized JSON.

      • Required: yes
      • Type: string
      • Format: uri
      • Example: "http://example.org/shops/lozoodisimona"
    • items_url

      The URL of the Items sold by this Shop.

      • Required: yes
      • Type: string
      • Format: uri
      • Example: "http://example.org/shops/lozoodisimona/items"
    • name

      The extended name of the Shop.

      • Required: yes
      • Type: string
      • Example: "LOZOODISIMONA┬«/IDEE DIPINTE_PAINTED IDEAS"
    • image

      The logo of the Shop.

      • Required: yes
      • Type: uri
      • Format: uri
      • Example: "http://yourdomain.com/path/to/a/photo"

Response Codes

Successful Response Codes