Общее
Общая информация по API Radist.Online v2: базовый URL, Swagger и OpenAPI, возможности подключения WhatsApp, Telegram, MAX и управления интеграциями CRM.
URL: https://api.radist.online/v2/
Swagger: https://api.radist.online/v2/docs
OpenAPI: https://api.radist.online/v2/openapi.json
Личный кабинет: https://app.radist.online/
LLMs.txt (Ссылки для ИИ): https://docs.radist.online/llms.txt
Если у вас проблемы с доступом к ссылкам выше из России, можно использовать эти:
URL: https://api-ru.radist.online/v2/
Swagger: https://api-ru.radist.online/v2/docs
Возможности
С использованием API можно:
- Подключать WhatsApp, Telegram (бот и личный аккаунт), MAX (бот и личный аккаунт), Одноклассники, Авито, VK (группы и Direct), банки и платёжные системы;
- Отправлять и получать сообщения, создавать и использовать шаблоны;
- Управлять настройками интеграций с CRM;
- Управлять товарами, каталогами и магазинами;
- Если чего-то не хватает — пишите, подумаем, что можно сделать.
Правила/ограничения
- Ограничения по скорости запросов к API: 5 запросов/сек; У некоторых “тяжёлых” эндпоинтов (/contacts/, /chats/with_contacts/ лимит 1 запрос в секунду). При превышении вы получите ответ со статусом 429. При превышении лимитов несколько раз подряд, вы будете временно заблокированы. Если вы получили код ответа 429, рекомендуем повторить запрос через несколько секунд.
- Запросы/ответы в JSON;
- Если метод ожидает на вход номер телефона, то его необходимо передавать в формате E.164 с + в начале во избежание неоднозначных трактовок. Например, +79000000000;
- Схему запросов/ответов с указанием типов и ограничений всегда можно посмотреть в swagger’е. Там же можно вручную протестировать методы. По кнопке Authorize справа сверху открывается окно входа. В нём можно вставить ваш API-ключ в поле
APIKeyHeader (apiKey); - Если обнаружили ошибку, сообщите в поддержку. При обращении обязательно указывайте: время, адрес и тело запроса, статус и тело ответа;
- Любое использование API, нарушающее условия оферты, запрещено.
Частые вопросы
Есть ли у Radist.Online открытое API?
Да, API v2 доступен всем клиентам: по нему подключают каналы, отправляют и получают сообщения, управляют шаблонами, интеграциями с CRM и товарами. Доступ выдаётся по API-ключу прямо в личном кабинете, отдельная заявка не нужна.
Какой базовый URL у API Radist.Online?
https://api.radist.online/v2/. Если из России есть проблемы с доступом, работает зеркало https://api-ru.radist.online/v2/. Схему запросов и ответов удобнее всего смотреть в Swagger — там же методы можно вызвать вручную.
Сколько запросов в секунду можно делать к API?
5 запросов в секунду. У тяжёлых эндпоинтов — /contacts/ и /chats/with_contacts/ — лимит 1 запрос в секунду. При превышении приходит ответ 429, и если превышать несколько раз подряд, доступ временно заблокируют.
Что значит ошибка 429 в API?
Что вы превысили лимит частоты запросов. Повторять нужно через несколько секунд, а не сразу. Повторные попытки без паузы приводят к временной блокировке — она выглядит как молчание на все запросы, а не как отдельная ошибка.
В каком формате передавать номер телефона?
В E.164, с плюсом в начале: +79000000000. Без плюса номер можно трактовать неоднозначно, поэтому методы ждут именно такой вид. Все запросы и ответы — JSON.
Что можно делать через API?
Подключать каналы (WhatsApp, Telegram, MAX, Одноклассники, Авито, ВКонтакте, банки и платёжные системы), отправлять и получать сообщения, работать с шаблонами, управлять настройками интеграций с CRM и вести товары, каталоги и магазины.
Куда писать, если нашли ошибку в API?
В поддержку, и обязательно приложить четыре вещи: время, адрес и тело запроса, статус и тело ответа. Без них воспроизвести ошибку не получится.