Основы uAPI

ads – [Массив] – Информация о запрошенном материале
- other3 – [Строка] – Значение поля "Дополнительное поле 3"
- reads – [Число] – Количество просмотров материала
- other5 – [Строка] – Значение поля "Дополнительное поле 5"
- comments_url – [Строка] – Ссылка на страницу материала с комментариями
- other1 – [Строка] – Значение поля "Дополнительное поле 1"
- rate_num – [Число] – Количество голосов (рейтинг)
- author_email – [Строка] – Email автора материала
- author – [Строка] – Полное имя автора материала
- comments – [Строка] – Позволить оставлять комментарии? (yes/no)
- rating – [Число] – Рейтинг материала (Общая сумма рейтинга/на количество голосов)
- add_date – [Строка] – Время добавления материала
- rate_sum – [Число] – Общая сумма рейтинга
- categories – [Массив] – О категории материала
  - access2upload – Группы, имеющие возможность скачивать файлы
  - url – [Строка] – Ссылка на категорию материала
  - access2add – [Массив] – Права на добавление материалов в категорию
  - name – [Строка] – Название категории материала
  - access2category – [Массив] – Право на просмотр категории материала
  - id – [Число] – ID категории материала
  - description – [Строка] – Описание категории материала
  - image – [Строка] – Ссылка на изображение категории
- id – [Число] – ID полученного материала
- ontop – [Строка] – Показывать материал всегда сверху? (yes/no)
- author_site – [Строка] – Ссылка на сайт автора
- subscribe – [Строка] – Включена ли подписка на комментарии (уведомления) (yes/no)
- other2 – [Строка] – Значение поля "Дополнительное поле 2"
- pending – [Строка] – В ожидани ли активации материал? (yes/no)
- phone – [Строка] – Значение поля "Телефон автора"
- description_type=(html|bb|plain) – [Строка] – Краткое описание материала
- message_type=(html|bb|plain) – [Строка] – Полное описание материала
- entry_url – [Строка] – Полная ссылка на материал
- who_add – [Строка] – Никнейм пользователя, добавивший материал
- sort –
- comments_num – [Число] – Количество добавленных комментариев к материалу
- title – [Строка] – Название материала
- hgu_title – [Строка] – ЧПУ материала
page – [Число] – Количество страниц комментариев
total_ads – [Число] – общее кол-во материалов в модуле
pages_list – [Массив] – Возможные страницы в переключателе комментариев
per_page – [Число] – Количество комментариев на 1 страницу

