Главная > Документация uAPI > Модуль "Новости сайта", категории
 

[GET] Все категории


Расшифровка переменных ответа

  • access2add – [Массив] – Права на добавление материалов в категорию
  • position – [Число] – Какой по порядку идет категория
  • name – [Строка] – Название категории
  • description – [Строка] – Описание категории
  • access2page – [Массив] – Группы, имеющие возможность скачивать файлы
  • entry_count – [Число] – Количество материалов в категории
  • id – [Число] – ID категории
  • type – [Строка] – Что это именно (category)
  • access2category – [Массив] – Какие группы имеют доступ к просмотру категории
  • hgu_title – [Строка] – ЧПУ категории
  • url – [Строка] – Ссылка на категорию

<?php require 'uAPImodule.php'; $request = new Request(array( 'oauth_consumer_key' => 'Мой consumer_key', 'oauth_consumer_secret' => 'Мой consumer_secret', 'oauth_token' => 'Мой token', 'oauth_token_secret' => 'Мой token_secret' )); $response = $request->get('/news/category', array( //без параметров )); print_r($response); //Получаем ответ curl -i -X GET -G --data-urlencode "oauth_consumer_key=ЗНАЧЕНИЕ" --data-urlencode "oauth_nonce=значение" --data-urlencode "oauth_signature_method=HMAC-SHA1" --data-urlencode "oauth_timestamp=значение" --data-urlencode "oauth_version=1.0" --data-urlencode "oauth_token=значение" --data-urlencode "auth_signature=значение" http://yoursite.ucoz.ru/uapi/news/category
[ { "access2add":[ "Все группы" ], "position":"1", "name":"Мои статьи", "description":"test", "access2page":[ { "4":"Администраторы" } ], "entry_count":7, "id":1, "type":"category", "access2category":[ "Все группы" ], "hgu_title":null, "url": "https://my.site/news/1/1-0-1" }, { //вывод уже другой категории, например, с ID2 } ] [ { "access2add":[ "Все группы" ], "position":"1", "name":"Мои статьи", "description":"test", "access2page":[ { "4":"Администраторы" } ], "entry_count":7, "id":1, "type":"category", "access2category":[ "Все группы" ], "hgu_title":null, "url": "https://my.site/news/1/1-0-1" }, { //вывод уже другой категории, например, с ID2 } ]
 

[GET] Определенную категорию


Расшифровка переменных ответа

  • access2add – [Массив] – Права на добавление материалов в категорию
  • position – [Число] – Какой по порядку идет категория
  • name – [Строка] – Название категории
  • description – [Строка] – Описание категории
  • access2page – [Массив] – Группы, имеющие возможность скачивать файлы
  • entry_count – [Число] – Количество материалов в категории
  • access2category – [Массив] – Какие группы имеют доступ к просмотру категории
  • id – [Число] – ID категории
  • type – [Строка] – Что это именно (category)
  • hgu_title – [Строка] – ЧПУ категории
  • url – [Строка] – Ссылка на категорию

<?php require 'uAPImodule.php'; $request = new Request(array( 'oauth_consumer_key' => 'Мой consumer_key', 'oauth_consumer_secret' => 'Мой consumer_secret', 'oauth_token' => 'Мой token', 'oauth_token_secret' => 'Мой token_secret' )); $response = $request->get('/news/category', array( 'id' => 'АЙДИКАТЕГОРИИ' )); print_r($response); //Получаем ответ curl -i -X GET -G --data-urlencode "oauth_consumer_key=ЗНАЧЕНИЕ" --data-urlencode "oauth_nonce=значение" --data-urlencode "oauth_signature_method=HMAC-SHA1" --data-urlencode "oauth_timestamp=значение" --data-urlencode "oauth_version=1.0" --data-urlencode "oauth_token=значение" --data-urlencode "auth_signature=значение" --data "id=АЙДИКАТЕГОРИИ" http://youresite.ucoz.ru/uapi/news/category
[ { "access2add":[ "Все группы" ], "position":"2", "name":"Категория", "description":"", "access2page":[ { "4":"Администраторы" } ], "entry_count":0, "access2category":[ "Все группы" ], "id":3, "type":"category", "hgu_title":"kategorija_v_razdele", "url": "https://my.site/news/1/1-0-1" } ] [ { "access2add":[ "Все группы" ], "position":"2", "name":"Категория", "description":"", "access2page":[ { "4":"Администраторы" } ], "entry_count":0, "access2category":[ "Все группы" ], "id":3, "type":"category", "hgu_title":"kategorija_v_razdele", "url": "https://my.site/news/1/1-0-1" } ]
 

[POST] Добавить категорию


Расшифровка переменных запроса

  • access2add – [Массив] – Права на добавление материалов в категорию
  • name – [Строка] – Название категории
  • position – [Число] – Какой по порядку идет категория
  • description – [Строка] – Описание категории
  • access2page – [Массив] – Группы, имеющие возможность скачивать файлы
  • entry_count – [Число] – Количество материалов в категории
  • access2category – [Массив] – Какие группы имеют доступ к просмотру категории
  • id – [Число] – ID категории
  • type – [Строка] – Что это именно (category)
  • hgu_title – [Строка] – ЧПУ категории

Особенности

1) HGU (ЧПУ) нельзя установить при добавлении категории

<?php require 'uAPImodule.php'; $request = new Request(array( 'oauth_consumer_key' => 'Мой consumer_key', 'oauth_consumer_secret' => 'Мой consumer_secret', 'oauth_token' => 'Мой token', 'oauth_token_secret' => 'Мой token_secret' )); $response = $request->post('/news/category', array( 'name' => 'Новая категория из АПИ', 'description' => 'Описание категории из АПИ', 'file' => '@cat_image.webp' )); print_r($response); //Получаем ответ curl -i -X POST --data-urlencode "oauth_consumer_key=ЗНАЧЕНИЕ" --data-urlencode "oauth_nonce=значение" --data-urlencode "oauth_signature_method=HMAC-SHA1" --data-urlencode "oauth_timestamp=значение" --data-urlencode "oauth_version=1.0" --data-urlencode "oauth_token=значение" --data-urlencode "auth_signature=значение" --data "name=Новая категория из АПИ" --data-urlencode "description=Описание категории из АПИ" http://yoursite.ucoz.ru/uapi/news/category
{ "access2add":[ { "4":"Администраторы" } ], "name":"Новая категория из АПИ", "position":4, "description":null, "access2page":[ { "4":"Администраторы" } ], "entry_count":0, "access2category":[ { "4":"Администраторы" } ], "id":5, "type":"category", "hgu_title":"novaja_kategorija_iz_api" } { "access2add":[ { "4":"Администраторы" } ], "name":"Новая категория из АПИ", "position":4, "description":null, "access2page":[ { "4":"Администраторы" } ], "entry_count":0, "access2category":[ { "4":"Администраторы" } ], "id":5, "type":"category", "hgu_title":"novaja_kategorija_iz_api" }
 

[PUT] Отредактировать категорию


Расшифровка переменных запроса

  • access2add – [Массив] – Права на добавление материалов в категорию
  • name – [Строка] – Название категории
  • position – [Число] – Какой по порядку идет категория
  • description – [Строка] – Описание категории
  • access2page – [Массив] – Группы, имеющие возможность скачивать файлы
  • entry_count – [Число] – Количество материалов в категории
  • access2category – [Массив] – Какие группы имеют доступ к просмотру категории
  • id – [Число] – ID категории
  • type – [Строка] – Что это именно (category)
  • hgu_title – [Строка] – ЧПУ категории
<?php require 'uAPImodule.php'; $request = new Request(array( 'oauth_consumer_key' => 'Мой consumer_key', 'oauth_consumer_secret' => 'Мой consumer_secret', 'oauth_token' => 'Мой token', 'oauth_token_secret' => 'Мой token_secret' )); $response = $request->put('/news/category', array( 'id' => '2', 'name' => 'Категория с новым именем', 'description' => 'Категория с новым описанием', 'access2category' => '3,4', 'hgu_title' => 'newhgu' )); print_r($response); //Получаем ответ curl -i -X PUT --data-urlencode "oauth_consumer_key=ЗНАЧЕНИЕ" --data-urlencode "oauth_nonce=значение" --data-urlencode "oauth_signature_method=HMAC-SHA1" --data-urlencode "oauth_timestamp=значение" --data-urlencode "oauth_version=1.0" --data-urlencode "oauth_token=значение" --data-urlencode "auth_signature=значение" --data "id=2" --data-urlencode "name=Категория с новым именем" --data-urlencode "description=Категория с новым описанием" --data-urlencode "access2category=3,4" --data-urlencode "hgu_title=newhgu" http://yoursite.ucoz.ru/uapi/news/category
{ "access2add":[ "Все группы" ], "name":"Категория с новым именем", "position":1, "description":"Категория с новым описанием", "access2page":[ { "4":"Администраторы" } ], "entry_count":7, "access2category":[ { "3":"Модераторы" }, { "4":"Администраторы" } ], "id":1, "type":"category", "hgu_title":"newhgu" } { "access2add":[ "Все группы" ], "name":"Категория с новым именем", "position":1, "description":"Категория с новым описанием", "access2page":[ { "4":"Администраторы" } ], "entry_count":7, "access2category":[ { "3":"Модераторы" }, { "4":"Администраторы" } ], "id":1, "type":"category", "hgu_title":"newhgu" }
 

[DELETE] Удалить категорию


Особенности

1) После удаления категории – обратное действие по восстановлению невозможно

<?php require 'uAPImodule.php'; $request = new Request(array( 'oauth_consumer_key' => 'Мой consumer_key', 'oauth_consumer_secret' => 'Мой consumer_secret', 'oauth_token' => 'Мой token', 'oauth_token_secret' => 'Мой token_secret' )); $response = $request->delete('/news/category', array( 'id' => '2' )); print_r($response); //Получаем ответ curl -i -X DELETE --data-urlencode "oauth_consumer_key=ЗНАЧЕНИЕ" --data-urlencode "oauth_nonce=значение" --data-urlencode "oauth_signature_method=HMAC-SHA1" --data-urlencode "oauth_timestamp=значение" --data-urlencode "oauth_version=1.0" --data-urlencode "oauth_token=значение" --data-urlencode "auth_signature=значение" --data "id=2" http://yoursite.ucoz.ru/uapi/news/category
{ "success":{ "msg":"Выполнено" } } { "success":{ "msg":"Выполнено" } }

Яндекс.Метрика