# Click API

С помощью API click.ru можно автоматизировать рутинные операции, выгружать статистику в сторонние системы и решать другие задачи.

# [0.18.3] - 2025-03-19

# Добавлено

  • В метод POST /telegram/{accountId}/ads добавлено поле websiteName

# [0.18.2] - 2025-01-16

# Добавлено

  • Добавлен метод получения API токена (access token) для VK.ADS: GET /accounts/{accountId}/access_token/vk_ads/

# [0.18.1] - 2025-01-16

# Добавлено

  • В метод /telegram/{accountId}/ads/{adId} добавлено новое поле: erid

Использовать API могут все зарегистрированные пользователи Системы. API является бесплатным.

# Ограничения

На вызовы методов API существуют ограничения:

В случае превышения лимита будет отдан http-код ответа 429.

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

# Авторизация

Доступна обоим типам аккаунтов - мастер-аккаунтам и аккаунтам пользователей. При этом мастер-аккаунт может делать запросы от имени своих пользовательских аккаунтов.
Для того, чтобы сделать запрос от имени пользовательского аккаунта, нужно использовать HTTP-заголовок X-Auth-UserId.

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

Токен для запросов можно получить в профиле пользователя. Токен можно пересоздавать, в этом случае старый токен будет неактивен.

# Авторизация от имени пользовательского аккаунта

Передаём в HTTP заголовке X-Auth-UserId: 123.

# Использование

Токен передаём в HTTP заголовке X-Auth-Token.

Пример: X-Auth-Token: 1234567890

В случае ошибки авторизации (неправильный токен, неактивный) будет возвращён код ответа 401.

# Запросы к API

Формат взаимодействия мы используем JSON.

# Запрос со страницы описания метода через cURL

Пример получения профиля пользователя:

Командная строка:

curl -X GET "https://api.click.ru/V0/user"
     -H "Accept: application/json"
     -H "X-Auth-Token: 1234567890"
     -H "X-Auth-UserId: 123"

Вернёт:

{
  "response": {
    "id": 10001,
    "email": "user@example.com",
    "login": "test123"
  }
}