POST v1​/ sell​/shop​/items

Endpoint to create a new Item in the current Shop.

Instant gratification

Do it yourself from console!

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

Try to create a new Item
curl -X POST -i -H "Authorization: Bearer $BEARER" \
https://api.blomming.com/v1/sell/shop/items/new \
-d '{ "category_ids":[101], "source_shipping_profile_id":"", "price":18, "title":"An Item", "quantity":99, "description":"New description", "published":"true", "original_price":20 }'

Request

Example Request

{
  "category_ids": [
    100
  ],
  "user_id": "12345",
  "source_shipping_profile_id": 2,
  "price": 25.0,
  "title": "Orecchini uncinetto handmade",
  "quantity": 10,
  "description": "A very very long description without HTML tags.",
  "published": true,
  "async_contents": [
    "https://foo.bar/baz.jpg"
  ],
  "original_price": 20.0,
  "currency": "EUR"
}

Request Parameters

  • category_ids

    List of Category IDs (at least 1, at most 3) the Item is associated to.

    • Required: yes
    • Type: array
    • Example:
      [
        100
      ]
    • Items

      The ID of a Category.

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

    The ID of the current user.

    • Required: yes
    • Type: string
    • Example: "12345"
  • source_shipping_profile_id

    The Shipping Profile to copy and link to the new Item.

    • Required: no
    • Type: string
    • Example: 2
  • price

    The price of this Item in the currency passed as parameter.

    • Required: no
    • Type: number
    • Example: 25.0
  • title

    The title of the Item.

    • Required: no
    • Type: string
    • Example: "Orecchini uncinetto handmade"
  • quantity

    The number of Items in stock for this SKU.

    • Required: no
    • Type: integer
    • Example: 10
  • description

    The description of the Item.

    • Required: no
    • Type: string
    • Example: "A very very long description without HTML tags."
  • published

    the Item’s public visibility.

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

    A list of media (images and/or videos) that represent the Item.

    • Required: no
    • Type: array
    • Example:
      [
        "https://foo.bar/baz.jpg"
      ]
    • Items

      A single image/video url source.

      • Required: yes
      • Type: string
      • Format: uri
      • Example: "https://foo.bar/baz.jpg"
  • original_price

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

    • Required: no
    • Type:
      • string
      • null
    • Example: 20.0
  • currency

    the currency to use when returning prices, the default is EUR.

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

Response

Example Response

{
  "id": "115538",
  "title": "Orecchini uncinetto handmade",
  "currency": "EUR",
  "description": "A very very long description without HTML tags.",
  "raw_description": "foo",
  "published": true,
  "url": "https://api.blomming.com/v1/shops/lozoodisimona/items/115538",
  "created_at": "2012-08-27T20:56:36Z",
  "price": 25.0,
  "original_price": 25.0,
  "photos_id": null,
  "photos": null,
  "fbcomments": "http://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",
    "payment_types": [
      {
        "code": "PCHECK",
        "description": "Personal Check"
      }
    ]
  },
  "quantity": 42,
  "prop_types": [
    {
      "name": "taglia",
      "id": 1,
      "values": [
        "32"
      ]
    }
  ],
  "skus": [
    {
      "id": 64314,
      "barcode": "c4bcfbf93bb8c42f01da3303d18836ad",
      "user_barcode": "spilla-1",
      "quantity": 42,
      "props": [
        {
          "value": "taglia",
          "type": {
            "name": "taglia",
            "id": 1
          }
        }
      ]
    }
  ],
  "shipping": {
    "origin_country": {
      "code": "IT",
      "name": "Italy"
    },
    "destinations": [
      {
        "code": "AT",
        "name": "Italy",
        "cost": {
          "single": 18,
          "shared": 0
        }
      }
    ],
    "everywhere_else_cost": null,
    "profile_id": "1234",
    "profile_name": "Default"
  },
  "formatted_price_with_currency": "€25.00",
  "formatted_original_price_with_currency": "€25.00",
  "tags": [
    {
      "name": "pins",
      "items_url": "http://example.org/tags/pins/items"
    }
  ],
  "web_url": "http://blomming.com/mm/luciapw/items/orecchini-uncinetto-handmade--7",
  "categories": [
    {
      "id": 100,
      "name": "Clothing"
    }
  ],
  "sections": [
    ""
  ]
}

