Основы uAPI

<?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] Определенную категорию

Обязательный параметр: ID (айди категории)

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

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] Отредактировать категорию

Обязательные параметры: ID категории

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

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] Удалить категорию

Обязательные параметры: ID категории

Особенности

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":"Выполнено"
   }
}