Перейти к содержанию

Использование хостов GREEN API#

Для выполнения запросов HTTP API на сервера GREEN API требуется использовать параметры указанные в настройках Вашего инстанса в личном кабинете:

  • apiUrl - ссылка на хост GREEN API для выполнения методов
  • mediaUrl - ссылка на хост GREEN API для отправки файлов (методы UploadFile, SendFileByUpload)
  • idInstance - уникальный номер Вашего инстанса
  • apiTokenInstance - ключ доступа Вашего инстанса

При выполнении запросов с параметрами из личного кабинета гарантирует минимальное время выполнения запроса и высокую вероятность успешного выполнения запроса.

  1. Изменение хоста на партнерском аккаунте
  2. Как плавно перевести инстансы на выделенные сервера
  3. Влияние смены хоста на работу интеграции

1. Изменение хоста на партнерском аккаунте#

В случае перевода партнерского аккаунта на работу на выделенных серверах, рекомендууется постепенно перевести все текущие инстансы на новые сервера. Для этого достаточно удалить старый инстанс и создать новый. Перевод на выделенные сервера осуществляется для более стабильной работы системы.

При переходе на выделенные сервера временно можно использовать универсальный хост для работы старых и новых инстансов.

  • Универсальный хост: https://api.green-api.com
  • Универсальный медиа-хост для отправки файлов: https://media.green-api.com

В дальнейшем при переходе на новые инстансы на выделенных серверах, следует изменить хост на указанный в личном кабинете, для уменьшения времени ответа АПИ и уменьшения вероятности появления проблем с доступностью.

2. Как плавно перевести инстансы на выделенные сервера#

Ограничения по срокам перехода на новые инстансы на выделенных серверах отсутствуют.

При возникновении необходимости сменить инстанс можно использовать моменты, когда инстанс становится неавторизованным, например:

  1. Когда клиент отвязывает устройство
  2. Если клиент переходит с тарифа Бизнес на партнерскую тарификацию, при удалении инстансов Бизнес
  3. Когда инстансы разлогиниваются автоматически;

Следует сообщить клиентам о необходимости перепривязать устройство для более стабильной работы.

Вы можете отслеживать статус инстанса через получение уведомлений при включенной настройки stateWebhook или используя метод GetStateInstance.

3. Влияние смены хостов на работу интеграции#

Использование не предназначенного для инстанса хоста может сломать работу интеграции, требуется при работе в переходный период временно использовать универсальные хосты.
Перевод инстансов на выделенные сервера и смена хостов при указании временного хоста и переключении на рекомендуемый, происходит незаметно для клиентов и не влияет на работу интеграции.