GET v1​/ sell​/shop​/sections​/:section_id​/items

Endpoint to get an ordered, paginated list of all the Items (pubished or not) present on a given Shop Section (section_id param).

Instant gratification

Do it yourself from console!

Assuming that you have a valid token previously exported into BEARER env variable and that the current Shop has a Section of ID 123

Try to get all the Item in a given Section
curl -i -H "Authorization: Bearer $BEARER" \
https://api.blomming.com/v1/sell/shop/sections/123/items

Request

Example Request

{
  "locale": "es",
  "order": "title",
  "page": 2,
  "per_page": 5
}

Request Parameters

  • locale

    The locale used in the results.

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

    The sorting used in the result set.

    • Required: no
    • Type: string
    • Example: "title"
  • page

    The paginated results.

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

    The number of results per page.

    • Required: no
    • Type: integer
    • Example: 5

Response

Example Response

[
  {
    "id": "64408",
    "title": "SPILLA CON FRASE (anche con frasi su richiesta)",
    "currency": "EUR",
    "description": "foo",
    "raw_description": "foo",
    "published": true,
    "url": "https://api.blomming.com/v1/shops/lozoodisimona/items/115538",
    "created_at": "2012-03-16T17:04:59Z",
    "price": 15.0,
    "original_price": 25.0,
    "photos_id": [
      101040
    ],
    "photos": [
      "https://s3.amazonaws.com/cdn.blomming.com/items/000/101/040/original/87c9a3bee9897765cc6bd1adf4716d5c.jpg"
    ],
    "fbcomments": "http://www.blomming.com/items/115538/fbcomments",
    "shop": {
      "id": "lozoodisimona",
      "url": "https://api.blomming.com/v1/shops/lozoodisimona",
      "name": "Lo Zoo di Simona",
      "image": {
      },
      "items_url": "http://example.org/shops/lozoodisimona/items"
    },
    "quantity": 100,
    "web_url": "http://blomming.com/mm/luciapw/items/orecchini-uncinetto-handmade--7"
  }
]

Response Parameters

  • Type: array
  • Items

    A list of published Items on shop_id’s Shop.

    • Required: yes
    • id

      The id of this Item

      • Required: yes
      • Type: string
      • Example: "64408"
    • title

      The title of the Item

      • Required: yes
      • Type: string
      • Example: "SPILLA CON FRASE (anche con frasi su richiesta)"
    • currency

      The currency in which the prices are exposed

      • Required: no
      • Type: string
      • Example: "EUR"
    • description

      The description of the item

      • Required: no
      • Type: string
      • Example: "foo"
    • raw_description

      The description of the item

      • Required: no
      • Type: string
      • Example: "foo"
    • published

      Present only if the item is hidden (that is, not pushished)

      • Required: no
      • Type: boolean
      • Example: true
    • url

      The URL to fetch the details of the Item

      • Required: yes
      • Type: string
      • Format: uri
      • Example: "https://api.blomming.com/v1/shops/lozoodisimona/items/115538"
    • created_at

      The date at which this Item has been created

      • Required: yes
      • Type: string
      • Format: date-time
      • Example: "2012-03-16T17:04:59Z"
    • price

      The price of this Item in the currency passed as parameter

      • Required: yes
      • Type: string
      • Example: 15.0
    • original_price

      The origin (non-discounted) price of this Item in the currency passed as parameter

      • Required: yes
      • Type:
        • string
        • null
      • Example: 25.0
    • photos_id

      ???

      • Required: no
      • Type: array
      • Items

        ???

        • Required: yes
        • Type: integer
        • Example: 101040
    • photos

      The photo of this Item with resolution XxY

      • Required: yes
      • Type: array
      • Items

        The URL of the photo

        • Required: yes
        • Type: string
        • Format: uri
        • Example: "https://s3.amazonaws.com/cdn.blomming.com/items/000/101/040/original/87c9a3bee9897765cc6bd1adf4716d5c.jpg"
    • fbcomments

      The URL to display the facebook comments

      • Required: yes
      • Type: string
      • Format: uri
      • Example: "http://www.blomming.com/items/115538/fbcomments"
    • shop

      The properties of the shop’s this Item belongs

      • Required: yes
      • id

        The id of the shop this Item belong

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

        The URL to fetch the details of the Shop to which this Item belong

        • Required: yes
        • Type: string
        • Format: uri
        • Example: "https://api.blomming.com/v1/shops/lozoodisimona"
      • name

        The name of the shop

        • Required: yes
        • Type: string
        • Example: "Lo Zoo di Simona"
      • image

        The logo of the shop

        • Required: yes
        • Type: uri
        • Format: uri
        • Example: "https://s3.amazonaws.com/cdn.blomming.com/users/000/000/038/original/Schermata_2010-11-12_a_20.31.27.png"
      • items_url

        the url of the items sold by this shop

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

      The number of items present in the store

      • Required: yes
      • Type: integer
      • Example: 100
    • web_url

      The URL on the web of this resource

      • Required: no
      • Type: string
      • Format: uri
      • Example: "http://blomming.com/mm/luciapw/items/orecchini-uncinetto-handmade--7"

Response Codes

Successful Response Codes

Failure Response Codes