Особенности

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->get('/stuff', 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/stuff

{
   "ads":[
      {
         "other3":"",
         "reads":0,
         "other5":"",
         "comments_url":"http://yoursite.ucoz.ru/board/kategorija_1/nazvanie_materiala/1-1-0-7#comments",
         "other1":"",
         "loads":0,
         "rate_num":0,
         "author_email":"Email автора",
         "author":"Имя автора",
         "comments":"yes",
         "rating":"0.00",
         "add_date":"2015-01-15 01:56",
         "rate_sum":0,
         "category":{
            "access2upload":[
               "Все группы"
            ],
            "url":"http://yoursite.ucoz.ru/board/kategorija_1/1",
            "access2add":[
               "Все группы"
            ],
            "name":"Категория 1",
            "access2category":[
               "Все группы"
            ],
            "id":1,
            "description":""
         },
         "id":7,
         "ontop":"no",
         "other4":"",
         "author_site":"http://Веб-сайт автора",
         "subscribe":"no",
         "other2":"",
         "pending":"no",
         "phone":"",
         "description_type=bb":"Краткое описание материала",
         "message_type=html":"Полное описание материала",
         "entry_url":"http://yoursite.ucoz.ru/board/kategorija_1/nazvanie_materiala/1-1-0-7",
         "who_add":"Dmitry",
         "sort":0,
         "comments_num":0,
         "title":"Название материала",
         "hgu_title":"nazvanie_materiala"
      },
      {
//информация о материале, например, ID2
      },
       {
//информация о материале, например, ID3
      }
   ],
   "page":1,
   "total_ads":1,
   "pages":"1",
   "per_page":"10"
}

{
   "ads":[
      {
         "other3":"",
         "reads":0,
         "other5":"",
         "comments_url":"http://yoursite.ucoz.ru/board/kategorija_1/nazvanie_materiala/1-1-0-7#comments",
         "other1":"",
         "loads":0,
         "rate_num":0,
         "author_email":"Email автора",
         "author":"Имя автора",
         "comments":"yes",
         "rating":"0.00",
         "add_date":"2015-01-15 01:56",
         "rate_sum":0,
         "category":{
            "access2upload":[
               "Все группы"
            ],
            "url":"http://yoursite.ucoz.ru/board/kategorija_1/1",
            "access2add":[
               "Все группы"
            ],
            "name":"Категория 1",
            "access2category":[
               "Все группы"
            ],
            "id":1,
            "description":""
         },
         "id":7,
         "ontop":"no",
         "other4":"",
         "author_site":"http://Веб-сайт автора",
         "subscribe":"no",
         "other2":"",
         "pending":"no",
         "phone":"",
         "description_type=bb":"Краткое описание материала",
         "message_type=html":"Полное описание материала",
         "entry_url":"http://yoursite.ucoz.ru/board/kategorija_1/nazvanie_materiala/1-1-0-7",
         "who_add":"Dmitry",
         "sort":0,
         "comments_num":0,
         "title":"Название материала",
         "hgu_title":"nazvanie_materiala"
      },
      {
//информация о материале, например, ID2
      },
       {
//информация о материале, например, ID3
      }
   ],
   "page":1,
   "total_ads":1,
   "pages":"1",
   "per_page":"10"
}

[GET] Определенный материал

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

ads

Информация о запрошенном материале

other3 – [Строка] – Значение поля "Дополнительное поле 3"
reads – [Число] – Количество просмотров материала
other5 – [Строка] – Значение поля "Дополнительное поле 5"
comments_url – [Строка] – Ссылка на страницу материала с комментариями
other1 – [Строка] – Значение поля "Дополнительное поле 1"
rate_num – [Число] – Количество голосов (рейтинг)
author_email – [Строка] – Email автора материала
author – [Строка] – Полное имя автора материала
comments – [Строка] – Позволить оставлять комментарии? (yes/no)
rating – [Число] – Рейтинг материала (Общая сумма рейтинга/на количество голосов)
add_date – [Строка] – Время добавления материала
rate_sum – [Число] – Общая сумма рейтинга

categories

О категории материала

access2upload – Группы, имеющие возможность скачивать файлы
url – [Строка] – Ссылка на категорию материала
access2add – [Массив] – Права на добавление материалов в категорию
name – [Строка] – Название категории материала
access2category – [Массив] – Право на просмотр категории материала
id – [Число] – ID категории материала
description – [Строка] – Описание категории материала
image – [Строка] – Ссылка на изображение категории

id – [Число] – ID полученного материала
ontop – [Строка] – Показывать материал всегда сверху? (yes/no)
author_site – [Строка] – Ссылка на сайт автора
subscribe – [Строка] – Включена ли подписка на комментарии (уведомления) (yes/no)
other2 – [Строка] – Значение поля "Дополнительное поле 2"
pending – [Строка] – В ожидани ли активации материал? (yes/no)
phone – [Строка] – Значение поля "Телефон автора"
description_type=(html|bb|plain) – [Строка] – Краткое описание материала
message_type=(html|bb|plain) – [Строка] – Полное описание материала
entry_url – [Строка] – Полная ссылка на материал
who_add – [Строка] – Никнейм пользователя, добавивший материал
sort –
comments_num – [Число] – Количество добавленных комментариев к материалу
title – [Строка] – Название материала
hgu_title – [Строка] – ЧПУ материала
prev_entry_url - [Строка] - Полная ссылка на предыдущий материал
next_entry_url - [Строка] - Полная ссылка на следующий материал

Особенности

1) В переменных description и message переносы строк автоматически меняются на \n (в случае, если перенос строки был сделан без html-тега )
2) В переменных description и message если там есть html-тег переноса – будет осуществлен и визуальный перенос строки, без вывода (то есть html-тег воспроизведется)
3) Переменные access2category и access2add могут иметь другой вид, если права установлены для всех групп пользователей
4) Если у материала категория входит в раздел – то раздел никак не будет получен в GET-запросе
5) Если материал входит в более 1 категории, то о каждой категории, в которые входит материал, будет показана информация в GET-запросе

