Skip to content
Для ИИ NEW Мои токены Поддержка
Чат для вопросов по 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

Поиск грузов на площадках

Метод возвращает грузы с закрытых площадок, к которым у контакта есть доступ. Биржа ATI.SU в поиск не входит. Для запроса нужен токен API ATI.SU.

Если board_ids не передан или пустой, поиск идёт по всем закрытым площадкам контакта. Чтобы выбрать несколько площадок, повторите параметр: board_ids=644bdc87dbd6fc3747887c7b&board_ids=644bdc87dbd6fc3747887c7c.

Пагинация

Ответ содержит массив cargos и общее число грузов total. Параметр take задаёт размер страницы от 1 до 100, по умолчанию 100; skip — число пропускаемых грузов, по умолчанию 0.

Запрос с skip=0 создаёт снимок выдачи на 15 минут. Следующие страницы запрашивайте с теми же фильтрами, увеличивая skip на take. Снятый с площадок груз может выпасть из страницы, поэтому короткая страница сама по себе не означает конец выдачи. Сумма skip + take не должна превышать 10 000; для более глубокой выдачи сузьте поиск через updated_since или board_ids.

Переход с byboards

Новый метод заменяет GET /v1.0/loads/search/byboards. При переходе измените адрес запроса, параметры и обработку ответа:

  • Используйте board_ids вместо boardIds. Старое имя новый метод игнорирует, что приведёт к поиску по всем закрытым площадкам контакта.
  • Читайте грузы из cargos, а число результатов — из total; загружайте следующие страницы через skip и take.
  • Модель груза основана на вебхуке cargoes.on_boards. Даты погрузки и разгрузки передаются как YYYY-MM-DD; поля со значением null отсутствуют. Модель отличается от ответа прежнего метода, поэтому одной замены URL недостаточно.
  • Id торгов находится в payment.auction_id при payment.type=auction вместо прежнего AuctionID.
Возвращает страницу грузов с закрытых площадок контакта в модели вебхука cargoes.on_boards. API для интеграции. Ищет грузы на закрытых площадках, к которым у контакта есть доступ; Биржа ATI.SU в поиск не входит. Авторизация — токен API ATI.SU: https://ati.su/developers/auth/auth/. Порядок выдачи: сначала грузы только с закрытых площадок, затем по added_at от новых к старым. Запрос с skip = 0 ищет заново и запоминает выдачу на 15 минут; запросы с skip > 0 листают запомненную выдачу. Груз, снятый с площадок между запросами, из страницы выпадает, поэтому страница бывает короче take. skip + take — не больше 10 000: дальше выдачу сужают через updated_since или board_ids. Модель груза основана на вебхуке cargoes.on_boards. Отличия: даты погрузки и разгрузки — YYYY-MM-DD, у промежуточных точек нет organization; поля со значением null не пишутся.
get /gw/search_loads/integration/v1/loads/search/by-boards
Параметры
Параметр Тип Расположение Описание
board_ids string[] query
Id закрытых площадок контакта, 24 шестнадцатеричных символа. Параметр повторяется: board_ids=644bdc87dbd6fc3747887c7b&board_ids=644bdc87dbd6fc3747887c7c. Не передан или пустой — поиск по всем закрытым площадкам контакта. В /v1.0/loads/search/byboards параметр назывался boardIds; неизвестные параметры метод не проверяет, а пропускает. Остальные параметры передаются один раз Пример: ["644bdc87dbd6fc3747887c7b"]
updated_since string (date-time) query
Отбирает грузы с updated_at не раньше этого момента. ISO 8601 с часовым поясом, например 2026-09-28T07:00:00.000Z. Смещение передавайте с экранированным плюсом (%2B03:00): неэкранированный «+» в query string читается как пробел. Время без часового пояса метод отклоняет с ошибкой 400 Пример: 2026-09-28T07:00:00.000Z
skip integer | string (int32) query
Сколько грузов выдачи пропустить, от 0. По умолчанию 0. skip + take — не больше 10 000: дальше выдачу сужают через updated_since или board_ids Пример: 0
take integer | string (int32) query
Сколько грузов вернуть, от 1 до 100. По умолчанию 100 Пример: 100
Запрос
Пример запроса 
curl 'https://api.ati.su/gw/search_loads/integration/v1/loads/search/by-boards' \
  -X 'GET' \
  -H 'Authorization: Bearer {authorizationToken}' \
  -H 'Content-Type: application/json'
Ответ
200 Страница грузов и общее число грузов в выдаче.
Модель
{...}

Страница выдачи поиска грузов по закрытым площадкам

total*: int32

