GET v1​/ categories

Dictionary endpoint to fetch all the Categories present in Blomming catalog.

Instant gratification

Do it yourself from console!

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

Try to get the Categories
curl -i -H "Authorization: Bearer $BEARER" \
https://api.blomming.com/v1/categories

Request

Example Request

{
  "locale": "es"
}

Request Parameters

  • locale

    The locale used in the results

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

Response

Example Response

[
  {
    "id": {
    },
    "name": "Antiques",
    "items_url": "http://example.org/categories/1/items"
  }
]

Response Parameters

  • Type: array
  • Items

    A list of Categories.

    • Required: yes
    • id

      id of the category

      • Required: yes
      • Type: fixnum
      • Example: 123
    • name

      The name of the category

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

      The URL of the items in this category

      • Required: yes
      • Type: string
      • Format: uri
      • Example: "http://example.org/categories/1/items"

Response Codes

Successful Response Codes