<?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('/stuff', 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/stuff

{
    "ads":[
        {
            "other3":"",
            "files":[
                {
                    "small":"http://yoursite.ucoz.ru/_sf/0/s57172723.jpg",
                    "full_height":1200,
                    "full_width":1000,
                    "small_height":150,
                    "small_width":125,
                    "full":"http://yoursite.ucoz.ru/_sf/0/57172723.jpg"
                }
            ],
            "reads":0,
            "other5":"",
            "comments_url":"http://yoursite.ucoz.ru/board/kategorija_1/nazvanie_materiala/1-1-0-7#comments",
            "other1":"",
            "loads":0,
            "rate_num":0,
            "author_email":"Email автора",
            "author":"Имя автора",
            "comments":"yes",
            "rating":"0.00",
            "add_date":"2015-01-15 01:56",
            "rate_sum":0,
            "category":{
                "access2upload":[
                    "Все группы"
                ],
                "url":"http://yoursite.ucoz.ru/board/kategorija_1/1",
                "access2add":[
                    "Все группы"
                ],
                "name":"Категория 1",
                "access2category":[
                    "Все группы"
                ],
                "id":1,
                "description":""
            },
            "id":7,
            "ontop":"no",
            "other4":"",
            "author_site":"http://Веб-сайт автора",
            "subscribe":"no",
            "other2":"",
            "pending":"no",
            "phone":"",
            "description_type=bb":"Краткое описание материала",
            "message_type=html":"Полное описание материала",
            "entry_url":"http://yoursite.ucoz.ru/board/kategorija_1/nazvanie_materiala/1-1-0-7",
            "who_add":"Dmitry",
            "sort":0,
            "comments_num":0,
            "title":"Название материала",
            "hgu_title":"nazvanie_materiala",
            "prev_entry_url":"https://yoursite.ucoz.ru/board/kategorija_1/nazvanie_materiala/1-1-0-6",
            "next_entry_url":"https://yoursite.ucoz.ru/board/kategorija_1/nazvanie_materiala/1-1-0-8"
        }
    ]
}

{
    "ads":[
        {
            "other3":"",
            "files":[
                {
                    "small":"http://yoursite.ucoz.ru/_sf/0/s57172723.jpg",
                    "full_height":1200,
                    "full_width":1000,
                    "small_height":150,
                    "small_width":125,
                    "full":"http://yoursite.ucoz.ru/_sf/0/57172723.jpg"
                }
            ],
            "reads":0,
            "other5":"",
            "comments_url":"http://yoursite.ucoz.ru/board/kategorija_1/nazvanie_materiala/1-1-0-7#comments",
            "other1":"",
            "loads":0,
            "rate_num":0,
            "author_email":"Email автора",
            "author":"Имя автора",
            "comments":"yes",
            "rating":"0.00",
            "add_date":"2015-01-15 01:56",
            "rate_sum":0,
            "category":{
                "access2upload":[
                    "Все группы"
                ],
                "url":"http://yoursite.ucoz.ru/board/kategorija_1/1",
                "access2add":[
                    "Все группы"
                ],
                "name":"Категория 1",
                "access2category":[
                    "Все группы"
                ],
                "id":1,
                "description":""
            },
            "id":7,
            "ontop":"no",
            "other4":"",
            "author_site":"http://Веб-сайт автора",
            "subscribe":"no",
            "other2":"",
            "pending":"no",
            "phone":"",
            "description_type=bb":"Краткое описание материала",
            "message_type=html":"Полное описание материала",
            "entry_url":"http://yoursite.ucoz.ru/board/kategorija_1/nazvanie_materiala/1-1-0-7",
            "who_add":"Dmitry",
            "sort":0,
            "comments_num":0,
            "title":"Название материала",
            "hgu_title":"nazvanie_materiala",
            "prev_entry_url":"https://yoursite.ucoz.ru/board/kategorija_1/nazvanie_materiala/1-1-0-6",
            "next_entry_url":"https://yoursite.ucoz.ru/board/kategorija_1/nazvanie_materiala/1-1-0-8"
        }
    ]
}

//для особенности 3
"access2add":[
"Все группы"
],
//для особенности 3
"access2category":[
"Все группы"
],

//для особенности 3
"access2add":[
"Все группы"
],
//для особенности 3
"access2category":[
"Все группы"
],

[GET] Из определенной категории

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

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

ads

Информация о запрошенном материале

other3 – [Строка] – Значение поля "Дополнительное поле 3"
reads – [Число] – Количество просмотров материала
other5 – [Строка] – Значение поля "Дополнительное поле 5"
comments_url – [Строка] – Ссылка на страницу материала с комментариями
other1 – [Строка] – Значение поля "Дополнительное поле 1"
rate_num – [Число] – Количество голосов (рейтинг)
author_email – [Строка] – Email автора материала
author – [Строка] – Полное имя автора материала
comments – [Строка] – Позволить оставлять комментарии? (yes/no)
rating – [Число] – Рейтинг материала (Общая сумма рейтинга/на количество голосов)
add_date – [Строка] – Время добавления материала
rate_sum – [Число] – Общая сумма рейтинга

categories

О категории материала

access2upload – Группы, имеющие возможность скачивать файлы
url – [Строка] – Ссылка на категорию материала
access2add – [Массив] – Права на добавление материалов в категорию
name – [Строка] – Название категории материала
access2category – [Массив] – Право на просмотр категории материала
id – [Число] – ID категории материала
description – [Строка] – Описание категории материала
image – [Строка] – Ссылка на изображение категории

id – [Число] – ID полученного материала
ontop – [Строка] – Показывать материал всегда сверху? (yes/no)
author_site – [Строка] – Ссылка на сайт автора
subscribe – [Строка] – Включена ли подписка на комментарии (уведомления) (yes/no)
other2 – [Строка] – Значение поля "Дополнительное поле 2"
pending – [Строка] – В ожидани ли активации материал? (yes/no)
phone – [Строка] – Значение поля "Телефон автора"
description_type=(html|bb|plain) – [Строка] – Краткое описание материала
message_type=(html|bb|plain) – [Строка] – Полное описание материала
entry_url – [Строка] – Полная ссылка на материал
who_add – [Строка] – Никнейм пользователя, добавивший материал
sort –
comments_num – [Число] – Количество добавленных комментариев к материалу
title – [Строка] – Название материала
hgu_title – [Строка] – ЧПУ материала

page – [Число] – Количество страниц комментариев
total_ads – [Число] – общее кол-во материалов в модуле
pages_list – [Массив] – Возможные страницы в переключателе комментариев
per_page – [Число] – Количество комментариев на 1 страницу

categories

О категории материала

access2upload – Группы, имеющие возможность скачивать файлы
url – [Строка] – Ссылка на категорию материала
access2add – [Массив] – Права на добавление материалов в категорию
name – [Строка] – Название категории материала
access2category – [Массив] – Право на просмотр категории материала
id – [Число] – ID категории материала
description – [Строка] – Описание категории материала

Особенности

1) Чтобы получить данные материалов со страницы 2, достаточно добавить к URL параметр &page=N (где N – номер страницы)
2) Сколько материалов будет выдано за запрос – зависит от настроек модуля (Панель управления → Онлайн игры → Настройки модуля → Количество материалов на странице в разделе).

