# Быстрый старт

Краткое руководство по интеграции MADS API. Полная спецификация в [справочнике API](../../api-reference.html).

## Шаг 1. Создайте плейсмент

Создайте плейсмент в кабинете паблишера и получите `padId` — идентификатор рекламного слота. Подробнее: [Базовая инструкция для паблишеров](../../getting-started/publishers-guide.md).

## Шаг 2. Запросите рекламу

Базовый URL для запросов (API_BASE_URL)
```bash
https://mads-serve.magnit.ru
```

Вызовите эндпоинт получения рекламы:

```bash
curl -X GET "[API_BASE_URL]/v1/ads/get?padId={YOUR_PAD_ID}&userId={USER_ID}"
```

**Обязательные параметры:**
- `padId` — идентификатор плейсмента
- `userId` — идентификатор пользователя (для персонализации и статистики)

Полный список параметров: [Получение рекламных форматов](<API рекламной платформы/получение-рекламных-форматов.md>) · [Справочник API](../../api-reference.html)

## Шаг 3. Обработайте ответ и отобразите рекламу

При статусе **200** в ответе приходят:
- `templateGroupName` - формат рекламы (`modalwindow`, `multiformat`, `stories` и др.)
- `displayOptions` - настройки отображения
- `items` - массив креативов (изображения, видео, кнопки)
- `statistics` - URL для отправки событий показа и клика

Отобразите рекламу согласно формату. Структура данных зависит от `templateGroupName`:

| templateGroupName | Описание | Модель |
|-------------------|----------|--------|
| `modalwindow` | Модальное окно | [ModalWindow](models/reklamnye-formaty/inapp/modalwindow.md) |
| `multiformat` | Баннеры | [Multiformat](models/reklamnye-formaty/inline/multiformat.md) |
| `stories` | Сторисы | [Stories](models/reklamnye-formaty/inline/stories.md) |

Полные модели: [Модели данных](models/index.md) · [Справочник API](../../api-reference.html)

## Коды ответа

| Код | Описание |
|-----|----------|
| 200 | Реклама найдена |
| 204 | Нет рекламы для показа |
| 400 | Неверные параметры |

При статусе, отличном от 200, не отображайте рекламу или покажите заглушку.

## Шаг 4. Отправьте события

После показа рекламы вызовите URL из `statistics` с типом `impression`. После клика — URL с типом `click`.

Подробнее: [Отправка взаимодействия с рекламой](<API рекламной платформы/отправка-взаимодействия-с-рекламой.md>)

## Дальше

- [Полный справочник API](../../api-reference.html) — эндпоинты, параметры, схемы
- [API рекламной платформы](<API рекламной платформы/index.md>) — описание эндпоинтов
- [Модели данных](models/index.md) — структура ответа