# Агентства, команды и API

Как агентства рекламируют клиентов в Agilis под их названиями, как устроены роли, балансы и счета и как работать с REST API Agilis.

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

## Для агентств

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

**Кто платит и кто получает счета**

- Оплата производится с аккаунта агентства в валюте расчётов агентства.
- У каждого сотрудника агентства свой баланс, и он платит с него. Баланс организации — это общая сумма. → [Как работают балансы](https://www.agilis.dating/ru/business/guide/pricing)
- Счета и результаты оформляются на имя агентства, по одному счёту на каждый платёж. Так вы сможете перевыставить расходы каждому клиенту.
- Чтобы вести расходы каждого клиента отдельно, создавайте для каждого клиента свою акцию или своё мероприятие и перевыставляйте расходы по соответствующему счёту.

## Роли в команде

Администраторы организации и Рекламодатели работают в Рекламном кабинете, а Разработчики работают через API. Разработчики не могут создавать акции и мероприятия в Рекламном кабинете. Однако с помощью своих ключей API они могут создавать, публиковать и оплачивать их через API, и за использование ключей отвечает ваша организация. Полная таблица приведена в разделе [Роли и права в команде](https://www.agilis.dating/ru/business/guide/getting-started).

## REST API Agilis

- **Базовый 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. Войдите в Рекламный кабинет как Администратор организации или Разработчик.
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/ru/business/guide/agencies-and-api