<?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('/stuff', array(
    'category' => 'АЙДИМКАТЕГОРИИ'
));
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-urlencode "category=АЙДИКАТЕГОРИИ" http://youresite.ucoz.ru/uapi/stuff

{
   "ads":[
      {
         "other3":"",
         "reads":0,
         "other5":"",
         "comments_url":"http://yoursite.ucoz.ru/board/kategorija_1/nazvanie_materiala/1-1-0-7#comments",
         "other1":"",
         "loads":0,
         "rate_num":0,
         "author_email":"Email автора",
         "author":"Имя автора",
         "comments":"yes",
         "rating":"0.00",
         "add_date":"2015-01-15 01:56",
         "rate_sum":0,
         "id":7,
         "ontop":"no",
         "other4":"",
         "author_site":"http://Веб-сайт автора",
         "subscribe":"no",
         "other2":"",
         "pending":"no",
         "description":"Краткое описание материала",
         "phone":"",
         "message":"Полное описание материала",
         "entry_url":"http://yoursite.ucoz.ru/board/kategorija_1/nazvanie_materiala/1-1-0-7",
         "who_add":"Dmitry",
         "sort":0,
         "comments_num":0,
         "title":"Название материала",
         "hgu_title":"nazvanie_materiala"
      },
      {
//информация о материале, например, ID2
      },
       {
//информация о материале, например, ID3
      }
   ],
   "page":1,
   "total_ads":1,
   "pages":"1",
   "per_page":"20",
   "category":{
      "access2upload":[
         "Все группы"
      ],
      "url":"http://yoursite.ucoz.ru/board/kategorija_1/1",
      "access2add":[
         "Все группы"
      ],
      "name":"Категория 1",
      "access2category":[
         "Все группы"
      ],
      "id":1,
      "description":""
   }
}

