Получение списка услуг

Возвращает список услуг магазина с пагинацией.

Request

GET

https://api.kit.yandex.net/v1/addons

Query parameters

Name

Description

page

Type: integer

Номер страницы.

Default: 1

Min value: 1

per_page

Type: integer

Количество элементов на странице.

Default: 25

Min value: 1

Max value: 100

Responses

200 OK

Список услуг.

Body

application/json
{
  "addons": [
    {
      "id": "123e4567-e89b-12d3-a456-426614174000",
      "number": 12345,
      "title": "Доставка курьером",
      "price": "500.00",
      "final_price": "450.00",
      "is_price_enabled": false,
      "created_at": "2023-01-15T10:30:00Z"
    }
  ],
  "total_count": 42
}

Name

Description

addons

Type: AddonListItem[]

Список услуг.

Example
[
  {
    "id": "123e4567-e89b-12d3-a456-426614174000",
    "number": 12345,
    "title": "Доставка курьером",
    "price": "500.00",
    "final_price": "450.00",
    "is_price_enabled": false,
    "created_at": "2023-01-15T10:30:00Z"
  }
]

total_count

Type: integer

Общее количество услуг.

AddonID

Идентификатор услуги.

Type: string<uuid>

Example: 123e4567-e89b-12d3-a456-426614174000

AddonListItem

Name

Description

created_at

Type: string<date-time>

Дата создания.

Example: 2023-01-15T10:30:00Z

final_price

Type: string<decimal>

Цена со скидкой.

Example: 450.00

id

Type: AddonID

Идентификатор услуги.

Example: 123e4567-e89b-12d3-a456-426614174000

is_price_enabled

Type: boolean

Отображать ли цену услуги.

number

Type: integer

Числовой идентификатор услуги.

price

Type: string<decimal>

Цена без скидки.

Example: 500.00

title

Type: string

Название услуги.

Example: Доставка курьером

Example
{
  "id": "123e4567-e89b-12d3-a456-426614174000",
  "number": 12345,
  "title": "Доставка курьером",
  "price": "500.00",
  "final_price": "450.00",
  "is_price_enabled": false,
  "created_at": "2023-01-15T10:30:00Z"
}

400 Bad Request

Некорректный запрос.

Body

application/json
{
  "code": "VALIDATION_ERROR",
  "message": "Invalid input",
  "trace_id": "00000000000000000000000000000000"
}

Name

Description

code

Type: string

Example: VALIDATION_ERROR

message

Type: string

Example: Invalid input

trace_id

Type: string

Уникальный идентификатор запроса для отладки.

Example: 00000000000000000000000000000000

401 Unauthorized

Не авторизован.

Body

application/json
{
  "code": "VALIDATION_ERROR",
  "message": "Invalid input",
  "trace_id": "00000000000000000000000000000000"
}

Name

Description

code

Type: string

Example: VALIDATION_ERROR

message

Type: string

Example: Invalid input

trace_id

Type: string

Уникальный идентификатор запроса для отладки.

Example: 00000000000000000000000000000000

500 Internal Server Error

Внутренняя ошибка сервера.

Body

application/json
{
  "code": "VALIDATION_ERROR",
  "message": "Invalid input",
  "trace_id": "00000000000000000000000000000000"
}

Name

Description

code

Type: string

Example: VALIDATION_ERROR

message

Type: string

Example: Invalid input

trace_id

Type: string

Уникальный идентификатор запроса для отладки.

Example: 00000000000000000000000000000000