API для URL тегов

Список тегов

Список тегов сайта, которые привязываются к доменам и (или) ссылкам.

Формат запроса

GET /sites/{site_id}/url-tags

Параметры запроса

ИмяОписание
idID тега
nameНазвание тега
urlСписок ссылок, к которым тег привязан
domainСписок доменов, к которым тег привязан

Результат

В случае успеха сервер возвращает список тегов, которые привязываются к доменам и (или) ссылкам.

Пример ответа

[
“id”: “51”,
“name”: “tag1”,
“url”: [
“https://comw.test/to”
],
“domain”: [
“www.flotenk.ru”,
“biptank.ru”,
“rodlex.ru”
],

]

Добавление тега

Добавляет тег к сайту и привязывает его к ссылке и (или) домену, если они были переданы. К одному сайту можно добавить максимум 20 тегов.

Формат запроса

POST /sites/{site_id}/url-tags
{
“name”: 1,
“urls” : [“https://url.com/path”],
“domains”: [“test.com”],
}

Параметры запроса

ИмяОбязательныйОписание
site_idДаID сайта
nameДаНазвание
urlsНетСписок ссылок, к которым добавится тег
domainsНетСписок доменов, к которым добавится тег

Результат

В случае успеха сервер возвращает HTTP 200 и {tag_id: 1}.

Изменение тега

Назначение тегов домену и (или) ссылке. Для ссылок и доменов, переданных в запросе, будут установлены теги. Ранее установленные теги на эти ссылки и домены будут сняты.

Формат запроса

PUT /sites/{site_id}/url-tags
{
“tag_ids” : [],
“urls”: [],
“domains”: []
}

Результат

В случае успеха сервер возвращает HTTP 204.

Удаление тега

Формат запроса

DELETE /sites/{site_id}/url-tags/{tag_id}

Результат

В случае успеха сервер возвращает HTTP 204.

Ошибки

HTTP-кодСообщение об ошибке
404Tag not found