nofollow

Группы проектов

Добавление группы проектов

Метод позволяет добавить группу проектов в аккаунт пользователя.

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

POST https://api4.seranking.com/site-groups
{ «name» : «text» }

Параметры

ИмяОбязательныйОписание
nameДа Имя добавляемой группы проектов

Результат

В случае успеха сервер вернет HTTP 201 и ID добавленной группы проектов.
ИмяОбязательныйОписание
group_idДа ID добавленной группы проектов

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

{
«group_id»: 9545
}

Ошибки

HTTP-кодСообщение об ошибке
400 Empty name

Изменение названия группы проектов

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

PUT https://api4.seranking.com/site-groups/{group_id}
{
«name»: «new name»
}

Параметры

ИмяОбязательныйОписание
nameДа Новое название группы проектов

Результат

В случае успеха сервер вернет HTTP 200.

Ошибки

HTTP-кодСообщение об ошибке
400 Empty name
404 Group not found

Удаление группы проектов

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

DELETE https://api4.seranking.com/site-groups/{group_id}

Результат

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

Ошибки

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

Список групп проектов

Метод позволяет получить список всех групп проектов в аккаунте пользователя.

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

 GET https://api4.seranking.com/site-groups

Результат

В случае успеха сервер возвращает список групп.

ИмяОбязательныйОписание
idДа ID группы проектов
nameДа Имя группы проектов

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

[
{
«id»: «123»,
«name»: «Group1»
},
{
«id»: «456»,
«name»: «Group2»
}
]

Перенос проектов в группу проектов

Описание

Метод позволяет перенести проекты из одной группы проектов в другую.

Параметры

ИмяОбязательныйОписание
site_idsДа Массив ID сайтов для перемещения

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

POST  https://api4.seranking.com/site-groups/{group_id}/sites
{
«site_ids» : [1,2,3,4,5]
}

Результат

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

Ошибки

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