Авторизация и права
Как создать API-ключ, выбрать права и передавать его в запросах.
Создать ключ
- Откройте «API-ключи» в нужной организации.
- Дайте понятное имя, например CRM production.
- Выберите только нужные права. Для чтения подключений нужно connections:read, для отправки — messages:write.
- Сохраните полный ключ сразу: позже показывается только его обозначение.
- Храните ключ в секретах своего сервера, а не в браузерном JavaScript или мобильном приложении.
Формат запроса
bash
curl --fail-with-body https://waix.kz/api/v1/connections \
-H "Authorization: Bearer $WAIX_API_KEY"Базовый адрес — https://waix.kz/api/v1. Заголовок D360-API-KEY другого провайдера здесь не используется. Ключ связан с организацией; ID другой компании не предоставляет к ней доступ.
Список прав
| Группа | Права |
|---|---|
| Номера | connections:read |
| Сообщения | messages:read, messages:write |
| Шаблоны | templates:read, templates:write |
| Профиль | profile:read, profile:write |
| Файлы | media:read, media:write |
| Вебхуки | webhooks:read, webhooks:write |
Замена ключа
Создайте новый ключ, обновите сервер, проверьте запрос, затем отзовите старый. При утечке отзывайте скомпрометированный ключ сразу. Ключ WAIX не заменяет Meta-токен в сторонних модулях Cloud API.
Остался вопрос по этой инструкции?Написать в поддержку →