# Click API

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

# [0.13.0] - 2021-12-01

# Добавлено

В метод GET /campaigns добавлено объект budget (информация о настройки бюджета в кампании)

# [0.12.0] - 2021-10-21

# Добавлено

Новый метод: POST /payments/payment_link/create генерация ссылки на пополнение пользователя
Новый метод: GET /payments/payment_link/types получение доступных типов платежей

# [0.11.0] - 2021-09-28

# Добавлено

В метод GET /campaigns добавлен параметр showDeleted (для отображения архивных/удалённых кампаний)

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

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

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

1 вызов в секунду;
3600 вызовов в час;

В случае превышения лимита будет отдан 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": "[email protected]",
    "login": "test123"
  }
}