{
   "ads":[
      {
         "other3":"",
         "reads":0,
         "other5":"",
         "comments_url":"http://yoursite.ucoz.ru/board/kategorija_1/nazvanie_materiala/1-1-0-7#comments",
         "other1":"",
         "loads":0,
         "rate_num":0,
         "author_email":"Email автора",
         "author":"Имя автора",
         "comments":"yes",
         "rating":"0.00",
         "add_date":"2015-01-15 01:56",
         "rate_sum":0,
         "id":7,
         "ontop":"no",
         "other4":"",
         "author_site":"http://Веб-сайт автора",
         "subscribe":"no",
         "other2":"",
         "pending":"no",
         "description":"Краткое описание материала",
         "phone":"",
         "message":"Полное описание материала",
         "entry_url":"http://yoursite.ucoz.ru/board/kategorija_1/nazvanie_materiala/1-1-0-7",
         "who_add":"Dmitry",
         "sort":0,
         "comments_num":0,
         "title":"Название материала",
         "hgu_title":"nazvanie_materiala"
      },
      {
//информация о материале, например, ID2
      },
       {
//информация о материале, например, ID3
      }
   ],
   "page":1,
   "total_ads":1,
   "pages":"1",
   "per_page":"20",
   "category":{
      "access2upload":[
         "Все группы"
      ],
      "url":"http://yoursite.ucoz.ru/board/kategorija_1/1",
      "access2add":[
         "Все группы"
      ],
      "name":"Категория 1",
      "access2category":[
         "Все группы"
      ],
      "id":1,
      "description":""
   }
}

<?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('/stuff', array(
      'category' => 'АЙДИМКАТЕГОРИИ'
      'page' => '2'
));
print_r($response); //Получаем ответ

//для особенности 1
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-urlencode "category=АЙДИКАТЕГОРИИ" http://youresite.ucoz.ru/uapi/stuff?page=2

[POST] Добавить материал

Обязательные параметры: зависит от настроек модуля

Параметры для запроса

other3 – [Строка] – Значение поля "Дополнительное поле 3"
file1 – [Файл] – Изображение материала (в случае, если нужно несколько, то file2, file3)
end2br_msg – [Строка] – Статус опции "Заменять теги переноса на " для полного описания материала (yes/no)
other5 – [Строка] – Значение поля "Дополнительное поле 5"
other1 – [Строка] – Значение поля "Дополнительное поле 1"
author_email – [Строка] – Email автора материала
name – [Строка] – Поле "Контактное лицо",
filters – [Массив] – В какие фильтры входит материал
comments – [Строка] – Позволить оставлять комментарии? (yes/no)
end2br_desc – [Строка] – Статус опции "Заменять теги переноса на " для краткого описания материала (yes/no)
ad_type – [Строка] – Тип объявления [Фильтр]

categories

О категории материала

access2upload – Группы, имеющие возможность скачивать файлы
url – [Строка] – Ссылка на категорию материала
access2add – [Массив] – Права на добавление материалов в категорию
name – [Строка] – Название категории материала
access2category – [Массив] – Право на просмотр категории материала
id – [Число] – ID категории материала
description – [Строка] – Описание категории материала

