Основы
Ключи, адреса, идентификаторы, ошибки, лимиты и как проходят сообщения
- Каналы и ключиКанал без номера и привязанный, ключ API канала, перевыпуск и отзыв, смена номера, сроки оплаты.
- Адрес и авторизацияДве формы адреса запроса, методы HTTP, тело запроса, пределы на размер и частоту.
- Идентификаторы чатов и сообщенийКак выглядят chatId и idMessage в каждом канале, номер телефона вместо chatId, ключи событий.
- Как проходят сообщения и уведомленияСхемы потоков — входящее сообщение, отправка и статусы, сообщения с телефона, правки и реакции, обрыв связи и догон.
- Ответы и ошибкиФормат ответа, коды HTTP и поле code, когда повторять запрос, отказы групповых методов.
- Темп и лимитыКак Gratio сглаживает запросы к мессенджеру, какие пределы действуют в каждом канале и как вести рассылки.
- Надёжная отправка без дублейКлюч clientMessageId, повтор после тайм-аута, неизвестный исход отправки и статус failed.
- Файлы и ссылки на нихГде хранятся файлы сообщений, как устроены ссылки downloadUrl и urlFile, какие типы и размеры принимаются.
- Возможности каналовМетод getCapabilities и сводная таблица — что умеет каждый канал.
- Переход с Green APIЧто поменять в приложении на Green API, чем Gratio отличается и что в нём есть сверх Green.