Skip to content
Мои токены Поддержка
Чат для вопросов по API Мгновенно ответим на ваши вопросы
api@ati.su Электронная почта техподдержки
Тикетная система Оставить заявку на отдел "Консультанты по интеграции (API)"
api.ati.su - заказы, торги, площадки Наш телеграм-канал
Для подтверждения действия введите пароль
Чтобы продолжить, введите пароль для пользователя
Отменить
For LLMs and AI agents: canonical Markdown source of this documentation page (plain-text .md — fetch this URL to use the page content in tools and RAG). For LLMs and AI agents: developers documentation index in llms.txt format — ordered list of key documentation URLs for the developers section.

OpenAPI · Markdown

Методы для работы с бронированиями

Добавление или изменение бронирования

Чтобы изменить существующее бронирования, надо передать поле id с идентификатором бронирования. Если id не передать, то будет создано новое бронирование. В ответ на запрос возвращается созданное или изменённое бронирование.

post /gw/timeslots/api/v1/timeslots
Запрос
Модель
{...}
}
Пример запроса 
curl 'https://api.ati.su/gw/timeslots/api/v1/timeslots' \
  -X 'POST' \
  -H 'Authorization: Bearer {authorizationToken}' \
  -H 'Content-Type: application/json' \
  --data-raw '{"timeslot":{"attachments":[],"terminal":35264,"gate_number":1,"action_type":"loading_unloading","comment":"Тестовый комментарий","date_from":"2023-07-04","date_to":"2023-07-04","time_from":"00:00","time_to":"00:00","warehouse":34824,"approve_status":"approved"}}'
Ответ
200 Возвращаются актуальные данные созданного или измененного склада
Модель
{...}
ok: boolean
}
Пример
{...}
"ok":true,
"result":{...}
"timeslot":{...}
"id":12429,
"time_from":"00:00",
"time_to":"00:00",
"warehouse_info":{...},
"id":34824,
"name":"Тестовый склад",
"address":"Гельсингфорсская улица, 2А",
"city_verbose":"Санкт-Петербург, РФ",
"utc_offset":180,
"owner":4022713
},
"attached_files":[],
"can_be_edited":true,
"is_expired":true,
"timeslot_readable_id":"34824-12429",
"approve_status":"approved",
"action_type":"loading_unloading",
"slot_owner":4022713,
"contact_id":0,
"email":"",
"contact_name":null,
"contact_phone":"",
"country_phone_id":"",
"gate_number":1,
"car_number":null,
"car_capacity":null,
"body_type":null,
"cargo":"",
"cargo_count":null,
"cargo_unit":"",
"cargo_owner":"",
"cargo_owner_contact_name":"",
"cargo_owner_contact_number":"",
"comment":"Тестовый комментарий",
"firm_name":"",
"date_from":"2023-07-04",
"date_to":"2023-07-04",
"date_creation":"2023-07-04T08:29:44.939037+03:00",
"date_modified":"2023-07-04T08:29:44.939059+03:00",
"deleted":false,
"is_test":true,
"warehouse":34824,
"terminal":35264,
"order_point":null,
"warehouse_name":"Тестовый склад",
"terminal_name":"Тестовая площадка"
}
}
}
400 Ошибка валидации. Возникает, когда в какое-то из полей передано недопустимое значение
Модель
ANY-OF
Пример
{...}
"error":"multiple_errors",
"error_list":[...],
{...},
"error":"time_to",
"reason":"Неправильный формат времени. Используйте один из этих форматов: hh:mm."
},
{...}
"error":"approve_status",
"reason":"Значения test нет среди допустимых вариантов."
}
],
"reason":"invalid"
}

Получение существующих бронирований и точек заказа без брони

Возвращается список существующих бронирований и точек заказа, для которых бронирования ещё не созданы. Запрашивающий пользователь должен быть создателем бронирования, или владельцем груза (из заказа), или перевозчиком (из заказа).

get /gw/timeslots/api/v1/timeslots/my
Запрос
Пример запроса 
curl 'https://api.ati.su/gw/timeslots/api/v1/timeslots/my' \
  -X 'GET' \
  -H 'Authorization: Bearer {authorizationToken}' \
  -H 'Content-Type: application/json'
Ответ
200 Возвращаются все бронирования и точки заказа без бронирований
Модель
{...}
ok: boolean
}
Пример
{...}
"lol":{...}
"kek":1
}
}

Получение существующих бронирований фирмы

Возвращается список существующих бронирований. Идентификатор фирмы передается в path. Также с помощью query параметров можно передать фильтры.

get /gw/timeslots/api/v1/timeslots/{ati_id}
Запрос
Пример запроса 
curl 'https://api.ati.su/gw/timeslots/api/v1/timeslots/{ati_id}' \
  -X 'GET' \
  -H 'Authorization: Bearer {authorizationToken}' \
  -H 'Content-Type: application/json'
