Получение бизнес-имени пользователя

GET

/v1/apps/{appId}/wa/username

Данный эндпоинт API предназначен для получения уникального бизнес-имени (username) приложения WhatsApp Business. Бизнес-имя позволяет пользователям находить ваш бизнес в WhatsApp по короткому имени.

Авторизация

Для доступа к методу необходим токен системного пользователя. Передайте его в заголовке HTTP-запроса.

Authorization: Bearer <ACCESS_TOKEN>

Параметры

Параметр	Расположение	Тип	Обязательный	Описание
appId	Path	string	Да	Уникальный идентификатор приложения.

Пример запроса

curl -X GET \
  "https://space.getloo.ru/api/v1/apps/{appId}/wa/username" \
  -H "Authorization: Bearer ACCESS_TOKEN" \
  -H "Content-Type: application/json"

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

Успешный ответ

{
  "username": "mybusiness",
  "status": "APPROVED"
}

Если имя не установлено

{
  "error": "Username not found",
  "message": "Business username has not been set for this application"
}

Параметры ответа

Параметр	Тип	Описание
username	string	Уникальное бизнес-имя приложения. Используется для поиска бизнеса в WhatsApp.
status	string	Статус бизнес-имени. Возможные значения: SUCCESS — успешно установлено APPROVED — одобрено RESERVED — зарезервировано NOT_REQUESTED — еще не установлено

Коды состояния

Код состояния	Описание
200	Запрос успешно выполнен
401	Неавторизованный запрос
403	Доступ запрещён
404	Не найдено