# ATI.SU

Биржа грузоперевозок — грузы, заказы, торги, машины, фирмы, площадки, мессенджер, АТИ-Доки (ЭДО), вебхуки, тайм-слоты, индекс ставок

## Сценарии

### Рейсы без перевозчика
Агент пройдёт по вашим грузам и заказам на бирже и покажет, какие рейсы до сих пор висят без перевозчика и сколько времени.

### Ставки против индекса
Агент сверит ставки в ваших заказах с индексом ATI.SU по направлению и назовёт маршруты, где вы платите заметно выше рынка.

### Сводка по торгам и откликам
Агент соберёт утреннюю сводку по торгам и новым откликам перевозчиков, чтобы биржу не приходилось обновлять вручную.

### Проверка фирмы перед рейсом
Агент поднимет карточку фирмы в справочнике ATI.SU, покажет её машины и площадки — по ним вы решаете, отдавать ли рейс.

## Как подключить

### Войдите под контактом фирмы, которой нужен доступ
Токен привязан к контакту и к фирме и перестаёт работать при смене пароля, удалении контакта или удалении фирмы. Аккаунт на ATI.SU должен быть зарегистрирован и подтверждён заранее.

### Откройте раздел «Мои токены»
Портал для разработчиков ati.su/developers/tokens/ → «Мои токены». Таблица «Ваши access_token» показывает столбцы «Приложение», «Client_id», «Токен» и дату окончания срока.

### Для проверки нажмите «Создать временный токен»
Кнопка выдаёт токен приложения api-panda-portal без единого поля. Срок жизни — 7 дней: хватит убедиться, что методы отвечают, но для постоянной работы нужен второй тип токена.

### Запросите client_id у консультантов по интеграциям
Постоянный токен создаётся только по client_id. Заведите тикет или напишите на api@ati.su: имя и почта сотрудника, название продукта и цель использования API. client_id выдаётся один на продукт.

### Впишите client_id и нажмите «Создать токен»
Новый токен появится строкой в списке — скопируйте значение из столбца «Токен». В запросах он уходит заголовком Authorization: Bearer.

## Частые вопросы

### Как подключить ATI.SU?
API-токеном: на портале ati.su/developers/tokens/ в разделе «Мои токены» кнопка «Создать временный токен» даёт ключ на 7 дней для проверки, а для постоянной работы client_id запрашивается на api@ati.su. Значение из столбца «Токен» вставляется в поле токена.

### Что агент видит в ATI.SU?
Грузы, заказы, торги, машины, фирмы и площадки, переписку в мессенджере биржи, документы АТИ-Доки и индекс ставок — в пределах прав аккаунта, чей токен подключён.

### Пишет ли агент в ATI.SU?
По умолчанию агент читает биржу и отвечает в чате. Права токена наследуются от аккаунта: если доступа к разделу нет, агент прямо скажет, чего не хватает, вместо непонятной ошибки.

### Есть ли ограничения по запросам?
Обращения идут не чаще 10 запросов в секунду, поэтому большие выгрузки агент собирает частями. Временный токен живёт 7 дней — после этого подключение нужно обновить постоянным.

[Открыть ATI.SU](https://ati.su/developers/tokens/)