Методы для работы с бронированиями
Добавление или изменение бронирования
Чтобы изменить существующее бронирования, надо передать поле id с идентификатором бронирования. Если id не передать, то будет создано новое бронирование. В ответ на запрос возвращается созданное или изменённое бронирование.
Создаёт или изменяет бронирование. Без id создаёт бронирование; с id изменяет существующее. warehouse и approve_status обязательны в обоих случаях. Состав ответа зависит от того, является ли пользователь владельцем склада.
Склад должен быть неудалённым; при изменении брони его нельзя заменить. Переданная площадка должна быть неудалённой и принадлежать этому складу. При изменении отсутствие terminal или null снимает привязку к площадке. Для сохранения передавайте её текущий ID.
Если пользователь не владелец склада, approve_status допускает только await_reaction или decline; при создании без order_point обязателен action_type. Изменять бронь может её создатель, владелец склада, грузовладелец или перевозчик связанного заказа. Для пользователя, не владеющего складом, изменение запрещено после двух суток с конца брони, а для подтверждённой брони — также после выхода машины из статуса «Ожидается». Владелец склада может отклонить существующую бронь в статусе await_reaction либо пока машина в статусе «Ожидается».
Даты передавайте как YYYY-MM-DD, время строго ЧЧ:ММ, в локальном времени склада. Отбытие не может быть раньше прибытия. Наличие свободного окна этот метод не гарантирует. Для планирования используйте GET /api/v1/warehouse/workload/{warehouse_id}.
Для брони по заказу передавайте order_point из GET /api/v1/timeslots/my; склад должен совпадать со складом точки, создатель — грузовладелец или перевозчик заказа. Привязку к точке при изменении заменить нельзя. sms_notification=true доступен только владельцу склада. Прикрепить можно не более 10 файлов; участники заказа, не имеющие доступ к бронированию, добавляют файлы брони по заказу через API заказов.
comment доступен для записи владельцу склада; slot_owner_comment не меняется владельцем склада, если бронь создана другой фирмой. При изменении отсутствие attachments и warehouse_cargo_types сохраняет их, [] очищает соответственно файлы запрашивающей фирмы и типы груза. slot_owner и contact_id задаёт сервер. deleted при изменении игнорируется. post /gw/timeslots/api/v1/timeslots
Запрос создания или изменения бронирования.
Создаваемое или изменяемое бронирование.
ID изменяемой брони: поле result.timeslot.id из POST /gw/timeslots/api/v1/timeslots. Не путать с timeslot_readable_id (склад-бронь) или UUID. Для создания не передавайте id.
Время прибытия в локальном времени склада, строго ЧЧ:ММ, без секунд и смещения UTC.
Время отбытия в локальном времени склада, строго ЧЧ:ММ, без секунд и смещения UTC.
Идентификаторы прикрепляемых файлов пользователя.
Отправить водителю SMS; доступно владельцу склада.
Пропуска на въезд и выезд.
Идентификатор пропуска.
Идентификаторы подписантов склада.
Идентификатор бронирования.
entry- Пропуск на въездexit- Пропуск на выезд
approved- Подтвержденоdecline- Отклоненоawait_reaction- Ожидает подтверждения от владельца складаawait_client- Ожидает подтверждения от владельца брони
Действие на складе. Обязательно при создании брони не владельцем склада без order_point.
* loading - Загрузка
* unloading - Разгрузка
* loading_unloading - Загрузка и разгрузка
loading- Загрузкаunloading- Разгрузкаloading_unloading- Загрузка и разгрузка
Создатель окна (firm_id)
Контакт создателя брони
Email бронирующего
Номер ТС
Номер страны ТС
Марка машины
Грузоподъемность ТС
Тип кузова
Тип загрузки и разгрузки машины
* top - Верхняя
* side - Боковая
* double_side - Боковая с 2-х сторон
* read - Задняя
* full_tarpaulin_removal - С полной растентовкой
* removal_of_crossbars - Со снятием поперечных перекладин
* removal_of_stakes - Со снятием стоек
* hydraulic_liftgate - гидроборт
* other - Другое
top- Верхняяside- Боковаяdouble_side- Боковая с 2-х сторонread- Задняяfull_tarpaulin_removal- С полной растентовкойremoval_of_crossbars- Со снятием поперечных перекладинremoval_of_stakes- Со снятием стоекhydraulic_liftgate- гидробортother- Другое
Груз
Количество груза
Единица измерения груза
* pallet - Паллеты
* piece - Штуки
* t - Тонны
* kg - Килограммы
* l - Литры
pallet- Паллетыpiece- Штукиt- Тонныkg- Килограммыl- Литры
Владелец груза
Контакт грузовладельца
Номер телефона
Название фирмы (перевозчик)
ФИО водителя
Номер телефона
Код страны для телефона
Комментарий от СВ
Комментарий владельца слота
Дата прибытия в локальном времени склада, YYYY-MM-DD, без времени.
Дата отбытия в локальном времени склада, YYYY-MM-DD, без времени; не раньше date_from.
Признак удаления. При изменении через POST /timeslots это поле игнорируется; удаление склада помечает удалёнными и его брони.
Тестовый
Идентификатор склада. Источник: GET /gw/timeslots/api/v1/warehouse, поле result.warehouses[].id или result.partners_warehouses[].id. При создании склада: POST /gw/timeslots/api/v1/warehouse, поле result.warehouse.id. Используйте неудалённый склад, доступный для выбранной операции. При изменении брони склад менять нельзя.
Идентификатор площадки склада. Источник: GET /gw/timeslots/api/v1/terminal, поле result.terminals[].id или result.partners_terminals[].id. Выберите площадку с warehouse, равным ID склада, и deleted=false. При создании склада ID площадок возвращаются в result.terminals[].id. При обновлении передавайте текущий ID, если хотите сохранить площадку; отсутствие поля или null снимает привязку.
ID точки заказа во Временных окнах, не ID заказа или груза. Источник: GET /gw/timeslots/api/v1/timeslots/my, поле result.order_points_without_slots[].id. Склад берите из warehouse.id этой же точки. Создание доступно грузовладельцу или перевозчику заказа. При изменении брони точка не меняется.
UUID типов груза из справочника склада, не числовые ID общего словаря грузов ATI. Уже назначенные площадкам типы доступны через GET /gw/timeslots/api/v1/terminal: result.terminals[].warehouse_cargo_types[].id или result.partners_terminals[].warehouse_cargo_types[].id. Это только типы выбранных площадок, не полный справочник склада. Используйте типы своего выбранного склада; если они не нужны, не передавайте поле. При изменении отсутствие поля сохраняет типы, [] очищает их.
curl 'https://api.ati.su/gw/timeslots/api/v1/timeslots' \ -X 'POST' \ -H 'Authorization: Bearer {authorizationToken}' \ -H 'Content-Type: application/json' \ --data-raw '{"timeslot":{"warehouse":101,"terminal":201,"approve_status":"await_reaction","action_type":"loading","date_from":"2030-01-07","date_to":"2030-01-07","time_from":"10:00","time_to":"11:00"}}'Процедура ВыполнитьHTTPЗапрос(МетодЗапроса, АдресХоста, АдресРесурса, ТекстЗапроса) Экспорт ЗаголовкиHTTP = Новый Соответствие(); ЗаголовкиHTTP.Вставить("Accept", "application/json"); ЗаголовкиHTTP.Вставить("Content-Type", "application/json"); ЗаголовкиHTTP.Вставить("Authorization", "Bearer {authorizationToken}"); HTTPЗапрос = Новый HTTPЗапрос(АдресРесурса, ЗаголовкиHTTP); HTTPЗапрос.УстановитьТелоИзСтроки(ТекстЗапроса, КодировкаТекста.UTF8, ИспользованиеByteOrderMark.НеИспользовать); ЗащищенноеСоединениеSSL = Новый ЗащищенноеСоединениеOpenSSL(Новый СертификатКлиентаWindows, Новый СертификатыУдостоверяющихЦентровWindows);
Соединение = Новый HTTPСоединение(АдресХоста,,,,,, ЗащищенноеСоединениеSSL);
Попытка Ответ = Соединение.ВызватьHTTPМетод(МетодЗапроса, HTTPЗапрос); Сообщить("Код ответа: " + Ответ.КодСостояния); Сообщить("Ответ: " + Ответ.ПолучитьТелоКакСтроку("UTF-8")); Исключение Сообщить("Ошибка выполнения запроса!" + Символы.ПС + ОписаниеОшибки()); КонецПопытки;КонецПроцедуры
ВыполнитьHTTPЗапрос("POST", "https://api.ati.su", "/gw/timeslots/api/v1/timeslots", "{""timeslot"":{""warehouse"":101,""terminal"":201,""approve_status"":""await_reaction"",""action_type"":""loading"",""date_from"":""2030-01-07"",""date_to"":""2030-01-07"",""time_from"":""10:00"",""time_to"":""11:00""}}"); 200
Ответ владельцу склада или другому участнику бронирования.
Успешный ответ.
Результат выполнения запроса.
Созданное или изменённое бронирование.
Идентификатор объекта.
Время прибытия на склад, ЧЧ:ММ.
Время отбытия со склада, ЧЧ:ММ.
История статусов пребывания машины на складе.
Название статуса пребывания.
Время начала действия статуса.
Время завершения действия статуса.
Идентификатор статуса пребывания.
Идентификатор бронирования.
Комментарий владельца склада.
Цвет статуса.
Информация о складе.
Идентификатор объекта.
Название склада.
Адрес склада.
Название города.
Смещение времени склада относительно UTC в минутах.
Идентификатор фирмы владельца склада.
Контакты склада.
Идентификатор объекта.
Название.
Телефон контактного лица.
Код страны телефона.
Идентификатор склада.
Файлы, прикреплённые к бронированию.
Идентификатор объекта.
Может ли пользователь удалить файл.
Ссылка на файл.
Исходное имя файла.
Размер файла в байтах.
Идентификатор фирмы владельца файла.
Идентификатор контакта пользователя.
Дата и время создания.
Дата и время изменения.
Признак удаления.
Доступно ли пользователю редактирование бронирования.
Истёк ли срок бронирования.
Номер бронирования в формате склад-бронь.
Пропуска на въезд и выезд.
Идентификатор объекта.
Результаты согласования пропуска подписантами.
Идентификатор контакта фирмы подписанта.
Согласован ли пропуск контактом.
Идентификатор записи подписанта склада.
Идентификаторы подписантов склада.
Идентификатор бронирования.
Тип пропуска: въезд или выезд.
Дата и время создания.
Дата и время изменения.
Уникальный идентификатор бронирования.
Статус подтверждения бронирования.
Действие на складе: погрузка, разгрузка или оба действия.
Идентификатор фирмы, создавшей бронирование; определяется сервером.
Идентификатор контакта пользователя.
Электронная почта бронирующего.
Государственный номер автомобиля.
Код страны регистрации автомобиля.
Марка автомобиля.
Грузоподъёмность автомобиля в тоннах.
Тип кузова автомобиля.
Способ загрузки автомобиля.
Наименование груза.
Количество груза.
Единица измерения количества груза.
Название грузовладельца.
Имя контактного лица грузовладельца.
Телефон контактного лица грузовладельца.
Название фирмы перевозчика.
ФИО водителя.
Телефон водителя.
Код страны телефона.
Комментарий владельца склада.
Комментарий владельца брони.
Дата прибытия на склад.
Дата отбытия со склада.
Дата и время создания.
Дата и время изменения.
Признак удаления.
Признак тестовой записи.
Название площадки.
Идентификатор склада.
Название склада.
Идентификатор площадки погрузки-разгрузки.
Точка заказа, связанная с бронированием.
Точка загрузки или разгрузки заказа.
Идентификатор объекта.
Может ли пользователь создать бронь для точки заказа.
Краткий номер груза.
Идентификатор сделки.
Идентификатор заказа во Временных окнах.
Объект склада точки заказа. Для создания брони используйте поле warehouse.id, а не весь объект.
Идентификатор объекта.
Название склада.
Адрес склада.
Название города.
Смещение времени склада относительно UTC в минутах.
Идентификатор фирмы владельца склада.
Контакты склада.
Идентификатор объекта.
Название.
Телефон контактного лица.
Код страны телефона.
Идентификатор склада.
ФИО водителя.
Телефон водителя.
Государственный номер автомобиля.
Грузоподъёмность автомобиля.
Идентификатор фирмы грузовладельца; доступен владельцу склада и грузовладельцу.
Идентификатор контакта грузовладельца.
Идентификатор фирмы перевозчика; доступен владельцу склада и грузовладельцу.
Грузы заказа.
Порядковый номер груза.
Идентификатор типа груза.
Наименование типа груза на языке запроса.
Вес груза в тоннах.
Объём груза в кубических метрах.
Идентификатор фирмы владельца склада.
Маршрут заказа.
Название города; заполняется по географическому справочнику.
Идентификатор населённого пункта в геословаре ATI. Источник: POST /gw/gis-dict/v1/autocomplete/suggestions с suggestion_types=1; подставляйте suggestions[].city.id выбранного города. Проверка известного ID: POST /gw/gis-dict/v1/cities/by-ids, поле cities[].id. Документация: https://ati.su/developers/api/dictionaries/geo/
Тип точки маршрута.
Файлы заказа, доступные пользователю.
Идентификатор объекта.
Идентификатор документа.
Группы пользователей, которым доступен файл.
Дата и время создания.
Идентификатор фирмы владельца файла.
Исходное имя файла.
Ссылка на файл.
Идентификатор заказа.
Источник файла.
Порядковый номер точки заказа.
Тип точки заказа.
Название типа кузова на языке запроса.
Типы груза из справочника склада.
Идентификатор объекта.
Подтверждён ли тип груза владельцем склада.
Идентификатор типа груза.
Идентификатор склада.
Название типа груза на языке запроса.
Признак успешного выполнения запроса.
Успешный ответ.
Результат выполнения запроса.
Созданное или изменённое бронирование.
Идентификатор объекта.
Время прибытия на склад, ЧЧ:ММ.
Время отбытия со склада, ЧЧ:ММ.
История статусов пребывания машины на складе.
Название статуса пребывания.
Время начала действия статуса.
Время завершения действия статуса.
Идентификатор статуса пребывания.
Идентификатор бронирования.
Цвет статуса.
Информация о складе.
Идентификатор объекта.
Название склада.
Адрес склада.
Название города.
Смещение времени склада относительно UTC в минутах.
Идентификатор фирмы владельца склада.
Контакты склада.
Идентификатор объекта.
Название.
Телефон контактного лица.
Код страны телефона.
Идентификатор склада.
Файлы, прикреплённые к бронированию.
Идентификатор объекта.
Может ли пользователь удалить файл.
Ссылка на файл.
Исходное имя файла.
Размер файла в байтах.
Идентификатор фирмы владельца файла.
Идентификатор контакта пользователя.
Дата и время создания.
Дата и время изменения.
Признак удаления.
Доступно ли пользователю редактирование бронирования.
Истёк ли срок бронирования.
Номер бронирования в формате склад-бронь.
Уникальный идентификатор бронирования.
Статус подтверждения бронирования.
Действие на складе: погрузка, разгрузка или оба действия.
Идентификатор фирмы, создавшей бронирование; определяется сервером.
Идентификатор контакта пользователя.
Электронная почта бронирующего.
Государственный номер автомобиля.
Код страны регистрации автомобиля.
Марка автомобиля.
Грузоподъёмность автомобиля в тоннах.
Тип кузова автомобиля.
Способ загрузки автомобиля.
Название фирмы перевозчика.
ФИО водителя.
Телефон водителя.
Код страны телефона.
Комментарий владельца брони.
Дата прибытия на склад.
Дата отбытия со склада.
Дата и время создания.
Дата и время изменения.
Признак удаления.
Признак тестовой записи.
Название площадки.
Идентификатор склада.
Название склада.
Идентификатор площадки погрузки-разгрузки.
Точка заказа, связанная с бронированием.
Точка загрузки или разгрузки заказа.
Идентификатор объекта.
Может ли пользователь создать бронь для точки заказа.
Краткий номер груза.
Идентификатор сделки.
Идентификатор заказа во Временных окнах.
Объект склада точки заказа. Для создания брони используйте поле warehouse.id, а не весь объект.
Идентификатор объекта.
Название склада.
Адрес склада.
Название города.
Смещение времени склада относительно UTC в минутах.
Идентификатор фирмы владельца склада.
Контакты склада.
Идентификатор объекта.
Название.
Телефон контактного лица.
Код страны телефона.
Идентификатор склада.
ФИО водителя.
Телефон водителя.
Государственный номер автомобиля.
Грузоподъёмность автомобиля.
Идентификатор фирмы грузовладельца; доступен владельцу склада и грузовладельцу.
Идентификатор контакта грузовладельца.
Идентификатор фирмы перевозчика; доступен владельцу склада и грузовладельцу.
Грузы заказа.
Порядковый номер груза.
Идентификатор типа груза.
Наименование типа груза на языке запроса.
Вес груза в тоннах.
Объём груза в кубических метрах.
Идентификатор фирмы владельца склада.
Маршрут заказа.
Название города; заполняется по географическому справочнику.
Идентификатор населённого пункта в геословаре ATI. Источник: POST /gw/gis-dict/v1/autocomplete/suggestions с suggestion_types=1; подставляйте suggestions[].city.id выбранного города. Проверка известного ID: POST /gw/gis-dict/v1/cities/by-ids, поле cities[].id. Документация: https://ati.su/developers/api/dictionaries/geo/
Тип точки маршрута.
Файлы заказа, доступные пользователю.
Идентификатор объекта.
Идентификатор документа.
Группы пользователей, которым доступен файл.
Дата и время создания.
Идентификатор фирмы владельца файла.
Исходное имя файла.
Ссылка на файл.
Идентификатор заказа.
Источник файла.
Порядковый номер точки заказа.
Тип точки заказа.
Название типа кузова на языке запроса.
Типы груза из справочника склада.
Идентификатор объекта.
Подтверждён ли тип груза владельцем склада.
Идентификатор типа груза.
Идентификатор склада.
Название типа груза на языке запроса.
Короткая ссылка на публичную страницу брони.
Признак успешного выполнения запроса.
400 Некорректный запрос или нарушение правил бронирования.
Ошибка запроса с подробностями по отдельным полям.
Машиночитаемый код ошибки.
Описание причины ошибки.
Ошибки отдельных полей запроса.
Машиночитаемый код ошибки.
Описание причины ошибки.
403 Контекст пользователя отсутствует или некорректен.
Ошибка API: код и причина.
Машиночитаемый код ошибки.
Описание причины ошибки.
404 Бронирование не найдено.
Ошибка API: код и причина.
Машиночитаемый код ошибки.
Описание причины ошибки.
Получение существующих бронирований и точек заказа без брони
Возвращается список существующих бронирований и точек заказа, для которых бронирования ещё не созданы. Запрашивающий пользователь должен быть создателем бронирования, или владельцем груза (из заказа), или перевозчиком (из заказа).
Получает мои бронирования и точки заказов без брони. Доступны брони, где фирма пользователя — грузовладелец или перевозчик заказа, а также созданные фирмой брони на чужих складах. Само владение складом доступа не даёт. Точки без брони доступны грузовладельцу и перевозчику заказа; скрытые пользователем точки и удалённые склады исключены. Удалённые брони исключены, но их точки не считаются точками без брони. Пагинации и гарантированного порядка нет. count и order_points_without_slots_count — размеры соответствующих списков после фильтрации. Комментарий склада, сведения о грузе брони и пропуска не возвращаются. Идентификаторы фирм в точке заказа видны только владельцу склада или грузовладельцу. Для создания брони используйте POST /api/v1/timeslots с warehouse и order_point из точки. get /gw/timeslots/api/v1/timeslots/my
| Параметр | Тип | Расположение | Описание |
|---|---|---|---|
approve_status | string | query | Статус подтверждения; применяется только к броням.
* `approved` - Подтверждено
* `decline` - Отклонено
* `await_reaction` - Ожидает подтверждения от владельца склада
* `await_client` - Ожидает подтверждения от владельца брони Пример: approved |
date_from | string (date) | query | Дата прибытия от, включительно. Без неё выбираются брони за последние 365 дней. Пример: 2030-01-01 |
date_from_end | string (date) | query | Дата прибытия до, включительно; применяется только вместе с date_from. Пример: 2030-01-01 |
date_to | string (date) | query | Дата отбытия до, включительно; только для броней. Пример: 2030-01-01 |
deal_id | string (uuid) | query | Идентификатор сделки; применяется к броням и точкам заказов. Пример: 11111111-1111-4111-8111-111111111111 |
is_expired | boolean | query | Фильтр броней по истечению срока в локальном времени склада. null — без фильтра. Пример: false |
only_order_points_without_slots | boolean | query | В /timeslots/my не возвращать брони; вернуть только точки без брони. Пример: false |
only_timeslots | boolean | query | В /timeslots/my не возвращать точки без брони. Не включайте вместе с only_order_points_without_slots: оба списка будут пустыми. Пример: false |
order_point_id | integer | query | Идентификатор точки заказа; применяется к обоим спискам. Пример: 1 |
order_point_type | integer | query | Тип точки заказа; применяется к обоим спискам.
* `1` - Загрузка
* `2` - Разгрузка Пример: 1 |
ordinal_id | integer | query | Порядковый номер точки заказа; применяется к обоим спискам. Пример: 1 |
terminal_id | integer | query | Идентификатор площадки склада. Источник: GET /gw/timeslots/api/v1/terminal, поле result.terminals[].id или result.partners_terminals[].id. Выберите площадку с warehouse, равным ID склада, и deleted=false. При создании склада ID площадок возвращаются в result.terminals[].id. Фильтр применяется только к броням. Пример: 1 |
time_from | string (time) | query | Время прибытия от, включительно; только для броней. Пример: 10:00 |
time_to | string (time) | query | Время отбытия до, включительно; только для броней. Пример: 18:00 |
timeslot_id | integer | query | Идентификатор бронирования; не ограничивает список точек без брони. Пример: 1 |
warehouse_id | integer | query | Идентификатор склада. Источник: GET /gw/timeslots/api/v1/warehouse, поле result.warehouses[].id или result.partners_warehouses[].id. При создании склада: POST /gw/timeslots/api/v1/warehouse, поле result.warehouse.id. Используйте неудалённый склад, доступный для выбранной операции. Фильтр применяется к броням и точкам заказов. Пример: 1 |
curl 'https://api.ati.su/gw/timeslots/api/v1/timeslots/my' \ -X 'GET' \ -H 'Authorization: Bearer {authorizationToken}' \ -H 'Content-Type: application/json'Процедура ВыполнитьHTTPЗапрос(МетодЗапроса, АдресХоста, АдресРесурса, ТекстЗапроса) Экспорт ЗаголовкиHTTP = Новый Соответствие(); ЗаголовкиHTTP.Вставить("Accept", "application/json"); ЗаголовкиHTTP.Вставить("Content-Type", "application/json"); ЗаголовкиHTTP.Вставить("Authorization", "Bearer {authorizationToken}"); HTTPЗапрос = Новый HTTPЗапрос(АдресРесурса, ЗаголовкиHTTP); HTTPЗапрос.УстановитьТелоИзСтроки(ТекстЗапроса, КодировкаТекста.UTF8, ИспользованиеByteOrderMark.НеИспользовать); ЗащищенноеСоединениеSSL = Новый ЗащищенноеСоединениеOpenSSL(Новый СертификатКлиентаWindows, Новый СертификатыУдостоверяющихЦентровWindows);
Соединение = Новый HTTPСоединение(АдресХоста,,,,,, ЗащищенноеСоединениеSSL);
Попытка Ответ = Соединение.ВызватьHTTPМетод(МетодЗапроса, HTTPЗапрос); Сообщить("Код ответа: " + Ответ.КодСостояния); Сообщить("Ответ: " + Ответ.ПолучитьТелоКакСтроку("UTF-8")); Исключение Сообщить("Ошибка выполнения запроса!" + Символы.ПС + ОписаниеОшибки()); КонецПопытки;КонецПроцедуры
ВыполнитьHTTPЗапрос("GET", "https://api.ati.su", "/gw/timeslots/api/v1/timeslots/my"); 200
Успешный ответ.
Результат выполнения запроса.
Количество возвращённых бронирований.
Доступные бронирования после фильтрации.
Идентификатор объекта.
Время прибытия на склад, ЧЧ:ММ.
Время отбытия со склада, ЧЧ:ММ.
История статусов пребывания машины на складе.
Название статуса пребывания.
Время начала действия статуса.
Время завершения действия статуса.
Идентификатор статуса пребывания.
Идентификатор бронирования.
Цвет статуса.
Информация о складе.
Идентификатор объекта.
Название склада.
Адрес склада.
Название города.
Смещение времени склада относительно UTC в минутах.
Идентификатор фирмы владельца склада.
Контакты склада.
Идентификатор объекта.
Название.
Телефон контактного лица.
Код страны телефона.
Идентификатор склада.
Файлы, прикреплённые к бронированию.
Идентификатор объекта.
Может ли пользователь удалить файл.
Ссылка на файл.
Исходное имя файла.
Размер файла в байтах.
Идентификатор фирмы владельца файла.
Идентификатор контакта пользователя.
Дата и время создания.
Дата и время изменения.
Признак удаления.
Доступно ли пользователю редактирование бронирования.
Истёк ли срок бронирования.
Номер бронирования в формате склад-бронь.
Уникальный идентификатор бронирования.
Статус подтверждения бронирования.
Действие на складе: погрузка, разгрузка или оба действия.
Идентификатор фирмы, создавшей бронирование; определяется сервером.
Идентификатор контакта пользователя.
Электронная почта бронирующего.
Государственный номер автомобиля.
Код страны регистрации автомобиля.
Марка автомобиля.
Грузоподъёмность автомобиля в тоннах.
Тип кузова автомобиля.
Способ загрузки автомобиля.
Название фирмы перевозчика.
ФИО водителя.
Телефон водителя.
Код страны телефона.
Комментарий владельца брони.
Дата прибытия на склад.
Дата отбытия со склада.
Дата и время создания.
Дата и время изменения.
Признак удаления.
Признак тестовой записи.
Название площадки.
Идентификатор склада.
Название склада.
Идентификатор площадки погрузки-разгрузки.
Точка заказа, связанная с бронированием.
Точка загрузки или разгрузки заказа.
Идентификатор объекта.
Может ли пользователь создать бронь для точки заказа.
Краткий номер груза.
Идентификатор сделки.
Идентификатор заказа во Временных окнах.
Объект склада точки заказа. Для создания брони используйте поле warehouse.id, а не весь объект.
Идентификатор объекта.
Название склада.
Адрес склада.
Название города.
Смещение времени склада относительно UTC в минутах.
Идентификатор фирмы владельца склада.
Контакты склада.
Идентификатор объекта.
Название.
Телефон контактного лица.
Код страны телефона.
Идентификатор склада.
ФИО водителя.
Телефон водителя.
Государственный номер автомобиля.
Грузоподъёмность автомобиля.
Идентификатор фирмы грузовладельца; доступен владельцу склада и грузовладельцу.
Идентификатор контакта грузовладельца.
Идентификатор фирмы перевозчика; доступен владельцу склада и грузовладельцу.
Грузы заказа.
Порядковый номер груза.
Идентификатор типа груза.
Наименование типа груза на языке запроса.
Вес груза в тоннах.
Объём груза в кубических метрах.
Идентификатор фирмы владельца склада.
Маршрут заказа.
Название города; заполняется по географическому справочнику.
Идентификатор населённого пункта в геословаре ATI. Источник: POST /gw/gis-dict/v1/autocomplete/suggestions с suggestion_types=1; подставляйте suggestions[].city.id выбранного города. Проверка известного ID: POST /gw/gis-dict/v1/cities/by-ids, поле cities[].id. Документация: https://ati.su/developers/api/dictionaries/geo/
Тип точки маршрута.
Файлы заказа, доступные пользователю.
Идентификатор объекта.
Идентификатор документа.
Группы пользователей, которым доступен файл.
Дата и время создания.
Идентификатор фирмы владельца файла.
Исходное имя файла.
Ссылка на файл.
Идентификатор заказа.
Источник файла.
Порядковый номер точки заказа.
Тип точки заказа.
Название типа кузова на языке запроса.
Типы груза из справочника склада.
Идентификатор объекта.
Подтверждён ли тип груза владельцем склада.
Идентификатор типа груза.
Идентификатор склада.
Название типа груза на языке запроса.
Короткая ссылка на публичную страницу брони.
Количество возвращённых точек без брони.
Доступные точки заказов без бронирований.
Идентификатор объекта.
Может ли пользователь создать бронь для точки заказа.
Краткий номер груза.
Идентификатор сделки.
Идентификатор заказа во Временных окнах.
Объект склада точки заказа. Для создания брони используйте поле warehouse.id, а не весь объект.
Идентификатор объекта.
Название склада.
Адрес склада.
Название города.
Смещение времени склада относительно UTC в минутах.
Идентификатор фирмы владельца склада.
Контакты склада.
Идентификатор объекта.
Название.
Телефон контактного лица.
Код страны телефона.
Идентификатор склада.
ФИО водителя.
Телефон водителя.
Государственный номер автомобиля.
Грузоподъёмность автомобиля.
Идентификатор фирмы грузовладельца; доступен владельцу склада и грузовладельцу.
Идентификатор контакта грузовладельца.
Идентификатор фирмы перевозчика; доступен владельцу склада и грузовладельцу.
Грузы заказа.
Порядковый номер груза.
Идентификатор типа груза.
Наименование типа груза на языке запроса.
Вес груза в тоннах.
Объём груза в кубических метрах.
Идентификатор фирмы владельца склада.
Маршрут заказа.
Название города; заполняется по географическому справочнику.
Идентификатор населённого пункта в геословаре ATI. Источник: POST /gw/gis-dict/v1/autocomplete/suggestions с suggestion_types=1; подставляйте suggestions[].city.id выбранного города. Проверка известного ID: POST /gw/gis-dict/v1/cities/by-ids, поле cities[].id. Документация: https://ati.su/developers/api/dictionaries/geo/
Тип точки маршрута.
Файлы заказа, доступные пользователю.
Идентификатор объекта.
Идентификатор документа.
Группы пользователей, которым доступен файл.
Дата и время создания.
Идентификатор фирмы владельца файла.
Исходное имя файла.
Ссылка на файл.
Идентификатор заказа.
Источник файла.
Порядковый номер точки заказа.
Тип точки заказа.
Название типа кузова на языке запроса.
Аккаунты ФС по firm_id (строковые ключи JSON). Значения содержат account_id, firm_id, full_firm_name, firm_name, brand, firm_type, contacts (id, ati_id, name) и location (city_id, country_id, city_name), если поля предоставлены ФС. Включает владельцев броней; участников заказа — только для грузовладельца или владельца склада. При отсутствии аккаунтов — {}.
Фирма и её доступные контакты.
Код фирмы в АТИ.
Внутренний ID фирмы.
Полное название фирмы.
Название фирмы.
Бренд фирмы.
Тип фирмы.
Видимые контакты фирмы.
ID контакта внутри фирмы.
Код фирмы контакта в АТИ, если предоставлен ФС.
Имя контакта.
Местоположение фирмы.
Идентификатор населённого пункта в геословаре ATI. Источник: POST /gw/gis-dict/v1/autocomplete/suggestions с suggestion_types=1; подставляйте suggestions[].city.id выбранного города. Проверка известного ID: POST /gw/gis-dict/v1/cities/by-ids, поле cities[].id. Документация: https://ati.su/developers/api/dictionaries/geo/
ID страны.
Название города.
Принятые фильтры со значениями по умолчанию; неявная граница 365 дней сюда не добавляется.
Идентификатор склада. Источник: GET /gw/timeslots/api/v1/warehouse, поле result.warehouses[].id или result.partners_warehouses[].id. При создании склада: POST /gw/timeslots/api/v1/warehouse, поле result.warehouse.id. Используйте неудалённый склад, доступный для выбранной операции. Фильтр применяется к броням и точкам заказов.
Идентификатор площадки склада. Источник: GET /gw/timeslots/api/v1/terminal, поле result.terminals[].id или result.partners_terminals[].id. Выберите площадку с warehouse, равным ID склада, и deleted=false. При создании склада ID площадок возвращаются в result.terminals[].id. Фильтр применяется только к броням.
Дата прибытия от, включительно. Без неё выбираются брони за последние 365 дней.
Дата прибытия до, включительно; применяется только вместе с date_from.
Дата отбытия до, включительно; только для броней.
Время прибытия от, включительно; только для броней.
Время отбытия до, включительно; только для броней.
Идентификатор сделки; применяется к броням и точкам заказов.
Порядковый номер точки заказа; применяется к обоим спискам.
1- Загрузка2- Разгрузка
approved- Подтвержденоdecline- Отклоненоawait_reaction- Ожидает подтверждения от владельца складаawait_client- Ожидает подтверждения от владельца брони
Идентификатор бронирования; не ограничивает список точек без брони.
Идентификатор точки заказа; применяется к обоим спискам.
В /timeslots/my не возвращать точки без брони. Не включайте вместе с only_order_points_without_slots: оба списка будут пустыми.
В /timeslots/my не возвращать брони; вернуть только точки без брони.
Фильтр броней по истечению срока в локальном времени склада. null — без фильтра.
Признак успешного выполнения запроса.
400 Некорректные значения фильтров.
Ошибка запроса с подробностями по отдельным полям.
Машиночитаемый код ошибки.
Описание причины ошибки.
Ошибки отдельных полей запроса.
Машиночитаемый код ошибки.
Описание причины ошибки.
403 Контекст пользователя отсутствует или некорректен.
Ошибка API: код и причина.
Машиночитаемый код ошибки.
Описание причины ошибки.
503 Сервис аккаунтов недоступен.
Ошибка API: код и причина.
Машиночитаемый код ошибки.
Описание причины ошибки.
Получение существующих бронирований фирмы
Возвращается список бронирований на складах своей фирмы. Фирма определяется по авторизованному пользователю; идентификатор фирмы в URL не передаётся. Также с помощью query параметров можно передать фильтры.
Получает расписание бронирований на складах своей фирмы. Фирма определяется по контексту пользователя, ati_id в URL не передаётся. Возвращает неудалённые брони на собственных неудалённых складах, независимо от создателя брони и участия в заказе. Это отличается от GET /api/v1/timeslots/my. Без date_from применяется граница последних 365 дней. Пагинации и гарантированного порядка нет. count равен числу возвращённых броней. Владелец склада получает полный состав полей брони; accounts содержит связанные фирмы, timeslot_filters — принятые фильтры. get /gw/timeslots/api/v1/timeslots/schedule
| Параметр | Тип | Расположение | Описание |
|---|---|---|---|
approve_status | string | query | Статус подтверждения; применяется только к броням.
* `approved` - Подтверждено
* `decline` - Отклонено
* `await_reaction` - Ожидает подтверждения от владельца склада
* `await_client` - Ожидает подтверждения от владельца брони Пример: approved |
date_from | string (date) | query | Дата прибытия от, включительно. Без неё выбираются брони за последние 365 дней. Пример: 2030-01-01 |
date_from_end | string (date) | query | Дата прибытия до, включительно; применяется только вместе с date_from. Пример: 2030-01-01 |
date_to | string (date) | query | Дата отбытия до, включительно; только для броней. Пример: 2030-01-01 |
deal_id | string (uuid) | query | Идентификатор сделки; применяется к броням и точкам заказов. Пример: 11111111-1111-4111-8111-111111111111 |
is_expired | boolean | query | Фильтр броней по истечению срока в локальном времени склада. null — без фильтра. Пример: false |
order_point_id | integer | query | Идентификатор точки заказа; применяется к обоим спискам. Пример: 1 |
order_point_type | integer | query | Тип точки заказа; применяется к обоим спискам.
* `1` - Загрузка
* `2` - Разгрузка Пример: 1 |
ordinal_id | integer | query | Порядковый номер точки заказа; применяется к обоим спискам. Пример: 1 |
terminal_id | integer | query | Идентификатор площадки склада. Источник: GET /gw/timeslots/api/v1/terminal, поле result.terminals[].id или result.partners_terminals[].id. Выберите площадку с warehouse, равным ID склада, и deleted=false. При создании склада ID площадок возвращаются в result.terminals[].id. Фильтр применяется только к броням. Пример: 1 |
time_from | string (time) | query | Время прибытия от, включительно; только для броней. Пример: 10:00 |
time_to | string (time) | query | Время отбытия до, включительно; только для броней. Пример: 18:00 |
timeslot_id | integer | query | Идентификатор бронирования; не ограничивает список точек без брони. Пример: 1 |
warehouse_id | integer | query | Идентификатор склада. Источник: GET /gw/timeslots/api/v1/warehouse, поле result.warehouses[].id или result.partners_warehouses[].id. При создании склада: POST /gw/timeslots/api/v1/warehouse, поле result.warehouse.id. Используйте неудалённый склад, доступный для выбранной операции. Фильтр применяется к броням и точкам заказов. Пример: 1 |
curl 'https://api.ati.su/gw/timeslots/api/v1/timeslots/schedule' \ -X 'GET' \ -H 'Authorization: Bearer {authorizationToken}' \ -H 'Content-Type: application/json'Процедура ВыполнитьHTTPЗапрос(МетодЗапроса, АдресХоста, АдресРесурса, ТекстЗапроса) Экспорт ЗаголовкиHTTP = Новый Соответствие(); ЗаголовкиHTTP.Вставить("Accept", "application/json"); ЗаголовкиHTTP.Вставить("Content-Type", "application/json"); ЗаголовкиHTTP.Вставить("Authorization", "Bearer {authorizationToken}"); HTTPЗапрос = Новый HTTPЗапрос(АдресРесурса, ЗаголовкиHTTP); HTTPЗапрос.УстановитьТелоИзСтроки(ТекстЗапроса, КодировкаТекста.UTF8, ИспользованиеByteOrderMark.НеИспользовать); ЗащищенноеСоединениеSSL = Новый ЗащищенноеСоединениеOpenSSL(Новый СертификатКлиентаWindows, Новый СертификатыУдостоверяющихЦентровWindows);
Соединение = Новый HTTPСоединение(АдресХоста,,,,,, ЗащищенноеСоединениеSSL);
Попытка Ответ = Соединение.ВызватьHTTPМетод(МетодЗапроса, HTTPЗапрос); Сообщить("Код ответа: " + Ответ.КодСостояния); Сообщить("Ответ: " + Ответ.ПолучитьТелоКакСтроку("UTF-8")); Исключение Сообщить("Ошибка выполнения запроса!" + Символы.ПС + ОписаниеОшибки()); КонецПопытки;КонецПроцедуры
ВыполнитьHTTPЗапрос("GET", "https://api.ati.su", "/gw/timeslots/api/v1/timeslots/schedule"); 200
Успешный ответ.
Результат выполнения запроса.
Количество возвращённых броней.
Брони на собственных складах после фильтрации.
Идентификатор объекта.
Время прибытия на склад, ЧЧ:ММ.
Время отбытия со склада, ЧЧ:ММ.
История статусов пребывания машины на складе.
Название статуса пребывания.
Время начала действия статуса.
Время завершения действия статуса.
Идентификатор статуса пребывания.
Идентификатор бронирования.
Комментарий владельца склада.
Цвет статуса.
Информация о складе.
Идентификатор объекта.
Название склада.
Адрес склада.
Название города.
Смещение времени склада относительно UTC в минутах.
Идентификатор фирмы владельца склада.
Контакты склада.
Идентификатор объекта.
Название.
Телефон контактного лица.
Код страны телефона.
Идентификатор склада.
Файлы, прикреплённые к бронированию.
Идентификатор объекта.
Может ли пользователь удалить файл.
Ссылка на файл.
Исходное имя файла.
Размер файла в байтах.
Идентификатор фирмы владельца файла.
Идентификатор контакта пользователя.
Дата и время создания.
Дата и время изменения.
Признак удаления.
Доступно ли пользователю редактирование бронирования.
Истёк ли срок бронирования.
Номер бронирования в формате склад-бронь.
Пропуска на въезд и выезд.
Идентификатор объекта.
Результаты согласования пропуска подписантами.
Идентификатор контакта фирмы подписанта.
Согласован ли пропуск контактом.
Идентификатор записи подписанта склада.
Идентификаторы подписантов склада.
Идентификатор бронирования.
Тип пропуска: въезд или выезд.
Дата и время создания.
Дата и время изменения.
Уникальный идентификатор бронирования.
Статус подтверждения бронирования.
Действие на складе: погрузка, разгрузка или оба действия.
Идентификатор фирмы, создавшей бронирование; определяется сервером.
Идентификатор контакта пользователя.
Электронная почта бронирующего.
Государственный номер автомобиля.
Код страны регистрации автомобиля.
Марка автомобиля.
Грузоподъёмность автомобиля в тоннах.
Тип кузова автомобиля.
Способ загрузки автомобиля.
Наименование груза.
Количество груза.
Единица измерения количества груза.
Название грузовладельца.
Имя контактного лица грузовладельца.
Телефон контактного лица грузовладельца.
Название фирмы перевозчика.
ФИО водителя.
Телефон водителя.
Код страны телефона.
Комментарий владельца склада.
Комментарий владельца брони.
Дата прибытия на склад.
Дата отбытия со склада.
Дата и время создания.
Дата и время изменения.
Признак удаления.
Признак тестовой записи.
Название площадки.
Идентификатор склада.
Название склада.
Идентификатор площадки погрузки-разгрузки.
Точка заказа, связанная с бронированием.
Точка загрузки или разгрузки заказа.
Идентификатор объекта.
Может ли пользователь создать бронь для точки заказа.
Краткий номер груза.
Идентификатор сделки.
Идентификатор заказа во Временных окнах.
Объект склада точки заказа. Для создания брони используйте поле warehouse.id, а не весь объект.
Идентификатор объекта.
Название склада.
Адрес склада.
Название города.
Смещение времени склада относительно UTC в минутах.
Идентификатор фирмы владельца склада.
Контакты склада.
Идентификатор объекта.
Название.
Телефон контактного лица.
Код страны телефона.
Идентификатор склада.
ФИО водителя.
Телефон водителя.
Государственный номер автомобиля.
Грузоподъёмность автомобиля.
Идентификатор фирмы грузовладельца; доступен владельцу склада и грузовладельцу.
Идентификатор контакта грузовладельца.
Идентификатор фирмы перевозчика; доступен владельцу склада и грузовладельцу.
Грузы заказа.
Порядковый номер груза.
Идентификатор типа груза.
Наименование типа груза на языке запроса.
Вес груза в тоннах.
Объём груза в кубических метрах.
Идентификатор фирмы владельца склада.
Маршрут заказа.
Название города; заполняется по географическому справочнику.
Идентификатор населённого пункта в геословаре ATI. Источник: POST /gw/gis-dict/v1/autocomplete/suggestions с suggestion_types=1; подставляйте suggestions[].city.id выбранного города. Проверка известного ID: POST /gw/gis-dict/v1/cities/by-ids, поле cities[].id. Документация: https://ati.su/developers/api/dictionaries/geo/
Тип точки маршрута.
Файлы заказа, доступные пользователю.
Идентификатор объекта.
Идентификатор документа.
Группы пользователей, которым доступен файл.
Дата и время создания.
Идентификатор фирмы владельца файла.
Исходное имя файла.
Ссылка на файл.
Идентификатор заказа.
Источник файла.
Порядковый номер точки заказа.
Тип точки заказа.
Название типа кузова на языке запроса.
Типы груза из справочника склада.
Идентификатор объекта.
Подтверждён ли тип груза владельцем склада.
Идентификатор типа груза.
Идентификатор склада.
Название типа груза на языке запроса.
Аккаунты ФС по firm_id, строковым ключам JSON; без аккаунтов — {}.
Фирма и её доступные контакты.
Код фирмы в АТИ.
Внутренний ID фирмы.
Полное название фирмы.
Название фирмы.
Бренд фирмы.
Тип фирмы.
Видимые контакты фирмы.
ID контакта внутри фирмы.
Код фирмы контакта в АТИ, если предоставлен ФС.
Имя контакта.
Местоположение фирмы.
Идентификатор населённого пункта в геословаре ATI. Источник: POST /gw/gis-dict/v1/autocomplete/suggestions с suggestion_types=1; подставляйте suggestions[].city.id выбранного города. Проверка известного ID: POST /gw/gis-dict/v1/cities/by-ids, поле cities[].id. Документация: https://ati.su/developers/api/dictionaries/geo/
ID страны.
Название города.
Принятые фильтры
Идентификатор склада. Источник: GET /gw/timeslots/api/v1/warehouse, поле result.warehouses[].id или result.partners_warehouses[].id. При создании склада: POST /gw/timeslots/api/v1/warehouse, поле result.warehouse.id. Используйте неудалённый склад, доступный для выбранной операции. Фильтр применяется к броням и точкам заказов.
Идентификатор площадки склада. Источник: GET /gw/timeslots/api/v1/terminal, поле result.terminals[].id или result.partners_terminals[].id. Выберите площадку с warehouse, равным ID склада, и deleted=false. При создании склада ID площадок возвращаются в result.terminals[].id. Фильтр применяется только к броням.
Дата прибытия от, включительно. Без неё выбираются брони за последние 365 дней.
Дата прибытия до, включительно; применяется только вместе с date_from.
Дата отбытия до, включительно; только для броней.
Время прибытия от, включительно; только для броней.
Время отбытия до, включительно; только для броней.
Идентификатор сделки; применяется к броням и точкам заказов.
Порядковый номер точки заказа; применяется к обоим спискам.
1- Загрузка2- Разгрузка
approved- Подтвержденоdecline- Отклоненоawait_reaction- Ожидает подтверждения от владельца складаawait_client- Ожидает подтверждения от владельца брони
Идентификатор бронирования; не ограничивает список точек без брони.
Идентификатор точки заказа; применяется к обоим спискам.
В /timeslots/my не возвращать точки без брони. Не включайте вместе с only_order_points_without_slots: оба списка будут пустыми.
В /timeslots/my не возвращать брони; вернуть только точки без брони.
Фильтр броней по истечению срока в локальном времени склада. null — без фильтра.
Признак успешного выполнения запроса.
400 Некорректный фильтр.
Ошибка запроса с подробностями по отдельным полям.
Машиночитаемый код ошибки.
Описание причины ошибки.
Ошибки отдельных полей запроса.
Машиночитаемый код ошибки.
Описание причины ошибки.
403 Контекст пользователя отсутствует или некорректен.
Ошибка API: код и причина.
Машиночитаемый код ошибки.
Описание причины ошибки.
503 ФС недоступен.
Ошибка API: код и причина.
Машиночитаемый код ошибки.
Описание причины ошибки.
Поучение количества бронирований в статусе await_reaction
Возвращается количество бронирований в статусе await_reaction для каждого склада пользователя.
Получает количество бронирований в статусе await_reaction. Возвращает количество ожидающих реакции бронирований по каждому переданному складу. Для склада без таких бронирований возвращает ноль. post /gw/timeslots/api/v1/timeslots/counters
Склады, для которых требуется количество ожидающих реакции бронирований.
Идентификаторы складов, для которых нужен расчёт.
curl 'https://api.ati.su/gw/timeslots/api/v1/timeslots/counters' \ -X 'POST' \ -H 'Authorization: Bearer {authorizationToken}' \ -H 'Content-Type: application/json' \ --data-raw '{"warehouse_ids":[101,205]}'Процедура ВыполнитьHTTPЗапрос(МетодЗапроса, АдресХоста, АдресРесурса, ТекстЗапроса) Экспорт ЗаголовкиHTTP = Новый Соответствие(); ЗаголовкиHTTP.Вставить("Accept", "application/json"); ЗаголовкиHTTP.Вставить("Content-Type", "application/json"); ЗаголовкиHTTP.Вставить("Authorization", "Bearer {authorizationToken}"); HTTPЗапрос = Новый HTTPЗапрос(АдресРесурса, ЗаголовкиHTTP); HTTPЗапрос.УстановитьТелоИзСтроки(ТекстЗапроса, КодировкаТекста.UTF8, ИспользованиеByteOrderMark.НеИспользовать); ЗащищенноеСоединениеSSL = Новый ЗащищенноеСоединениеOpenSSL(Новый СертификатКлиентаWindows, Новый СертификатыУдостоверяющихЦентровWindows);
Соединение = Новый HTTPСоединение(АдресХоста,,,,,, ЗащищенноеСоединениеSSL);
Попытка Ответ = Соединение.ВызватьHTTPМетод(МетодЗапроса, HTTPЗапрос); Сообщить("Код ответа: " + Ответ.КодСостояния); Сообщить("Ответ: " + Ответ.ПолучитьТелоКакСтроку("UTF-8")); Исключение Сообщить("Ошибка выполнения запроса!" + Символы.ПС + ОписаниеОшибки()); КонецПопытки;КонецПроцедуры
ВыполнитьHTTPЗапрос("POST", "https://api.ati.su", "/gw/timeslots/api/v1/timeslots/counters", "{""warehouse_ids"":[101,205]}"); 200 Количество бронирований по складам.
Количество ожидающих реакции бронирований по складам.
Признак успешного выполнения запроса.
Количество бронирований по складам: ключ — идентификатор склада в строковом JSON-представлении, значение — количество.
400 Некорректный запрос.
Ошибка API: код и причина.
Машиночитаемый код ошибки.
Описание причины ошибки.
403 Контекст пользователя отсутствует или некорректен.
Ошибка API: код и причина.
Машиночитаемый код ошибки.
Описание причины ошибки.
Получение истории изменений бронирования
Возвращается история изменения бронирования
Получает историю изменений бронирования. Доступна владельцу бронирования или склада. Само участие в заказе доступа не даёт. Отсутствующая или удалённая бронь — 404; чужая — 403. Шаги идут от новых к старым и объединяют изменения с одинаковыми временем и автором. Время возвращается со смещением склада. Пустая история — history_changes: []. created/updated/deleted описывают добавление, изменение и удаление значений полей. old_value/new_value — строка, число, null либо объект вложения для attached_files. Системное событие timeslot_created может содержать два null. get /gw/timeslots/api/v1/timeslots/history/{timeslot_id}
| Параметр | Тип | Расположение | Описание |
|---|---|---|---|
timeslot_id
обязательный
| integer | path | ID бронирования из GET /api/v1/timeslots/my или GET /api/v1/timeslots/schedule. Пример: 101 |
curl 'https://api.ati.su/gw/timeslots/api/v1/timeslots/history/{timeslot_id}' \ -X 'GET' \ -H 'Authorization: Bearer {authorizationToken}' \ -H 'Content-Type: application/json'Процедура ВыполнитьHTTPЗапрос(МетодЗапроса, АдресХоста, АдресРесурса, ТекстЗапроса) Экспорт ЗаголовкиHTTP = Новый Соответствие(); ЗаголовкиHTTP.Вставить("Accept", "application/json"); ЗаголовкиHTTP.Вставить("Content-Type", "application/json"); ЗаголовкиHTTP.Вставить("Authorization", "Bearer {authorizationToken}"); HTTPЗапрос = Новый HTTPЗапрос(АдресРесурса, ЗаголовкиHTTP); HTTPЗапрос.УстановитьТелоИзСтроки(ТекстЗапроса, КодировкаТекста.UTF8, ИспользованиеByteOrderMark.НеИспользовать); ЗащищенноеСоединениеSSL = Новый ЗащищенноеСоединениеOpenSSL(Новый СертификатКлиентаWindows, Новый СертификатыУдостоверяющихЦентровWindows);
Соединение = Новый HTTPСоединение(АдресХоста,,,,,, ЗащищенноеСоединениеSSL);
Попытка Ответ = Соединение.ВызватьHTTPМетод(МетодЗапроса, HTTPЗапрос); Сообщить("Код ответа: " + Ответ.КодСостояния); Сообщить("Ответ: " + Ответ.ПолучитьТелоКакСтроку("UTF-8")); Исключение Сообщить("Ошибка выполнения запроса!" + Символы.ПС + ОписаниеОшибки()); КонецПопытки;КонецПроцедуры
ВыполнитьHTTPЗапрос("GET", "https://api.ati.su", "/gw/timeslots/api/v1/timeslots/history/{timeslot_id}"); 200
Успешный ответ.
Результат выполнения запроса.
Шаги истории от новых к старым.
Время изменения с часовым смещением склада.
Автор изменения.
Имя контакта ФС, подпись неизвестного контакта или системного редактора.
Изменения, объединённые по времени и редактору.
Добавленные значения.
Изменение одного поля.
action_type- action_typeapprove_status- approve_statusattached_files- attached_filesbody_type- body_typecar_brand- car_brandcar_capacity- car_capacitycar_loading_type- car_loading_typecar_number- car_numbercargo- cargocargo_count- cargo_countcargo_owner- cargo_ownercargo_owner_contact_name- cargo_owner_contact_namecargo_owner_contact_number- cargo_owner_contact_numbercargo_unit- cargo_unitcomment- commentcontact_id- contact_idcontact_name- contact_namecontact_phone- contact_phonedate_from- date_fromdate_to- date_toemail- emailentry_pass_signature- entry_pass_signatureexit_pass_signature- exit_pass_signaturefirm_name- firm_nameslot_owner- slot_ownerstaying_statuses- staying_statusesterminal- terminalterminal_name- terminal_nametime_from- time_fromtime_to- time_totimeslot_created- timeslot_created
Прежнее значение. Для attached_files — объект файла; для остальных полей — строка или число. Пустые строки возвращаются как null.
(nullable)
Путь к файлу.
Исходное имя файла.
Размер файла в байтах.
Новое значение того же типа; null при удалении значения.
(nullable)
Путь к файлу.
Исходное имя файла.
Размер файла в байтах.
Изменённые значения.
Изменение одного поля.
action_type- action_typeapprove_status- approve_statusattached_files- attached_filesbody_type- body_typecar_brand- car_brandcar_capacity- car_capacitycar_loading_type- car_loading_typecar_number- car_numbercargo- cargocargo_count- cargo_countcargo_owner- cargo_ownercargo_owner_contact_name- cargo_owner_contact_namecargo_owner_contact_number- cargo_owner_contact_numbercargo_unit- cargo_unitcomment- commentcontact_id- contact_idcontact_name- contact_namecontact_phone- contact_phonedate_from- date_fromdate_to- date_toemail- emailentry_pass_signature- entry_pass_signatureexit_pass_signature- exit_pass_signaturefirm_name- firm_nameslot_owner- slot_ownerstaying_statuses- staying_statusesterminal- terminalterminal_name- terminal_nametime_from- time_fromtime_to- time_totimeslot_created- timeslot_created
Прежнее значение. Для attached_files — объект файла; для остальных полей — строка или число. Пустые строки возвращаются как null.
(nullable)
Путь к файлу.
Исходное имя файла.
Размер файла в байтах.
Новое значение того же типа; null при удалении значения.
(nullable)
Путь к файлу.
Исходное имя файла.
Размер файла в байтах.
Удалённые значения.
Изменение одного поля.
action_type- action_typeapprove_status- approve_statusattached_files- attached_filesbody_type- body_typecar_brand- car_brandcar_capacity- car_capacitycar_loading_type- car_loading_typecar_number- car_numbercargo- cargocargo_count- cargo_countcargo_owner- cargo_ownercargo_owner_contact_name- cargo_owner_contact_namecargo_owner_contact_number- cargo_owner_contact_numbercargo_unit- cargo_unitcomment- commentcontact_id- contact_idcontact_name- contact_namecontact_phone- contact_phonedate_from- date_fromdate_to- date_toemail- emailentry_pass_signature- entry_pass_signatureexit_pass_signature- exit_pass_signaturefirm_name- firm_nameslot_owner- slot_ownerstaying_statuses- staying_statusesterminal- terminalterminal_name- terminal_nametime_from- time_fromtime_to- time_totimeslot_created- timeslot_created
Прежнее значение. Для attached_files — объект файла; для остальных полей — строка или число. Пустые строки возвращаются как null.
(nullable)
Путь к файлу.
Исходное имя файла.
Размер файла в байтах.
Новое значение того же типа; null при удалении значения.
(nullable)
Путь к файлу.
Исходное имя файла.
Размер файла в байтах.
Признак успешного выполнения запроса.
403 Нет контекста пользователя либо он не владелец брони или склада.
Ошибка API: код и причина.
Машиночитаемый код ошибки.
Описание причины ошибки.
404 Бронь отсутствует или удалена.
Ошибка API: код и причина.
Машиночитаемый код ошибки.
Описание причины ошибки.
503 ФС недоступен при получении авторов изменений.
Ошибка API: код и причина.
Машиночитаемый код ошибки.
Описание причины ошибки.