Ответ
200 Возвращается информация бронированиях с учетом фильтров
Модель
{...}
ok: boolean
}
Пример
{...}
"ok":true,
"result":{...}
"count":1,
"time_slots":[...],
{...}
"id":12429,
"time_from":"00:00",
"time_to":"00:00",
"warehouse_info":{...},
"id":34824,
"name":"Тестовый склад",
"address":"Гельсингфорсская улица, 2А",
"city_verbose":"Санкт-Петербург, РФ",
"utc_offset":180,
"owner":4022713
},
"staying_statuses_history":[...],
{...}
"status_name":"Ожидается",
"date_start":"2023-07-04T08:29:44.946522+03:00",
"date_end":null,
"staying_status":173845,
"timeslot":12429,
"comment":"",
"color":"rgb(219, 169, 46)"
}
],
"attached_files":[],
"can_be_edited":true,
"is_expired":true,
"timeslot_readable_id":"34824-12429",
"approve_status":"approved",
"action_type":"loading_unloading",
"slot_owner":4022713,
"contact_id":0,
"email":"",
"contact_name":null,
"contact_phone":"",
"country_phone_id":"",
"gate_number":1,
"car_number":null,
"car_capacity":null,
"body_type":null,
"cargo":"",
"cargo_count":null,
"cargo_unit":"",
"cargo_owner":"",
"cargo_owner_contact_name":"",
"cargo_owner_contact_number":"",
"comment":"Тестовый комментарий",
"firm_name":"",
"date_from":"2023-07-04",
"date_to":"2023-07-04",
"date_creation":"2023-07-04T08:29:44.939037+03:00",
"date_modified":"2023-07-04T08:29:44.939059+03:00",
"deleted":false,
"is_test":true,
"warehouse":34824,
"terminal":35264,
"order_point":null,
"warehouse_name":"Тестовый склад",
"terminal_name":"Тестовая площадка"
}
],
"accounts":{...},
"4022713":{...}
"firm_type":"Экспедитор",
"firm_id":4022713,
"account_id":"4022713",
"full_firm_name":"JtNEFfon8443, ИП",
"firm_name":"JtNEFfon8443",
"brand":null,
"location":{...},
"city_id":1,
"region_id":153,
"country_id":1,
"full_name":"Санкт-Петербург, Санкт-Петербург (регион), Россия",
"short_name":"Санкт-Петербург",
"is_regional_center":true,
"city_size":6,
"fias_id":"c2deb16a-0330-4f05-821f-1d09c93331e6",
"attributes":2052,
"city_name":"Санкт-Петербург",
"region_name":"Санкт-Петербург (регион)",
"country_name":"Россия",
"country_code_name":"RUS"
},
"passport":{...},
"ati_id":"4022713",
"total_score":0,
"ati_data_match_point":0,
"account_lifetime_point":0,
"business_activity_point":0,
"round_table_point":0,
"claim_point":0,
"prof_activity_point":0,
"ati_administration_point":0,
"clones_point":0,
"egr_point":0,
"mass_registration_point":0,
"mass_founder_point":0,
"firm_lifetime_point":0,
"guaranteed_payment_point":0,
"virtual_account_debts_point":0,
"bad_partner_mentions_point":0,
"ri_users_attributes":100380,
"recommendations_count":0,
"status":2,
"status_description":"Отсутствует балл "Аккаунт подтвержден" или cумма любых красных баллов меньше или равна 1",
"negative_points_sum":0
},
"contacts":[...]
{...},
"id":2,
"name":"contact"
},
{...}
"id":0,
"name":"director"
}
]
}
},
"timeslot_filters":{...}
"timeslot_id":null,
"order_point_id":null,
"only_timeslots":false,
"only_order_points_without_slots":false
}
}
}
400 Фирма не найдена
Модель
{...}

Одиночная ошибка

error: string

Текстовый код ошибки

reason: string

Человекочитаемый текст ошибки

}
Пример
{...}
"error":"bad_request",
"reason":"Фирма не найдена"
}

Поучение количества бронирований в статусе await_reaction

Возвращается количество бронирований в статусе await_reaction для каждого склада пользователя.

post /gw/timeslots/api/v1/timeslots/counters
Запрос
Модель
{...}
warehouse_ids*: [integer]

Идентификатор склада во Временных окнах

}
Пример запроса 
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":[34824]}'
Ответ
200 Возвращаются количество бронирований пользователей в статусе await_reaction в переданных складах
Модель
{...}
ok: boolean
}
Пример
{...}
"ok":true,
"result":{...}
"34824":0
}
}
400 Ошибка валидации. Возникает, когда в какое-то из полей передано недопустимое значение
Модель
{...}

Одиночная ошибка

error: string

Текстовый код ошибки

reason: string

Человекочитаемый текст ошибки

}
Пример
{...}
"error":"bad_request",
"reason":"warehouse_ids должен содержать айдишники складов",
"details":null
}

Получение истории изменений бронирования

Возвращается история изменения бронирования

get /gw/timeslots/api/v1/timeslots/history/{timeslot_id}
Запрос
Пример запроса 
curl 'https://api.ati.su/gw/timeslots/api/v1/timeslots/history/{timeslot_id}' \
  -X 'GET' \
  -H 'Authorization: Bearer {authorizationToken}' \
  -H 'Content-Type: application/json'
Ответ
200 Возвращается история изменений бронирования
Модель
{...}
ok: boolean
}
Пример
{...}
"ok":true,
"result":{...}
"history_changes":[...]
{...},
"iso_warehouse_local_datetime":"2023-07-05T08:19:13.132092+03:00",
"editor_info":{...},
"name":"director"
},
"changes":{...}
"created":[],
"updated":[...],
{...}
"field":{...}
"name":"comment",
"old_value":"Тестовый комментарий",
"new_value":"Измененный комментарий"
}
}
],
"deleted":[]
}
},
{...}
"iso_warehouse_local_datetime":"2023-07-04T08:29:44.939059+03:00",
"editor_info":{...},
"name":"director"
},
"changes":{...}
"created":[...],
{...},
"field":{...}
"name":"timeslot_created",
"old_value":null,
"new_value":null
}
},
{...}
"field":{...}
"name":"staying_statuses",
"old_value":null,
"new_value":[...]
"Ожидается"
]
}
}
],
"updated":[],
"deleted":[]
}
}
]
}
}
404 Бронирование не найдено
Модель
{...}

Одиночная ошибка

error: string

Текстовый код ошибки

reason: string

Человекочитаемый текст ошибки

}
Пример
{...}
"error":"not_found",
"reason":"Timeslot not found"
}