Response Parameters

  • id

    The id of this Item

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

    The title of the Item

    • Required: yes
    • Type: string
    • Example: "Orecchini uncinetto handmade"
  • currency

    The currency in which the prices are exposed

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

    The description of the item

    • Required: yes
    • Type: string
    • Example: "A very very long description without HTML tags."
  • raw_description

    The description of the item

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

    the Item’s public visibility

    • Required: yes
    • 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-08-27T20:56:36Z"
  • price

    The price of this Item in the currency passed as parameter

    • Required: yes
    • Type: string
    • Example: 25.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
      • null
    • Items
      • Required: no
  • photos

    The photo of this Item with resolution XxY

    • Required: no
    • Type:
      • array
      • null
    • Items

      The URL of the photo

      • Required: yes
      • Type: string
      • Format: uri
      • Example: "https://s3.amazonaws.com/cdn.blomming.com/items/000/179/591/large/f569f44564d8b35283783430638d03c2.jpg?1346100986"
  • fbcomments

    The URL to display the facebook comments

    • Required: yes
    • Type: string
    • Format: uri
    • Example: "http://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: "http://yourdomain.com/path/to/a/photo"
    • items_url

      the url of the items sold by this shop

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

      The payment types accepted by this shop

      • Required: yes
      • Type: array
      • Items

        A single payment type

        • Required: yes
        • code

          The code of this payment type

          • Required: yes
          • Type: string
          • Example: "PCHECK"
        • description

          A long description of the payment type

          • Required: yes
          • Type: string
          • Example: "Personal Check"
  • quantity

    The number of items present in the store

    • Required: yes
    • Type: integer
    • Example: 42
  • prop_types

    The definition of the properties of this Item

    • Required: yes
    • Type: array
    • Items

      the properties

      • Required: no
      • name

        The name of the property type

        • Required: yes
        • Type: string
        • Example: "taglia"
      • id

        The id of the property type

        • Required: yes
        • Type: integer
        • Example: 1
      • values

        the possible values of this property

        • Required: yes
        • Type: array
        • Items

          ???

          • Required: yes
          • Type: string
          • Example: "32"
  • skus

    An array containing all the SKU of a product.

    • Required: yes
    • Type: array
    • Items

      A single SKU

      • Required: yes
      • id

        The ID of the SKU, to be used to add item to the Cart

        • Required: yes
        • Type: integer
        • Example: 64314
      • barcode

        the barcode of this SKU

        • Required: yes
        • Type: string
        • Example: "c4bcfbf93bb8c42f01da3303d18836ad"
      • user_barcode

        the shop defined barcode of this SKU

        • Required: no
        • Type: string
        • Example: "spilla-1"
      • quantity

        The number of Items in stock for this SKU

        • Required: yes
        • Type: integer
        • Example: 42
      • props

        The definition of the properties of this SKU

        • Required: yes
        • Type: array
        • Items

          The properties

          • Required: yes
          • value

            The value of the property

            • Required: yes
            • Type: string
            • Example: "taglia"
          • type

            The type of this property

            • Required: yes
            • name

              The name of the property type

              • Required: yes
              • Type: string
              • Example: "taglia"
            • id

              The id of the property type

              • Required: yes
              • Type: integer
              • Example: 1
  • shipping

    The description of the shipping profile

    • Required: yes
    • origin_country

      ???

      • Required: yes
      • code

        The country code from which this object is sent.

        • Required: yes
        • Type: string
        • Example: "IT"
      • name

        The name of the country from which this object is sent.

        • Required: yes
        • Type: string
        • Example: "Italy"
    • destinations

      The destiation countries

      • Required: yes
      • Type: array
      • Items

        The country

        • Required: yes
        • code

          The country code

          • Required: yes
          • Type: string
          • Example: "AT"
        • name

          The country name

          • Required: yes
          • Type: string
          • Example: "Italy"
        • cost

          The cost of shipping to this country

          • Required: yes
          • single

            The cost of shipping a single items

            • Required: yes
            • Type: number
            • Example: 18
          • shared

            The cost of shipping multiple items

            • Required: yes
            • Type: number
            • Example: 0
    • everywhere_else_cost

      The cost of shipping in a location not defined in the destinations array

      • Required: yes
      • Type:
        • object
        • null
      • single

        The cost of shipping a single items

        • Required: yes
        • Type: number
        • Example: 25
      • shared

        The cost of shipping multiple items

        • Required: yes
        • Type: number
        • Example: 25
    • profile_id

      ???

      • Required: yes
      • Type: string
      • Example: "1234"
    • profile_name

      ???

      • Required: yes
      • Type: string
      • Example: "Default"
  • formatted_price_with_currency

    The price with the currency of this Item

    • Required: yes
    • Type: string
    • Example: "€25.00"
  • formatted_original_price_with_currency

    The original (non-discounted) price with the currency of this Item

    • Required: yes
    • Type:
      • string
      • null
    • Example: "€25.00"
  • tags

    The tags of this Item

    • Required: yes
    • Type: array
    • Items

      ???

      • Required: yes
      • name

        The name of the tag

        • Required: yes
        • Type: string
        • Example: "pins"
      • items_url

        The url of the items with this tag

        • Required: yes
        • Type: string
        • Format: uri
        • Example: "http://example.org/tags/pins/items"
  • web_url

    The URL on the web of this resource

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

    A list of Categories the Item belongs to.

    • Required: yes
    • Type: array
    • Items

      A Category the Item belongs to.

      • Required: yes
      • id

        The ID of the Category.

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

        The name of the Category.

        • Required: yes
        • Type: string
        • Example: "Clothing"
  • sections

    An array containing all the Sections bound to this Item.

    • Required: yes
    • Type: array
    • Items

      A single Section associated to the Item.

      • Required: no
      • Type: string

Response Codes

Successful Response Codes

Failure Response Codes