Добро пожаловать на наш онлайн-сервис по сокращению ссылок! Здесь вы можете сократить URL-адреса, настраивать и отслеживать трафик по сокращенным ссылкам с использованием собственных доменов, ретаргетинговых пикселей и глубокой аналитики.

Ссылки

Заметки
Уровень эксперта
Ключ API должен быть отправлен как токен Bearer в заголовке Authorization запроса. Получите свой API-ключ.
Список

API-эндпоинт:

GET 
https://url-click.ru/api/v1/links

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

curl --location --request GET 'https://url-click.ru/api/v1/links' \
--header 'Accept: application/json' \
--header 'Authorization: Bearer {api_key}'
Параметр
Тип
Описание
search
необязательно string
Поисковый запрос.
search_by
необязательно string
Искать по. Возможные значения: title для Заголовок, alias для URL, url для URL. По умолчанию: title.
status
необязательно integer
Фильтровать по статусу. Возможные значения: 0 для Все, 1 для Активный, 2 для Истекший, 3 для Отключено. По умолчанию: 0.
space_id
необязательно integer
Фильтровать по ID Пространство.
domain_id
необязательно integer
Фильтровать по ID домена.
pixel_id
необязательно integer
Фильтровать по ID пикселя.
sort_by
необязательно string
Сортировать по. Возможные значения: id для Дата создания, clicks для Клики, title для Заголовок, alias для URL, url для URL. По умолчанию: id.
sort
необязательно string
Сортировать. Возможные значения: desc для По убыванию, asc для По возрастанию. По умолчанию: desc.
per_page
необязательно integer
Результатов на страницу. Возможные значения: 10, 25, 50, 100. По умолчанию: 10.
Показать

API-эндпоинт:

GET 
https://url-click.ru/api/v1/links/{id}

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

curl --location --request GET 'https://url-click.ru/api/v1/links/{id}' \
--header 'Accept: application/json' \
--header 'Authorization: Bearer {api_key}'
Сохранить

API-эндпоинт:

POST 
https://url-click.ru/api/v1/links

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

curl --location --request POST 'https://url-click.ru/api/v1/links' \
--header 'Content-Type: application/x-www-form-urlencoded' \
--header 'Authorization: Bearer {api_key}' \
--data-urlencode 'url={url}' \
--data-urlencode 'domain={id}'
Параметр
Тип
Описание
url
обязательно string
Ссылка для сокращения.
domain_id
обязательно integer
ID домена, в котором будет сохранена ссылка.
alias
необязательно string
Псевдоним ссылки.
password
необязательно string
Пароль ссылки.
space_id
необязательно integer
ID Пространство, в котором будет сохранена ссылка.
pixel_ids
необязательно array
The pixel IDs to be integrated in the link.
disabled
необязательно integer
Отключена ли ссылка или нет. Возможные значения: 0 для Активный, 1 для Отключено. По умолчанию: 0.
privacy
необязательно integer
Является ли статистика ссылки общедоступной. Возможные значения: 0 для Публичная, 1 для Приватная, 2 для Пароль. По умолчанию: 0.
privacy_password
необязательно string
Пароль для страницы статистики. Работает только при установке privacy на 2.
expiration_url
необязательно string
Ссылка, куда будет перенаправлен пользователь после истечения срока действия ссылки.
expiration_date
необязательно string
Дата действия срока действия ссылки в формате YYYY-MM-DD.
expiration_time
необязательно string
Время истечения срока действия ссылки в формате HH:MM.
expiration_clicks
необязательно integer
Количество кликов, после которых ссылка должна истечь.
target_type
необязательно integer
Тип таргетинга. Возможные значения: 0 для Нет, 1 для Географический, 2 для Платформа, 4 для Вращение.
country[index][key]
необязательно string
Код целевой страны. Код должен соответствовать стандарту ISO 3166-1 alpha-2.
country[index][value]
необязательно string
Ссылка, на которую будет перенаправлен пользователь.
platform[index][key]
необязательно string
Название целевой платформы. Возможные значения: iOS, Android, Windows, OS X, Linux, Ubuntu, Chrome OS.
platform[index][value]
необязательно string
Ссылка, на которую будет перенаправлен пользователь.
language[index][key]
необязательно string
Код целевого языка. Код должен соответствовать стандарту ISO 639-1 alpha-2.
language[index][value]
необязательно string
Ссылка, на которую будет перенаправлен пользователь.
rotation[index][value]
необязательно string
Ссылка, на которую будет перенаправлен пользователь.
Обновить

API-эндпоинт:

PUT PATCH 
https://url-click.ru/api/v1/links/{id}

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

curl --location --request PUT 'https://url-click.ru/api/v1/links/{id}' \
--header 'Content-Type: application/x-www-form-urlencoded' \
--header 'Authorization: Bearer {api_key}' \
--data-urlencode 'url={url}'
Параметр
Тип
Описание
url
необязательно string
Ссылка для сокращения.
alias
необязательно string
Псевдоним ссылки.
password
необязательно string
Пароль ссылки.
space_id
необязательно integer
ID Пространство, в котором будет сохранена ссылка.
pixel_ids
необязательно array
The pixel IDs to be integrated in the link.
disabled
необязательно integer
Отключена ли ссылка или нет. Возможные значения: 0 для Активный, 1 для Отключено.
privacy
необязательно integer
Является ли статистика ссылки общедоступной. Возможные значения: 0 для Публичная, 1 для Приватная, 2 для Пароль.
privacy_password
необязательно string
Пароль для страницы статистики. Работает только при установке privacy на 2.
expiration_url
необязательно string
Ссылка, куда будет перенаправлен пользователь после истечения срока действия ссылки.
expiration_date
необязательно string
Дата действия срока действия ссылки в формате YYYY-MM-DD.
expiration_time
необязательно string
Время истечения срока действия ссылки в формате HH:MM.
expiration_clicks
необязательно integer
Количество кликов, после которых ссылка должна истечь.
target_type
необязательно integer
Тип таргетинга. Возможные значения: 0 для Нет, 1 для Географический, 2 для Платформа, 4 для Вращение.
country[index][key]
необязательно string
Код целевой страны. Код должен соответствовать стандарту ISO 3166-1 alpha-2.
country[index][value]
необязательно string
Ссылка, на которую будет перенаправлен пользователь.
platform[index][key]
необязательно string
Название целевой платформы. Возможные значения: iOS, Android, Windows, OS X, Linux, Ubuntu, Chrome OS.
platform[index][value]
необязательно string
Ссылка, на которую будет перенаправлен пользователь.
language[index][key]
необязательно string
Код целевого языка. Код должен соответствовать стандарту ISO 639-1 alpha-2.
language[index][value]
необязательно string
Ссылка, на которую будет перенаправлен пользователь.
rotation[index][value]
необязательно string
Ссылка, на которую будет перенаправлен пользователь.
Удалить

API-эндпоинт:

DELETE 
https://url-click.ru/api/v1/links/{id}

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

curl --location --request DELETE 'https://url-click.ru/api/v1/links/{id}' \
--header 'Authorization: Bearer {api_key}'