other4 – [Строка] – Значение поля "Дополнительное поле 4"
ontop – [Строка] – Показывать материал всегда сверху? (yes/no)
includehtml_desc – [Строка] – Включить HTML-теги для краткого описания материала? (yes/no)
author_phone – [Строка] – Номер телефона автора объявления
author_site – [Строка] – Ссылка на сайт автора
subscribe – [Строка] – Включена ли подписка на комментарии (уведомления) (yes/no)
other2 – [Строка] – Значение поля "Дополнительное поле 2"
pending – [Строка] – В ожидани ли активации материал? (yes/no)
description_type=(html|bb|plain) – [Строка] – Краткое описание материала
message_type=(html|bb|plain) – [Строка] – Полное описание материала
who_add – [Строка] – Никнейм пользователя, добавивший материал
till_date – [Строка] – До какого числа объявление активно (timestamp)
sort –
title – [Строка] – Название материала
includehtml_msg – [Строка] – Включить HTML-теги для полного описания материала? (yes/no)
hgu_title – [Строка] – ЧПУ материала

Особенности

1) HGU (ЧПУ) нельзя установить при добавлении материала
2) Все обязательные параметры исключительно определяются в Панели управления: Каталог статей – Настройки модуля. Но категория всегда является обязательной

<?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('/stuff', array(
      'category' => '1',
      'title' => 'Название материала',
      'description_type=bb' => 'Краткое описание материала',
      'message_type=html' => 'Полное описание материала',
      'author_site' => 'Веб-сайт автора',
      'author_email' => 'Email автора',
      'author' => 'Имя автора',
      'link2source' => 'Источник материала',
      'file1' => '@dm.png'
));
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 "category=3" --data-urlencode "title=Новое название" --data-urlencode "description=Краткое описание" --data-urlencode "message=Полное описание" --data-urlencode "author=Дмитрий Неизвестный" --data-urlencode "link2source=http://ucoz.ru/" --data-urlencode "author_email=api@api.ru" --data "end2br_desc=1&includehtml_desc=no" http://yoursite.ucoz.ru/uapi/stuff

{
   "other3":null,
    "files":[
      {
         "small":"http://yoursite.ucoz.ru/_sf/0/s57172723.jpg",
         "full_height":1200,
         "full_width":1000,
         "small_height":150,
         "small_width":125,
         "full":"http://yoursite.ucoz.ru/_sf/0/57172723.jpg"
      }
   ],
   "end2br_msg":"no",
   "other5":null,
   "other1":null,
   "author_email":"Email автора",
   "author":"Имя автора",
   "filters":{
      "Тип объявления":[

      ]
   },
   "comments":"yes",
   "end2br_desc":"no",
   "ad_type":[
      null
   ],
   "category":{
      "access2upload":[
         "Все группы"
      ],
      "url":"http://yoursite.ucoz.ru/board/kategorija_1/1",
      "access2add":[
         "Все группы"
      ],
      "name":"Категория 1",
      "access2category":[
         "Все группы"
      ],
      "id":1,
      "description":""
   },
   "other4":null,
   "ontop":"no",
   "includehtml_desc":"no",
   "author_phone":null,
   "author_site":"http://Веб-сайт автора",
   "subscribe":"no",
   "other2":null,
   "pending":"no",
   "description_type=bb":"Краткое описание материала",
   "message_type=html":"Полное описание материала",
   "who_add":"Dmitry",
   "till_date":"1424385354",
   "sort":"",
   "title":"Название материала",
   "includehtml_msg":"no",
   "hgu_title":"nazvanie_materiala"
}

