# Агенції, команди та API

Як агенції рекламують клієнтів в Agilis під їхніми назвами, як працюють ролі, баланси й рахунки та як користуватися Agilis REST API.

**Коротко:** агенція реєструється один раз під власною юридичною назвою. Щоб рекламувати своїх клієнтів, вона вказує назву кожного клієнта в полі **Назва для учасників**. Агенція платить, тримає баланси та отримує рахунки. Розробники можуть створювати акції й події та керувати ними через **Agilis REST API** (https://ads.agilis.dating). Для цього потрібні ключі API з Рекламного кабінету Agilis. Тестові ключі безкоштовні, а створене з ними ніколи не показується учасникам.

## Для агенцій

1. **Зареєструйте агенцію** під її власною юридичною назвою. → [Як зареєструватися](https://www.agilis.dating/uk/business/guide/register)
2. Коли створюєте акцію чи подію, вкажіть **назву клієнта** в полі **Назва для учасників**. Учасники бачитимуть назву клієнта, а не вашу.
3. Ви повинні мати дозвіл кожного клієнта на рекламу від його імені. Згідно з Умовами розміщення реклами, відповідальність за це несе агенція.

**Хто платить і хто отримує рахунки**

- Оплата здійснюється з облікового запису вашої агенції у валюті розрахунків агенції.
- Кожен працівник вашої агенції має власний баланс і платить з нього. Баланс організації — це їхня загальна сума. → [Як працюють баланси](https://www.agilis.dating/uk/business/guide/pricing)
- Рахунки й результати оформлюються на вашу агенцію, по одному рахунку на кожен платіж. Так ви можете перевиставити рахунок кожному клієнту.
- Щоб витрати кожного клієнта були окремими, створюйте для кожного клієнта окрему акцію чи подію. Потім перевиставляйте клієнту суму з її рахунку.

## Ролі в команді

Адміністратори організації та Рекламодавці працюють у Рекламному кабінеті Agilis, а Розробники — через API. Розробники не можуть створювати акції чи події в Рекламному кабінеті. Проте зі своїми ключами API вони можуть створювати, публікувати й оплачувати їх через API. Ваша компанія відповідає за те, як використовуються її ключі. Повну таблицю наведено в розділі [Ролі в команді та дозволи](https://www.agilis.dating/uk/business/guide/getting-started).

## Agilis REST API

- **Базова URL-адреса:** https://ads.agilis.dating
- **Довідник:** www.agilis.dating/api-doc, з прикладами на cURL, Python, Node.js і PHP, а також помічник з API
- **У машиночитному форматі:** OpenAPI 3.1 — www.agilis.dating/openapi.json, Markdown — www.agilis.dating/api-doc.md, повний текст для інструментів ШІ — www.agilis.dating/llms-full.txt
- **Акції:** отримуйте список своїх категорій та інтересів; розраховуйте ціну акції перед її створенням; створюйте, переглядайте списком, призупиняйте, відновлюйте й видаляйте акції; отримуйте результати кожної акції
- **Події:** переглядайте заздалегідь, публікуйте, переглядайте списком, редагуйте, переносьте, скасовуйте й видаляйте події; отримуйте результати кожної події

### Отримайте ключ API

1. Увійдіть у Рекламний кабінет Agilis як Адміністратор організації або Розробник.
2. Виберіть **Тестовий режим** або Робочий режим за допомогою перемикача вгорі сторінки.
3. Перейдіть у розділ **Ключі API** → **Створити новий ключ**. Дайте ключу назву та за бажанням вкажіть дату закінчення дії.
4. **Скопіюйте ключ одразу.** Побачити його знову не вдасться.

Тестові ключі починаються з `pk_test_`, робочі — з `pk_live_`. Кожна людина може мати до 10 ключів у кожному режимі. Кнопка **Замінити ключ** замінює ключ одразу, тож спершу оновіть свої системи. Передавайте ключ у заголовку запиту `x-api-key`: `x-api-key: pk_test_…`.

### Безпечна розробка

- Розробляйте й тестуйте з ключем `pk_test_`: тестові акції та події безкоштовні й ніколи не показуються учасникам.
- Перед створенням акції розрахуйте її ціну через ендпоінт оцінки вартості.
- Не зберігайте ключі в репозиторіях коду та браузерах. Викликайте API зі свого сервера.

## Запитання

### Чи може агенція вести кількох клієнтів з одного облікового запису?

Так. Зареєструйте агенцію один раз і вказуйте клієнта в кожній акції чи події.

### Чи може кожен клієнт мати окремий рахунок?

Рахунки виставляються вашій агенції, по одному на кожен платіж. На їх основі перевиставляйте рахунки своїм клієнтам.

### Чи є пісочниця?

Так. Тестовий режим із ключами `pk_test_` — це повноцінна пісочниця. Кошти не списуються, і нічого не показується учасникам.

### Чи можна підключити інструменти ШІ для програмування?

Так. Вкажіть своєму інструменту адресу www.agilis.dating/api-doc.md або www.agilis.dating/openapi.json.

Source: https://www.agilis.dating/uk/business/guide/agencies-and-api