API для URL тегов
Список тегов
Список тегов сайта, которые привязываются к доменам и (или) ссылкам.
Формат запроса
GET /sites/{site_id}/url-tags
Параметры запроса
Имя | Описание |
id | ID тега |
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-код | Сообщение об ошибке |
404 | Tag not found |