Перейти к содержанию

Группы ссылок

Группы ссылок позволяют объединять несколько ссылок в одно целое. Например для более простого получения по ним суммарной статистики.

Поддерживаются пользовательские метки reltype/relref (смотрите описание в Общих Замечаниях)

Получить список групп ссылок

{

 "action" : "link.group.list" 

 ,"filter" : { -- не обязательно

              "reltype"  : число  -- не обязательно
                                  -- при наличии ограничивает список только группами с указанным reltype

             ,"relref"   : число  -- не обязательно
                                  -- при наличии ограничивает список только группами с указанным relref
             }
}

ответ

{

  <общие поля>

 ,"list" : [

             {

                "id"   : идентификатор группы ссылок

               ,"name" : "название группы ссылок" 

               ,"reltype" : ....

               ,"relref" : ....

             }

             ...

           ]

}

Прочитать группу ссылок

{

  ,"action" : "link.group.get" 

  ,"id"     : идентификатор группы
}

ответ

{

   <общие поля>

  "obj" : {

     "id" : идентификатор группы

    ,"name"   : "название группы" 

    ,"reltype" : ......

    ,"relref" : ......
  }

}

Создать группу ссылок / Изменить группу ссылок

{

  ,"action" : "link.group.set" 

-- для создания

  ,"name"   : "название группы" -- обязательно

  ,"reltype" : число - не обязательно, по умолчанию 0

  ,"reltype" : число -- не обязательно, по умолчанию 0
                     -- отрицательные значения зарезервированы для системы
                     -- в данный момент:
                     --  -2 - ссылка - целевая страниц

  ,"relref" : число  - не обязательно, по умолчанию 0

-- для изменения

  ,"id"     : идентификатор группы ссылок

  -- не указанные поля остаются не изменёнными

  ,"name"   : "новое название группы" 

  ,"reltype" : "новое значение" 

  ,"relref" : "новое значение" 
}

ответ

{

   <общие поля>

  ,"id" : идентификатор группы

}

Удалить группу ссылок

Удаляется именно группа ссылок как объект обеспечивающий группировку ссылок.

Входящие в неё ссылки не удаляются.

{

  ,"action" : "link.group.delete" 

  ,"id"     : идентификатор группы

}

ответ

{

   <общие поля>

}