{
   "other3":null,
    "files":[
      {
         "small":"http://yoursite.ucoz.ru/_sf/0/s57172723.jpg",
         "full_height":1200,
         "full_width":1000,
         "small_height":150,
         "small_width":125,
         "full":"http://yoursite.ucoz.ru/_sf/0/57172723.jpg"
      }
   ],
   "end2br_msg":"no",
   "other5":null,
   "other1":null,
   "author_email":"Email автора",
   "author":"Имя автора",
   "filters":{
      "Тип объявления":[

      ]
   },
   "comments":"yes",
   "end2br_desc":"no",
   "ad_type":[
      null
   ],
   "category":{
      "access2upload":[
         "Все группы"
      ],
      "url":"http://yoursite.ucoz.ru/board/kategorija_1/1",
      "access2add":[
         "Все группы"
      ],
      "name":"Категория 1",
      "access2category":[
         "Все группы"
      ],
      "id":1,
      "description":""
   },
   "other4":null,
   "ontop":"no",
   "includehtml_desc":"no",
   "author_phone":null,
   "author_site":"http://Веб-сайт автора",
   "subscribe":"no",
   "other2":null,
   "pending":"no",
   "description_type=bb":"Краткое описание материала",
   "message_type=html":"Полное описание материала",
   "who_add":"Dmitry",
   "till_date":"1424385354",
   "sort":"",
   "title":"Название материала",
   "includehtml_msg":"no",
   "hgu_title":"nazvanie_materiala"
}

[POST] Добавить тег к материалу

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

Обратите внимание, что именно таким образом (с помощью POST-запроса) осуществляется добавление, редактирование и удаление тегов к материалу.
1) Если вам требуется удалить теги, достаточно отправить пустой запрос
2) Если вам требуется отредактировать теги, сделайте полный запрос с теми тегами, которые должны остаться
3) Если требуется добавить новые теги, необходимо ввести список существующих + новые теги

Теги необходимо перечислять через запятую

Ответ сервера не предполагает возврата данных о материале – только сообщение об операции

<?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('/stuff/tags', array(
    'id' => '1',
    'tags' => 'тег1,тест2'
));
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 "category=3" --data-urlencode "title=Новое название" --data-urlencode "description=Краткое описание" --data-urlencode "message=Полное описание" --data-urlencode "author=Дмитрий Неизвестный" --data-urlencode "link2source=http://ucoz.ru/" --data-urlencode "author_email=api@api.ru" --data "end2br_desc=1&includehtml_desc=no" http://yoursite.ucoz.ru/uapi/stuff

{
   "success":{
      "msg":"Данные по тегам материала обновлены"
   }
}

{
   "success":{
      "msg":"Данные по тегам материала обновлены"
   }
}

[PUT] Отредактировать материал

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

Параметры для запроса

other3 – [Строка] – Значение поля "Дополнительное поле 3"
file1 – [Файл] – Изображение материала (в случае, если нужно несколько, то file2, file3)
end2br_msg – [Строка] – Статус опции "Заменять теги переноса на " для полного описания материала (yes/no)
other5 – [Строка] – Значение поля "Дополнительное поле 5"
other1 – [Строка] – Значение поля "Дополнительное поле 1"
author_email – [Строка] – Email автора материала
author – [Строка] – Полное имя автора материала
filters – [Массив] – В какие фильтры входит материал
comments – [Строка] – Позволить оставлять комментарии? (yes/no)
end2br_desc – [Строка] – Статус опции "Заменять теги переноса на " для краткого описания материала (yes/no)
ad_type – [Строка] – Тип объявления [Фильтр]

categories

О категории материала

access2upload – Группы, имеющие возможность скачивать файлы
url – [Строка] – Ссылка на категорию материала
access2add – [Массив] – Права на добавление материалов в категорию
name – [Строка] – Название категории материала
access2category – [Массив] – Право на просмотр категории материала
id – [Число] – ID категории материала
description – [Строка] – Описание категории материала

other4 – [Строка] – Значение поля "Дополнительное поле 4"
ontop – [Строка] – Показывать материал всегда сверху? (yes/no)
includehtml_desc – [Строка] – Включить HTML-теги для краткого описания материала? (yes/no)
author_phone – [Строка] – Номер телефона автора объявления
author_site – [Строка] – Ссылка на сайт автора
subscribe – [Строка] – Включена ли подписка на комментарии (уведомления) (yes/no)
other2 – [Строка] – Значение поля "Дополнительное поле 2"
pending – [Строка] – В ожидани ли активации материал? (yes/no)
description_type=(html|bb|plain) – [Строка] – Краткое описание материала
message_type=(html|bb|plain) – [Строка] – Полное описание материала
who_add – [Строка] – Никнейм пользователя, добавивший материал
till_date – [Строка] – До какого числа объявление активно (timestamp)
sort –
title – [Строка] – Название материала
includehtml_msg – [Строка] – Включить HTML-теги для полного описания материала? (yes/no)
hgu_title – [Строка] – ЧПУ материала

