Получение API-токена для работы с кабинетами VK Рекламы

Коротко: API-токен для VK Рекламы — это ключ, который даёт вашему коду доступ к конкретному рекламному кабинету. Получить его можно через интерфейс click.ru (вручную) или через API click.ru (программно).

Зачем получать отдельный токен для VK Рекламы

Клиенты могут запрашивать Client Secret для доступа к своим кабинетам VK Рекламы.
Client Secret — это главный ключ от всего агентского аккаунта. Он даёт доступ ко всем кабинетам внутри агентского аккаунта, всем кампаниям и к финансовым документам, поэтому передавать его небезопасно.

Как правильно: используйте API click.ru. Мы выдаём отдельные токены под каждый кабинет VK Рекламы. Клиент получает доступ только к своему кабинету и не видит ваши финансы и данные других клиентов.

Как получить API-токен

Токен можно получить двумя способами:

● через интерфейс click.ru (вручную);
● через API click.ru (программно).

Получение API-токена через интерфейс click.ru

1. Находясь в пользовательском аккаунте click.ru перейдите в список аккаунтов через панель слева.

2. Найдите в списке нужный кабинет VK Рекламы и нажмите на шестеренку.

3. Нажмите на «Получить API токен».

4. Далее откроется окно с токеном. Нажмите на кнопку «Копировать API токен».

Токен готов к использованию.

Получение токена через API click.ru

Подходит, если нужно автоматизировать процесс: выдавать токены по запросу без поиска в интерфейсе и ручного копирования.

Что понадобится

● API-токен click.ru (мастер-токен). Как его получить можно узнать в статье — «Как начать работать с API click.ru».
● ID пользовательского аккаунта click.ru (X-Auth-UserId), в котором находится кабинет.
● ID кабинета VK Рекламы в системе click.ru (accountId).

Как узнать accountId через API

Получить список всех рекламных кабинетов пользовательского аккаунта и их ID можно через метод: GET /accounts.

Пример запроса:

bash

curl -X GET "https://api.click.ru/V0/accounts" \
     -H "X-Auth-Token: ВАШ_МАСТЕР_ТОКЕН" \
     -H "X-Auth-UserId: ID_ПОЛЬЗОВАТЕЛЯ_В_CLICK"

Пример ответа API:

json

{
  "response": {
    "accounts": [
      {
        "id": 1234567,
        "name": "Название кабинета",
        "service": "VK_ADS",
        "status": "ACTIVE",
        "state": "ACTIVE"
      }
    ]
  }
}

В ответе найдите кабинет VK Рекламы (поле "service": "VK_ADS") и возьмите его числовой идентификатор из поля "id". Это и есть accountId.

Запрос API-токена для кабинета

Когда accountId известен, отправьте GET-запрос к методу:
/accounts/{accountId}/access_token/vk_ads/.

Пример запроса через curl:

bash

curl -X GET "https://api.click.ru/V0/accounts/1234567/access_token/vk_ads/" \
     -H "X-Auth-Token: ВАШ_МАСТЕР_ТОКЕН" \
     -H "X-Auth-UserId: ID_ПОЛЬЗОВАТЕЛЯ_В_CLICK"

Пример ответа API:

json

{
  "response": {
    "token": "vk1.a.W8Rj..._s8"
  }
}

Токен получен. Дальше он используется так же, как токен из интерфейса.

Важно знать

● Два способа получения токена для рекламного кабинета — через интерфейс click.ru и через API
● Безопасность — клиент получит доступ только к своему рекламному кабинету
● Client Secret не нужен — API-токен click.ru привязан к одному кабинету VK Рекламы. Клиент не получает доступа к другим кабинетам.
● Для получения токена через API потребуется ID кабинета accountId. Узнать его можно через API методом GET /accounts (переход на пример запроса).
● Документация — для детального изучения всех методов API (управление кампаниями, ставками, статистикой) обращайтесь к официальной Swagger-документации.

Частые вопросы

Почему я не могу просто дать клиенту Client Secret от агентства?

Client Secret — ключ от всего агентского аккаунта VK Рекламы. Он даёт доступ ко всем рекламным кабинетам, финансам и данным ваших клиентов. Поэтому мы не передаём его клиентам.

А если клиент хочет сам управлять своим кабинетом, но без меня?

Клиент может получить доступ без API и управлять кабинетом через интерфейс рекламной системы. Также может получить токен через API click.ru или через интерфейс. Вы не будете участвовать в процессе.

Этот метод работает только для VK Рекламы?

Да. Для других площадок механизмы получения токенов могут отличаться.

Я не разработчик. Мне всё равно придётся лезть в код?

Для получения токена через API — да, нужны базовые навыки работы с HTTP-запросами. Если не хотите писать код — используйте первый способ (через интерфейс).

Связанные статьи

• Как начать работать с API click.ru — получение мастер-токена, авторизация, первые запросы.
• Документация API click.ru (Swagger) — полное описание методов, включая получение токенов для VK Рекламы.
• Что такое мастер-аккаунт и пользовательские аккаунты — архитектура click.ru для агентств.
• Список ошибок API — коды 401, 404, 429 и другие.

Остались вопросы?

Напишите в поддержку — ответим в среднем за 1 минуту, работаем без выходных: чат на сайте · Telegram · support@click.ru