GetAuthorizationCode#

Метод предназначен для авторизации инстанса по номеру телефона.
Метод используется как альтернатива методу QR.

Процесс авторизации:

На Вашем телефоне должно быть установленно оффициальное приложение WhatsApp или WhatsApp Business.
Требуется зарегистрироваться в личном кабинете и создать инстанс.
В приложении WhatsApp выберете пункт меню "Связанные устройства" -> "Привязка устройства" -> " Связать по номеру телефона".
Вызовите метод GetAuthorizationCode из личного кабинета или через коллекцию Postman, указав в теле запроса номер Вашего телефона (поле phoneNumber). В ответ на вызов метода GetAuthorizationCode вы получете 2 поля: status и code.
Введите в приложении WhatsApp полученный код, авторизация прошла успешно.

Для получения кода аккаунт должен быть в неавторизованном состоянии. Если аккаунт авторизован, то предварительно требуется разлогинить аккаунт методом Logout.

Более подробно процедура авторизации описана в разделе Перед началом работы.

После успешного ввода кода и авторизации аккаунта формируется входящее уведомление вида Статус аккаунта.

Запрос#

Для получения кода авторизации требуется выполнить запрос по адресу:

POST https://api.green-api.com/waInstance{{idInstance}}/getAuthorizationCode/{{apiTokenInstance}}

Для получения параметров запроса idInstance и apiTokenInstance обратитесь к разделу Перед началом работы.

Параметры запроса#

Параметр	Тип	Обязательный	Описание
`phoneNumber`	integer	Да	Номер телефона в международном формате без `+` и `00`

Пример тела запроса#

{
    "phoneNumber": 441234567890
}

Ответ#

Поля ответа#

Поле	Тип	Описание
`status`	boolean	Статус получения кода, возможные значения `true`, `false`
		`true` - код получен успешно
		`false` - возникла ошибка при получении кода (повторить попытку получения кода)
`code`	string	Код авторизации

Пример тела ответа#

{
    "status": true,
    "code":"GAPI2018"
}

Получение кода может занимать время до 10 секунд

Ошибки#

Перечень общих для всех методов ошибок смотрите в разделе Стандартные ошибки

Примеры кода#

PythoncURLJava - Unirest

import requests
import json

url = "https://api.green-api.com/waInstance{{idInstance}}/getAuthorizationCode/{{apiTokenInstance}}"

payload = json.dumps({
  "phoneNumber": 441234567890
})
headers= {}

response = requests.request("POST", url, headers=headers, data=payload)

print(response.text.encode('utf8'))

  curl --location 'http://localhost:6001/waInstance9903789715/getAuthorizationCode/f4fc69110b364ecfbc75cdd800d0516e4933b4d4e9574ea688' \
  --header 'Content-Type: application/json' \
  --data '{
      "phoneNumber": 441234567890
  }'

var requestUrl = new StringBuilder();
requestUrl
    .append("https://api.greenapi.com")
    .append("/waInstance").append({{idInstance}})
    .append("/getAuthorizationCode/")
    .append({{apiTokenInstance}});

var response = Unirest.post(requestUrl.toString())
    .header("Content-Type", "application/json")
    .body("{\n    \"phoneNumber\": 441234567890,\n}")
    .asString();
System.out.println(response);