# Click API

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

# [0.9.0] - 2021-06-24

# Добавлено

Добавлены методы для получения и добавления управляющих пользователей у VK/MyTarget аккаунтов

# [0.8.0] - 2021-05-17

# Добавлено

Новый метод POST /tools/keywords_by_url - подбор слов по сайту
Новый метод POST /tools/ad_generator - генератор объявлений

# [0.7.2] - 2021-05-06

# Исправлено

В метод GET /accounts добавлено поле servicePassword (пароль в системе Yandex.Direct)

Использовать 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": "user@example.com",
    "login": "test123"
  }
}