Документация
Руководство по SDK
Интегрируйте NotifyHub в ваше приложение с нашими библиотеками для Node.js, PHP и Python.
Установка
npm
npm install notifyhub-sdk
yarn
yarn add notifyhub-sdk
Быстрый старт
JavaScript
const NotifyHub = require('notifyhub-sdk');
const client = new NotifyHub({
apiKey: 'your-api-key',
baseUrl: 'https://notify.trovido.com/ru'
});
// Отправить сообщение
const result = await client.send({
channel: 'whatsapp',
to: '+393331234567',
body: 'Ciao! Il tuo ordine è pronto.',
template: 'order_ready',
params: { order_id: '12345' }
});
console.log(result.delivery_id);
Доступные методы
| Метод | Описание |
|---|---|
client.send(options) | Отправить сообщение на любой канал |
client.contacts.list(params) | Список контактов с пагинацией и фильтрами |
client.contacts.create(data) | Создать новый контакт |
client.contacts.update(id, data) | Обновить существующий контакт |
client.contacts.delete(id) | Удалить контакт |
client.deliveries.list(params) | Список доставок с фильтрами по статусу и дате |
client.deliveries.get(id) | Детали отдельной доставки |
client.templates.list() | Список доступных шаблонов |
Аутентификация
Все API-запросы требуют Bearer-токен. Создайте API-ключ в разделе API-ключи портала NotifyHub.
Обработка ошибок
| Код | Описание |
|---|---|
401 | API-ключ недействителен или отсутствует |
422 | Недействительные входные данные — проверьте обязательные поля |
429 | Превышен лимит запросов — повторите после периода, указанного в заголовке Retry-After |
500 | Внутренняя ошибка сервера — повторите позже |