Число грузов во всей выдаче, а не на странице

}
Пример
{...}
"cargos":[...],
{...}
"cargo_id":"3fa85f64-5717-4562-b3fc-2c963f66afa6",
"cargo_number":"ABC1234",
"added_at":"2026-09-28T07:00:00.123+00:00",
"updated_at":"2026-09-28T09:15:30.25+00:00",
"refreshed_at":"2026-09-28T10:00:00+00:00",
"persistent_user_id":1234567,
"ati_id":1234567,
"route":{...},
"loading":{...},
"city_id":3611,
"address":"ул. Ленина, д. 10",
"coordinates":{...},
"longitude":37.6173,
"latitude":55.7558
},
"organization":{...},
"name":"ООО Транспорт",
"ownership":3
},
"near_cities":[...],
0
],
"dates":{...},
"type":"ready",
"is_available_tomorrow":false,
"time":{...},
"type":"bounded",
"start":"08:00:00",
"end":"18:00:00",
"offset":"03:00:00"
},
"first_date":"2026-09-28",
"last_date":"2026-09-30"
},
"cargos":[...]
{...}
"name_id":112,
"name":"Трубы",
"packaging":{...},
"type":2,
"quantity":20
},
"cargo_id":1,
"weight":{...},
"type":"tons",
"quantity":20
},
"volume":{...},
"quantity":82
},
"sizes":{...}
"length":{...},
"value":13.6,
"is_highlighted":false
},
"height":{...},
"value":13.6,
"is_highlighted":false
},
"width":{...},
"value":13.6,
"is_highlighted":false
},
"diameter":1.2
}
}
]
},
"unloading":{...},
"city_id":1,
"address":"ул. Ленина, д. 10",
"coordinates":{...},
"longitude":37.6173,
"latitude":55.7558
},
"organization":{...},
"name":"ООО Транспорт",
"ownership":3
},
"near_cities":[...],
0
],
"dates":{...}
"first_date":"2026-09-28",
"last_date":"2026-09-30",
"time":{...}
"type":"bounded",
"start":"08:00:00",
"end":"18:00:00",
"offset":"03:00:00"
}
}
},
"way_points":[...],
{...}
"type":"loading",
"cargos":[...],
{...}
"name_id":112,
"name":"Трубы",
"packaging":{...},
"type":2,
"quantity":20
},
"cargo_id":1,
"weight":{...},
"type":"tons",
"quantity":20
},
"volume":{...},
"quantity":82
},
"sizes":{...}
"length":{...},
"value":13.6,
"is_highlighted":false
},
"height":{...},
"value":13.6,
"is_highlighted":false
},
"width":{...},
"value":13.6,
"is_highlighted":false
},
"diameter":1.2
}
}
],
"loading_date":{...},
"first_date":"2026-09-28",
"last_date":"2026-09-30",
"time":{...}
"type":"bounded",
"start":"08:00:00",
"end":"18:00:00",
"offset":"03:00:00"
}
},
"city_id":3611,
"address":"ул. Ленина, д. 10",
"coordinates":{...},
"longitude":37.6173,
"latitude":55.7558
},
"catalogs_organization":{...}
"name":"ООО Транспорт",
"ownership":3
}
}
],
"is_round_trip":false
},
"truck":{...},
"trucks_count":1,
"load_type":"ftl",
"body_types":[...],
0
],
"body_loading":{...},
"types":[...],
0
],
"is_all_required":false
},
"body_unloading":{...},
"types":[...],
0
],
"is_all_required":false
},
"temperature":{...},
"from":-18,
"to":-15
},
"documents":{...},
"tir":false,
"cmr":true,
"t1":false,
"medical_card":false
},
"requirements":{...},
"logging_truck":false,
"road_train":false,
"air_suspension":false,
"team_driving":false
},
"adr":3,
"belts_count":4,
"is_tracking":true,
"required_capacity":20
},
"payment":{...},
"type":"auction",
"auction_id":"3fa85f64-5717-4562-b3fc-2c963f66afa6",
"direct_offer":false,
"prepayment":{...},
"percent":30,
"using_fuel":false
},
"payment_mode":{...}
"type":"delayed-payment",
"payment_delay_days":5
}
},
"documents":[...],
{...}
"id":"644bdc87dbd6fc3747887c7b",
"name":"ТТН",
"link":"https://files.example.com/documents/ttn.pdf"
}
],
"boards":[...],
{...}
"id":"644bdc87dbd6fc3747887c7b",
"reservation_enabled":true
}
],
"note":"Нужен гидроборт",
"contacts":[...],
0
],
"distance":715,
"offer_count":3
}
],
"total":154
}
400 Некорректный или повторённый параметр запроса — ошибка validation_errors. Коды по параметрам: invalid_board_id, invalid_skip, invalid_take, skip_too_deep, invalid_updated_since, duplicate_query_parameter.
Модель
{...}

Ошибка интеграторского метода: код, описание и при необходимости список ошибок по параметрам или подробности

error*: null,string

Код ошибки: validation_errors, unauthorized, search_forbidden, access_denied, boards_access_denied, unknown_server_error

reason*: null,string

Описание ошибки для человека

}
Пример
{...}
"error":"validation_errors",
"reason":"Некорректные параметры запроса",
"error_list":[...],
{...}
"error":"invalid_take",
"reason":"take должен быть от 1 до 100"
}
],
"details":{...}
"board_ids":[...]
"string"
]
}
}
403 search_forbidden или access_denied — фирма заблокирована; boards_access_denied — в board_ids есть Биржа ATI.SU или площадка, недоступная контакту.
Модель
{...}

Ошибка интеграторского метода: код, описание и при необходимости список ошибок по параметрам или подробности

error*: null,string

Код ошибки: validation_errors, unauthorized, search_forbidden, access_denied, boards_access_denied, unknown_server_error

reason*: null,string

Описание ошибки для человека

}
Пример
{...}
"error":"validation_errors",
"reason":"Некорректные параметры запроса",
"error_list":[...],
{...}
"error":"invalid_take",
"reason":"take должен быть от 1 до 100"
}
],
"details":{...}
"board_ids":[...]
"string"
]
}
}