Акция! Бесплатная активация любого тарифа по промокоду FREE на 30 дней!

Ссылки

Примечания
Expert level
Ключ API должен быть отправлен как Bearer token в заголовке авторизации запроса. Получите ваш ключ API.
Список

API endpoint:

GET 
https://tinylinks.ru/api/v1/links

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

curl --location --request GET 'https://tinylinks.ru/api/v1/links' \
--header 'Accept: application/json' \
--header 'Authorization: Bearer {api_key}'
Параметр
Тип
Описание
search
необязательный string
The search query.
search_by
необязательный string
Поиск по. Возможные значения: title для Название, alias для Псевдоним, 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. По умолчанию: id.
sort
необязательный string
Сортировать. Возможные значения: desc для По убыванию, asc для По возрастанию. По умолчанию: desc.
per_page
необязательный integer
Результатов на странице. Возможные значения: 10, 25, 50, 100. По умолчанию: 10.
Показать

API endpoint:

GET 
https://tinylinks.ru/api/v1/links/{id}

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

curl --location --request GET 'https://tinylinks.ru/api/v1/links/{id}' \
--header 'Accept: application/json' \
--header 'Authorization: Bearer {api_key}'
Добавить

API endpoint:

POST 
https://tinylinks.ru/api/v1/links

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

curl --location --request POST 'https://tinylinks.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
The link to be shortened.
domain_id
обязательный integer
The domain ID the link to be saved under.
alias
необязательный string
The link alias.
password
необязательный string
The link password.
space_id
необязательный integer
The space ID the link to be saved under.
pixel_ids
необязательный array
The pixel IDs to be integrated in the link.
disabled
необязательный integer
Whether the link is disabled or not. Возможные значения: 0 для Активен, 1 для Отключено. По умолчанию: 0.
privacy
необязательный integer
Whether the link stats are public or not. Возможные значения: 0 для Открытая, 1 для Приватная, 2 для Пароль. По умолчанию: 0.
privacy_password
необязательный string
The password for the statistics page. Работает когда privacy равно 2.
expiration_url
необязательный string
The link where the user will be redirected once the link has expired.
expiration_date
необязательный string
The link expiration date in YYYY-MM-DD format.
expiration_time
необязательный string
The link expiration time in HH:MM format.
expiration_clicks
необязательный integer
The number of clicks after which the link should expire.
target_type
необязательный integer
The type of targeting. Возможные значения: 0 для Нет, 1 для География, 2 для Платформа, 4 для Чередование.
country[index][key]
необязательный string
The code of the targeted country. The code must be in ISO 3166-1 alpha-2 standard.
country[index][value]
необязательный string
The link where the user will be redirected to.
platform[index][key]
необязательный string
The name of the targeted platform. Возможные значения: iOS, Android, Windows, OS X, Linux, Ubuntu, Chrome OS.
platform[index][value]
необязательный string
The link where the user will be redirected to.
language[index][key]
необязательный string
The code of the targeted language. The code must be in ISO 639-1 alpha-2 standard.
language[index][value]
необязательный string
The link where the user will be redirected to.
rotation[index][value]
необязательный string
The link where the user will be redirected to.
Обновить

API endpoint:

PUT PATCH 
https://tinylinks.ru/api/v1/links/{id}

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

curl --location --request PUT 'https://tinylinks.ru/api/v1/links/{id}' \
--header 'Content-Type: application/x-www-form-urlencoded' \
--header 'Authorization: Bearer {api_key}' \
--data-urlencode 'url={url}'
Параметр
Тип
Описание
url
необязательный string
The link to be shortened.
alias
необязательный string
The link alias.
password
необязательный string
The link password.
space_id
необязательный integer
The space ID the link to be saved under.
pixel_ids
необязательный array
The pixel IDs to be integrated in the link.
disabled
необязательный integer
Whether the link is disabled or not. Возможные значения: 0 для Активен, 1 для Отключено.
privacy
необязательный integer
Whether the link stats are public or not. Возможные значения: 0 для Открытая, 1 для Приватная, 2 для Пароль.
privacy_password
необязательный string
The password for the statistics page. Работает когда privacy равно 2.
expiration_url
необязательный string
The link where the user will be redirected once the link has expired.
expiration_date
необязательный string
The link expiration date in YYYY-MM-DD format.
expiration_time
необязательный string
The link expiration time in HH:MM format.
expiration_clicks
необязательный integer
The number of clicks after which the link should expire.
target_type
необязательный integer
The type of targeting. Возможные значения: 0 для Нет, 1 для География, 2 для Платформа, 4 для Чередование.
country[index][key]
необязательный string
The code of the targeted country. The code must be in ISO 3166-1 alpha-2 standard.
country[index][value]
необязательный string
The link where the user will be redirected to.
platform[index][key]
необязательный string
The name of the targeted platform. Возможные значения: iOS, Android, Windows, OS X, Linux, Ubuntu, Chrome OS.
platform[index][value]
необязательный string
The link where the user will be redirected to.
language[index][key]
необязательный string
The code of the targeted language. The code must be in ISO 639-1 alpha-2 standard.
language[index][value]
необязательный string
The link where the user will be redirected to.
rotation[index][value]
необязательный string
The link where the user will be redirected to.
Удалить

API endpoint:

DELETE 
https://tinylinks.ru/api/v1/links/{id}

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

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