GET v1​/ sell​/shop​/items

Endpoint to retrieve items (published and unpublished) of the current shop

Instant gratification

Do it yourself from console!

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

retrieve shop items
curl -X GET -i -H "Authorization: Bearer $BEARER" \
https://api.blomming.com/v1/sell/shop/items \
-d "per_page=1" \
-d "page=1" \
-d "order=price_desc"

Request

Example Request

{
  "f": {
    "category_ids": {
    },
    "featured": true,
    "on_sale": true,
    "price": "0..99",
    "promotable": true,
    "shipping_to": "IT"
  },
  "locale": "es",
  "order": "title",
  "page": 2,
  "per_page": 5
}

Request Parameters

  • f

    Set of filters to be applied.

    • Required: no
    • category_ids

      Category ids

      • Required: no
      • Type: stirng
      • Example: 1
    • featured

      Filters only featured items

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

      Filters only discounted items

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

      Filters only items between a certain price range, referred to the currency parameter unit

      • Required: no
      • Type: string
      • Example: "0..99"
      • pattern: /\d+..\d+/
    • promotable

      Filters only promotable items

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

      Filters only items that can be shipped to the given country

      • Required: no
      • Type: string
      • Example: "IT"
      • pattern: [A-Z]{2}
  • 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