Получение списка графиков активности
Получение списка графиков активности
Метод | get.schedules |
---|---|
Описание | Получение списка графиков активности |
Кому доступен | Партнёр, Клиент |
Параметры запроса
Название | Тип | Обязательный | Описание |
---|---|---|---|
access_token |
string | да | Ключ сессии аутентификации |
user_id |
number | нет | Уникальный идентификатор пользователя клиента агента от имени которого делается запрос Является обязательным для агентаДля получения списка пользователей клиента необходимо использовать метод "get.customer_users" |
limit |
number | нет | Количество возвращаемых записей. См. раздел "Постраничный вывод" |
offset |
number | нет | Сдвиг, определяет с какого номера записи возвращать "limit" записей. По умолчанию "0". См. раздел "Постраничный вывод" |
filter |
object | нет | См. раздел "Критерии фильтрации" |
fields |
array | нет | См. раздел "Представление возвращаемых данных" |
sort |
array | нет | См. раздел "Сортировка данных" |
Параметры ответа
Название | Тип | Допустимые значения | Фильтрация | Сортировка | Описание |
---|---|---|---|---|---|
id |
number | да | Уникальный идентификатор графика активности | ||
name |
string | да | да | Название графика активности | |
Расписания работы | |||||
schedules |
array | да | Расписания работы | ||
activity_days |
object | Дни в которые график активен | |||
type |
enum |
|
Тип.
| ||
days |
array |
Если "type" = "days_of_week" :
"type" = "days_of_month" :
"type" = "cycle" :
"type" = "business_calendar" :
|
Дни недели или месяца
Пример циклического календаря:
Пример производственного календаря: |
||
Время активности графика | |||||
activity_time |
array |
Время активности графика.
Если параметр не задан, то график работает без ограничений |
|||
time_from |
string | HH:MM | Время начала активности графика | ||
time_till |
string | HH:MM |
Время окончания активности графика.
Должно быть обязательно больше чем указано в параметре "time_from"
|
||
Период активности графика | |||||
activity_date_from |
string | YYYY-MM-DD | Дата начала активности графика | ||
activity_date_till |
string | YYYY-MM-DD | Дата окончания активности графика |
JSON структура запроса
{
"jsonrpc":"2.0",
"id":"number",
"method":"get.schedules",
"params":{
"access_token":"string",
"user_id":"number",
"offset":"number",
"limit":"number",
"filter":{
},
"sort":[
{
"field":"string",
"order":"string"
}
],
"fields":[
"string"
]
}
}
JSON структура ответа
{
"jsonrpc":"2.0",
"id":"number",
"result":{
"metadata":{
},
"data":[
{
"id":"number",
"name":"string",
"schedules":[
{
"activity_days":{
"type":"enum",
"days":[
]
},
"activity_time":[
{
"time_from":"string",
"time_till":"string"
}
],
"activity_date_from":"string",
"activity_date_till":"string"
}
]
}
]
}
}
Список возвращаемых ошибок
Смотрим раздел "Список ошибок для методов с глаголом get"