Список разделов и категорий
GET https://api.usedesk.ru/support/{account_id}/list, {account_id} — ID Базы знаний в системе
Внимание. Если вы используете коробочную версию Юздеска на собственном сервере, URL методов у вас будет отличаться. Уточните URL для работы с API у поддержки — support@usedesk.ru.
Метод возвращает список разделов и категорий в Базе знаний.
* — обязательные поля
|
Параметр
|
Описание
|
|---|---|
| api_token* | Токен API канала |
Пример запроса на PHP
$baseId = 2;
$data = array(
'api_token'=> 'e1cbe1c1c9d910ef2ae975215644cb53dd555de4',
);
$curl = curl_init();
curl_setopt($curl, CURLOPT_URL, 'https://api.usedesk.ru/support/'. $baseId .'/list?' . http_build_query($data));
curl_setopt($curl, CURLOPT_RETURNTRANSFER, true);
$result = curl_exec($curl);
curl_close($curl);
return $result;
Порядок статей, категорий и разделов зависит от их порядка в системе.
Пример ответа от сервера
[
{
"id": 26,
"title": "раздел",
"public": 1,
"order": 0,
"image": "https://secure.usedesk.ru/upload/support/2/42/15427483037735cb7bb7f6a11874125e83c7d2ece15bf4788fd5f40.png",
"categories": [
{
"id": 34,
"title": "категория",
"description": "Описание",
"public": 1,
"order": 1,
"articles" : {
{
"id" : 1,
"title" : "Статья 1",
"views": 23
"rating": {
"positive": 5,
"negative": 1
},
},
{
"id" : 2,
"title" : "Статья 2",
"views": 46
"rating": {
"positive": 2,
"negative": 3
},
}
}
},
{"id": 38, "title": "категория 2", "public": 1, "order": 2, "articles": {}},
{"id": 40, "title": "категория 3", "public": 0, "order": 3, "articles": {}},
{"id": 42, "title": "категория 4", "public": 1, "order": 4, "articles": {}},
{"id": 44, "title": "категория 5", "public": 0, "order": 5, "articles": {}},
]
},
{
"id": 38,
"title": "раздел 2",
"public": 1,
"order": 0,
"categories": [
{"id": 70, "title": "категория ", "public": 0, "order": 1, "articles": {}},
{"id": 72, "title": "категория 2", "public": 1, "order": 2, "articles": {}},
{"id": 74, "title": "категория 3", "public": 1, "order": 3, "articles": {}},
{"id": 76, "title": "категория 4", "public": 1, "order": 4, "articles": {}},
{"id": 78, "title": "категория 5", "public": 1, "order": 5, "articles": {}},
]
}
]
Параметры ответа от сервера
| Параметр | Значение | ||||||||||||||||||||||||
| id | ID раздела | ||||||||||||||||||||||||
| title | Название раздела | ||||||||||||||||||||||||
| public | Флаг, обозначающий за видимость раздела | ||||||||||||||||||||||||
| order | Порядок отображения раздела | ||||||||||||||||||||||||
| image | URL иконки раздела | ||||||||||||||||||||||||
| categories | Массив категорий
|