Categories

Create Supplier Category

curl -i -X POST "https://example.ziik.io/api/suppliers/categories"
  -H "Authorization: Bearer aaaaaaaaa.bbbbbbbbb.cccccccccc"
  -d "{ [...] }"

The above command returns 201 Created with a location header for where to find the newly created category

HTTP/1.0 201 Created
Location: https://example.ziik.io/api/suppliers/categories/1234
{
  "data": {
    "id": 1,
    "name": "repellendus",
    "url": "api/suppliers/categories/1"
  }
}

This endpoint creates a new supplier category.

HTTP Request

POST https://example.ziik.io/api/suppliers/categories

Request Parameters

Parameter	Type	Required	Description
name	String	Yes	Category name

Permissions Required

• User is administrator

Get Supplier Categories

curl "https://example.ziik.io/api/suppliers/categories"
  -H "Authorization: Bearer aaaaaaaaa.bbbbbbbbb.cccccccccc"

{
  "data": [
    {
      "id": 9,
      "name": "delectus",
      "url": "api/suppliers/categories/9"
    },
    {
      "id": 8,
      "name": "eius",
      "url": "api/suppliers/categories/8"
    },
    {
      "id": 10,
      "name": "et",
      "url": "api/suppliers/categories/10"
    }
  ]
}

This endpoint retrieves a list of Supplier categories.

HTTP Request

GET https://example.ziik.io/api/suppliers/categories

Query Parameters

None

Get Single Supplier Category

curl "https://example.ziik.io/api/suppliers/categories/1"
  -H "Authorization: Bearer aaaaaaaaa.bbbbbbbbb.cccccccccc"

The above command returns JSON structured like this:

{
  "data": {
    "id": 1,
    "name": "repellendus",
    "url": "api/suppliers/categories/1"
  }
}

HTTP Request

GET https://example.ziik.io/api/suppliers/categories/ID

URL Parameters

Parameter	Type	Description
ID	Integer	The ID of the category

Permissions Required

• Authenticated user

Edit Supplier Category

curl -i -X PATCH "https://example.ziik.io/api/suppliers/categories/123"
  -H "Authorization: Bearer aaaaaaaaa.bbbbbbbbb.cccccccccc"
  -d "{ [...] }"

The above command returns 204 No Content on successful update.

HTTP/1.0 204 No Content

This endpoint updates an existing supplier category.

HTTP Request

PATCH https://example.ziik.io/api/suppliers/categories/ID

Request Parameters

Parameter	Type	Required	Description
name	String	No	New category name

Permissions Required

• User is administrator

Delete Supplier Category

curl -i -X DELETE "https://example.ziik.io/api/suppliers/categories/123"
  -H "Authorization: Bearer aaaaaa.bbbbbbb.ccccccc"

The above command returns a 204 No Content header on success:

HTTP/1.0 204 No Content

This endpoint deletes a Supplier category.

HTTP Request

DELETE https://example.ziik.io/api/suppliers/categories/ID

URL Parameters

Parameter	Type	Description
ID	Integer	The ID of the category to delete

Permissions Required

• User is administrator