Использование хостов GREEN-API#
Для выполнения запросов HTTP API на сервера GREEN API требуется использовать параметры указанные в настройках Вашего инстанса в личном кабинете:
- apiUrl - ссылка на хост GREEN API для выполнения методов
- mediaUrl - ссылка на хост GREEN API для отправки файлов (методы UploadFile, SendFileByUpload)
- idInstance - уникальный номер Вашего инстанса
- apiTokenInstance - ключ доступа Вашего инстанса
При выполнении запросов с параметрами из личного кабинета гарантирует минимальное время выполнения запроса и высокую вероятность успешного выполнения запроса.
- Изменение хоста на партнерском аккаунте
- Как плавно перевести инстансы на выделенные сервера
- Влияние смены хоста на работу интеграции
1. Изменение хоста на партнерском аккаунте#
В случае перевода партнерского аккаунта на работу на выделенных серверах, рекомендууется постепенно перевести все текущие инстансы на новые сервера. Для этого достаточно удалить старый инстанс и создать новый. Перевод на выделенные сервера осуществляется для более стабильной работы системы.
При переходе на выделенные сервера временно можно использовать универсальный хост для работы старых и новых инстансов.
- Универсальный хост:
https://api.green-api.com
- Универсальный медиа-хост для отправки файлов:
https://media.green-api.com
В дальнейшем при переходе на новые инстансы на выделенных серверах, следует изменить хост на указанный в личном кабинете, для уменьшения времени ответа АПИ и уменьшения вероятности появления проблем с доступностью.
2. Как плавно перевести инстансы на выделенные сервера#
Ограничения по срокам перехода на новые инстансы на выделенных серверах отсутствуют.
При возникновении необходимости сменить инстанс можно использовать моменты, когда инстанс становится неавторизованным, например:
- Когда клиент отвязывает устройство
- Если клиент переходит с тарифа Бизнес на партнерскую тарификацию, при удалении инстансов Бизнес
- Когда инстансы разлогиниваются автоматически;
Следует сообщить клиентам о необходимости перепривязать устройство для более стабильной работы.
Вы можете отслеживать статус инстанса через получение уведомлений при включенной настройки stateWebhook или используя метод GetStateInstance.
3. Влияние смены хостов на работу интеграции#
Использование не предназначенного для инстанса хоста может сломать работу интеграции, требуется при работе в переходный период временно использовать универсальные хосты.
Перевод инстансов на выделенные сервера и смена хостов при указании временного хоста и переключении на рекомендуемый, происходит незаметно для клиентов и не влияет на работу интеграции.