Запросы к API
Запросы к API осуществляются на адрес
https://whatsgate.ru/api/v1/<команда>
Перечень команд управления инстансом Whatsapp:
- send - отправка сообщений
- seen - делает последние сообщения в чате просмотренными для собеседника
- typing - отправляет собеседнику статус «печатает» в течение 15 с
- get-chats - запрос списка чатов
- get-media - запрос медиа-файла
- check - проверка зарегистрирован ли номер в Вотсап
- events-get - запрос входящих событий для получения входящих сообщений
Перечень команд управления сессиями:
- session-create - создание новой сессии Whatsapp
- session-delete - удаление сессии Whatsapp с выходом из авторизации
- sessions-get - получение списка сессий
- set-name - изменение имени сессии
- set-hook - установка webhook для получения входящих сообщений
Заголовки запроса
Авторизация в API производится в заголовке запроса X-Api-Key Также, обязательно наличие заголовка Content-type: application/json
X-Api-Key: YOUR_API_KEY Content-type: application/json
Тело запроса
В теле запроса передается JSON - объект, обязательным параметром которого является WhatsappID
{ "WhatsappID": "YOUR_WHATSAPP_ID", "number": "79999999999" }
Ответ на запрос
Если все прошло удачно, то в ответе на запрос будет указан код 200, в теле ответа будет находится JSON-объект. Поля JSON-объекта будут установлены в зависимости от переданной команды.
{ "result": "OK", "data": true }
При ошибке, кот ответа будет 500. Возвращаемый объект содержит следующие поля:
- name - Наименование ошибки
- message - Более подробная информация об ошибке
- code - Код ошибки
{ "name": "Unauthorized", "message": "Your request was made with invalid credentials.", "code": 0 }