鲍勃体育外围
Список групп бэклинков
Метод позволяет получить список и количество групп бэклинков сайта.
Формат запроса
GET /backlink-groups/{site_id}
Параметры в запросе
Имя
|
Обязательный
|
Описание
|
site_id
|
Да
|
id сайта
|
Результат
В случае успеха сервер возвращает список и количество групп бэклинков сайта.
Пример
{
“total_groups”: 2,
“groups”: [
{
“id”: 1,
“name”: “General”,
“count”: 5
},
{
“id”: 2,
“name”: “Second group”,
“count”: 1
}
]
}
Параметры ответа
Имя
|
Описание
|
total_groups
|
Общее кол-во групп
|
groups
|
Массив групп
|
id
|
id группы
|
name
|
Название группы
|
count
|
Кол-во бэклинков в группе
|
Error
HTTP-код
|
Сообщение об ошибке
|
403
|
Access denied (wrong site_id)
|
Создание группы бэклинков
Метод позволяет создать группу бэклинков сайта.
Формат запроса
POST /backlink-groups/{site_id}
{
“name”: “Group name”
}
Параметры в запросе
Имя
|
Обязательный
|
Описание
|
site_id
|
Да
|
id сайта
|
name
|
Да
|
Название группы
|
Результат
В случае успеха сервер возвращает id созданной группы бэклинков сайта.
Пример
Параметры ответа
Имя
|
Описание
|
group_id
|
id созданной группы бэклинков
|
Error
HTTP-код
|
Сообщение об ошибке
|
403
|
Access denied (wrong site_id)
|
400
|
Invalid name
|
400
|
Group already exists
|
Удаление группы бэклинков
Метод позволяет удалить группу бэклинков сайта.
Формат запроса
DELETE /backlink-groups/{site_id}?id={id}
Параметры в запросе
Имя
|
Обязательный
|
Описание
|
site_id
|
Да
|
id сайта
|
id
|
Да
|
id группы бэклинков
|
Результат
В случае успеха сервер возвращает HTTP 204.
Ошибки
HTTP-код
|
Сообщение об ошибке
|
403
|
Access denied (wrong site_id)
|
400
|
Invalid group id
|
400
|
Group does not exist
|
Переименование группы бэклинков
Метод позволяет изменить название группы бэклинков сайта.
Формат запроса
PUT /backlink-groups/{site_id}
{
“id”: 2,
“name”: “New group name”
}
Параметры в запросе
Имя
|
Обязательный
|
Описание
|
site_id
|
Да
|
id сайта
|
id
|
Да
|
id группы бэклинков
|
name
|
Да
|
Новое название группы бэклинков
|
Результат
В случае успеха сервер возвращает HTTP 204.
Error
HTTP-код
|
Сообщение об ошибке
|
403
|
Access denied (wrong site_id)
|
400
|
Invalid name
|
400
|
Group already exists
|
Перемещение бэклинков из одной группы в другую
Метод позволяет переместить бэклинки из одной группы в другую.
Формат запроса
POST /backlink-groups/{site_id}/move
{
“id”: 1,
“backlink_ids”: [1],
“group_ids”: [2]
}
Параметры в запросе
Имя
|
Обязательный
|
Описание
|
site_id
|
Да
|
id сайта
|
id
|
Да
|
id группы бэклинков, в которую будет перемещение
|
backlink_ids
|
Нет
|
Массив ids бэклинков, которые нужно переместить
|
group_ids
|
Нет
|
Массив ids групп бэклинков, которые нужно переместить
|
Результат
В случае успеха сервер возвращает HTTP 204.
Ошибки
HTTP-код
|
Сообщение об ошибке
|
403
|
Access denied (wrong site_id)
|
400
|
Invalid group ids
|
400
|
Backlink group ids
|
400
|
Ids of groups or backlinks are required
|