---
agentTools:
  projectIndex: https://sendios.readme.io/llms.txt
---

# Getting Started With Your API

Ця стаття надає покрокові інструкції налаштувань для відправки листів та початку роботи з АРІ-точками.

Якщо Ви використовуєте PHP, то маєте змогу підключити нашу бібліотеку – [Sendios SDK](https://github.com/sendios/php-sdk).

Перед надсиланням листів необхідно виконати наступні дії:

1. Налаштувати [Домен відправника](https://sendios.readme.io/docs/як-налаштувати-sender-domain) та [Домен для трекінгу](https://sendios.readme.io/docs/як-налаштувати-tracking-domain)

> Налаштування Домену для трекінгу є опціональним: використовуйте, якщо вам необхідно відслідковувати відкриття листів та перехід за посиланнями з них.

2. Встановити SPF / DKIM-записи згідно з [налаштуваннями Домену відправника](https://sendios.readme.io/docs/domain-settings);
3. Створити [Проєкт](https://sendios.readme.io/docs/як-створити-project);
4. Створити [шаблон](https://sendios.readme.io/docs/як-створити-template);
5. Створити [транзакційний лист](https://sendios.readme.io/docs/як-створити-транзакційний-лист).

Усі API-точки працюють асинхронно: якщо вам надходить відповідь 200 ОК, то це означає, що ми отримали та взяли в опрацювання ваш запит, і що він пройшов валідацію.

Дізнатися статус відправки листа можна в адмін-панелі – у розділах [User profile](https://sendios.readme.io/docs/профайл-юзера) та [Webhooks](https://sendios.readme.io/docs/webhooks).

Щоб здійснювати запити на сервер, потрібно авторизуватись. Для цього виконайте наступні кроки:

1. Дізнайтесь clientId та API key y Customer Success Manager;
2. Рядок у форматі {clientId}:{api\_key} закодуйте в base64;
3. Отриманий закодований рядок передайте у header авторизації.

| Params   | Description           |
| :------- | :-------------------- |
| clientId | Ідентифікатор клієнта |
| api\_key | АРІ key               |

```curl
curl -X GET https://api.sendios.io/v1/something-else \
-u {clientId}:{api_key}
```

Якщо ви використовуєте нашу бібліотеку Sendios SDK, тоді дізнайтеся clientId та SDK key у Customer Success Manager.

> 🚧 Наразі доступна тільки PHP SDK, iншi мови програмування не підтримуються.

Про статус роботи системи дізнавайтесь із сайту <https://status.sendios.io/>: тут у випадку інцидентів чи недоступності системи, ми публікуємо актуальну інформацію про проблеми та їх вирішення.

> 👍 Більше можливостей для моніторингу можна знайти у статті [Моніторинг Sendios](https://sendios.readme.io/docs/%D0%BC%D0%BE%D0%BD%D1%96%D1%82%D0%BE%D1%80%D0%B8%D0%BD%D0%B3-sendios).

### АРІ-точки, які будуть корисні

* Створення користувачів в базі Sendios відбувається через відповідну АРІ-точку [Send system / trigger email](https://sendios.readme.io/reference/send-system-trigger-email) при першій відправці будь-якого системного листа (наприклад, тип "Welcome"). Через цю АРІ-точку потрібно передавати інформацію про користувача (електронну адресу і додаткову інформацію: країна, імʼя, мова, стать, вік тощо в масив "user") і змінні для листа (якщо необхідно, в масиві "data").
* Створити користувача без відправки електронного листа можна за допомогою АРІ-точки [Create omnichannel user](https://sendios.readme.io/reference/omnichannel_user_create). При використанні цієї АРІ-точки ви можете одразу додавати будь-які параметри в поле "fields" для передачі інформації про користувача, яка є унікальною для вашого продукту.
* Для додавання чи оновлення інформації користувача, яка є унікальною для вашого продукту, для вже створеного користувача в системі використовуйте API-точки [Add and update user data by project ID and email](https://sendios.readme.io/reference/create-and-update-user-data) або [Add and update user data by user\_id](https://sendios.readme.io/reference/create-and-update-user-data-by-user).
* Для збору аналітики, потрібно передавати деталі оплат на відповідну АРІ-точку [Add user payments](https://sendios.readme.io/reference/add-payment-by-user-user).
* Після видалення облікового запису користувача на продукті або відписки зі сторінки налаштувань, необхідно відписати користувача через відповідну АРІ-точку [Unsubscribe](https://sendios.readme.io/reference/unsubscribe).
* За допомогою АРІ-точки [Erase user](https://sendios.readme.io/reference/erase-user) ви можете додати користувача до черги на видалення. Як наслідок, користувач буде видалений через 2 доби. Це окремий функціонал для відповідності GDPR-нормам.