Особенности

1) Если отсылается запрос с пустым параметром – то это означает удаление значения параметра
2) Если при запросе вы не указали какой-либо параметр – он останется со своим прежним значением

<?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('/stuff', array(
    'id' => '188',
    'title' => 'Новое название материала',
    'description_type=bb' => 'Новое краткое описание материала',
    'message_type=html' => 'Новое полное описание материала',
    'author_site' => 'Новый веб-сайт автора',
    'author_email' => 'Новый email автора',
    'author' => 'Новое имя автора',
    'link2source' => 'Новый источник материала',
    'file1' => '@dm.png'
));
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=3" --data-urlencode "title=Новое название" http://yoursite.ucoz.ru/uapi/stuff

{
   "end2br_msg":"no",
    "files":[
      {
         "small":"http://yoursite.ucoz.ru/_sf/0/s57172723.jpg",
         "full_height":1200,
         "full_width":1000,
         "small_height":150,
         "small_width":125,
         "full":"http://yoursite.ucoz.ru/_sf/0/57172723.jpg"
      }
   ],
   "author_email":"Новый email автора",
   "author":"Новое имя автора",
   "comments":"yes",
   "end2br_desc":"no",
   "ontop":"no",
   "includehtml_desc":"yes",
   "author_site":"http://Новый веб-сайт автора",
   "subscribe":"no",
   "link2source":"http://Новый источник материала",
   "pending":"no",
   "categories":[
      {
         "access2upload":[
            {
               "4":"Администраторы"
            }
         ],
         "url":"http://yoursite.ucoz.ru/stuff/1",
         "access2add":[
            "Все группы"
         ],
         "name":"Мои статьи",
         "access2category":[
            "Все группы"
         ],
         "id":1,
         "description":"test"
      }
   ],
   "description":"Новое краткое описание материала",
   "message":"Новое полное описание материала",
   "who_add":"yoursite",
   "title":"Новое название материала",
   "includehtml_msg":"yes",
   "hgu_title":"nazvanie_materiala"
}

{
   "end2br_msg":"no",
    "files":[
      {
         "small":"http://yoursite.ucoz.ru/_sf/0/s57172723.jpg",
         "full_height":1200,
         "full_width":1000,
         "small_height":150,
         "small_width":125,
         "full":"http://yoursite.ucoz.ru/_sf/0/57172723.jpg"
      }
   ],
   "author_email":"Новый email автора",
   "author":"Новое имя автора",
   "comments":"yes",
   "end2br_desc":"no",
   "ontop":"no",
   "includehtml_desc":"yes",
   "author_site":"http://Новый веб-сайт автора",
   "subscribe":"no",
   "link2source":"http://Новый источник материала",
   "pending":"no",
   "categories":[
      {
         "access2upload":[
            {
               "4":"Администраторы"
            }
         ],
         "url":"http://yoursite.ucoz.ru/stuff/1",
         "access2add":[
            "Все группы"
         ],
         "name":"Мои статьи",
         "access2category":[
            "Все группы"
         ],
         "id":1,
         "description":"test"
      }
   ],
   "description":"Новое краткое описание материала",
   "message":"Новое полное описание материала",
   "who_add":"yoursite",
   "title":"Новое название материала",
   "includehtml_msg":"yes",
   "hgu_title":"nazvanie_materiala"
}

[DELETE] Удалить материал

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

Обратите внимание, что удаление материала происходит навсегда, его возврат невозможен.

Ответ сервера не предполагает возврата данных о материале – только сообщение об операции

<?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('/board/posts', array(
'id' => '1'
));
print_r($response); //Получаем ответ

url -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=1" http://yoursite.ucoz.ru/uapi/board/posts

{
"success":{
"msg":"Материал удалён"
}
}

{
"success":{
"msg":"Материал удалён"
}
}