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

[GET] Все материалы модуля


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

  • page – [Число] – Количество страниц комментариев
  • pages_list – [Массив] – Возможные страницы в переключателе комментариев
  • per_page – [Число] – Количество комментариев на 1 страницу
  • total_loads – [Число] – Количество материалов в модуле
    •  loads – [Массив] – О материалах модуля
    • loads – [Число] – Количество загрузок файла
    • rate_num – [Число] – Количество голосов (рейтинг)
    • author_email – [Строка] – Email автора материала
    • filters – [Массив] – В какие фильтры входит материал
    • archlink_direct – [Строка] – Ссылка для скачивания архива с другого сервера (чистое значение)
    • comments – [Строка] – Позволить оставлять комментарии? (yes/no)
    • os – [Массив] – Значение поля "Операционная Система"
    • rate_sum – [Число] – Общая сумма рейтинга
    • id – [Число] – ID полученного материала
      •   category – [Массив] – О категории
      • access2upload – Группы, имеющие возможность скачивать файлы
      • url – [Строка] – Ссылка на категорию материала
      • access2add – [Массив] – Права на добавление материалов в категорию
      • name – [Строка] – Название категории материала
      • access2category – [Массив] – Право на просмотр категории материала
      • id – [Число] – ID категории материала
      • description – [Строка] – Описание категории материала
    • ontop – [Строка] – Показывать материал всегда сверху? (yes/no)
    • author_site – [Строка] – Ссылка на сайт автора
    • subscribe – [Строка] – Включена ли подписка на комментарии (уведомления) (yes/no)
    • pending – [Строка] – В ожидани ли активации материал? (yes/no)
    • description_type=(html|bb|plain) – [Строка] – Краткое описание материала
    • title – [Строка] – Название материала
    • archlink – [Строка]
    • reads – [Число] – Количество просмотров материала
    • comments_url – [Строка] – Ссылка на страницу материала с комментариями
    • proglink – [Строка] – Ссылка на источник материала
      • section – [Массив] – Информации о разделе, которой принадлежит категория
      • url – [Строка] – Ссылка на раздел, в который входит категория материала
      • name – [Строка] – Название раздела
      • url – [Строка] – Ссылка на категорию, куда был добавлен материал
      • access2section – [Массив] – Какие группы имеют доступ к просмотру раздела
      • id – [Число] – ID раздела
    • author – [Строка] – Никнейм пользователя, оставившего комментарий
    • rating – [Число] – Рейтинг материала (Общая сумма рейтинга/на количество голосов)
    • versions – [Строка] – Значение поля "Версия материала"
    • add_date – [Строка] – Время добавления материала
    • language – [Массив] – Выбор из пункта "Язык платформы"
    • entry_url – [Строка] – Полная ссылка на материал
    • who_add – [Строка] – Никнейм пользователя, добавивший материал
    • sort
    • comments_num – [Число] – Количество добавленных комментариев к материалу
    • screenshot – [Строка] – Прямая ссылка на скриншот
    • doclink – [Строка] – Ссылка на страницу документации к материалу
    • hgu_title – [Строка] – ЧПУ материала

Особенности

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
{ "page":1, "pages":"1", "per_page":"10", "total_loads":1, "loads":[ { "loads":99, "rate_num":4, "author_email":"E-mail", "filters":{ "Супер фильтр":[ "Фильтр 1" ] }, "comments":"yes", "os":[ "Multi-Platform", "Windows 7", "Mac OS" ], "rate_sum":100, "id":1, "category":{ "access2upload":[ { "1":"Пользователи" }, { "2":"Проверенные" }, { "3":"Модераторы" }, { "5":"Новая группа" }, { "251":"Друзья" }, { "999":"Гости" } ], "url":"http://yoursite.ucoz.ru/load/kategorija_u_razdela/3", "access2add":[ "Все группы" ], "name":"Категория у раздела", "access2category":[ "Все группы" ], "id":3, "description":"" }, "ontop":"no", "author_site":"http://Web-site", "subscribe":"no", "pending":"no", "description":"Краткое описание", "title":"Название материала", "archlink":"", "reads":11, "comments_url":"http://yoursite.ucoz.ru/load/kategorija_u_razdela/nazvanie_materiala/3-1-0-1#comments", "proglink":"http://Ссылка на источник материала", "section":{ "url":"http://yoursite.ucoz.ru/load/razdel/2", "name":"newtestname", "access2section":[ "Все группы" ], "id":2 }, "author":"Полное имя", "rating":"9.99", "versions":"версия материала", "add_date":"2014-11-20 07:56", "language":[ "Русский", "Английский" ], "entry_url":"http://yoursite.ucoz.ru/load/kategorija_u_razdela/nazvanie_materiala/3-1-0-1", "who_add":"Dmitry", "sort":0, "comments_num":0, "screenshot":"", "doclink":"http://Ссылка на страницу документации к материалу", "hgu_title":"nazvanie_materiala" } ] } { "page":1, "pages":"1", "per_page":"10", "total_loads":1, "loads":[ { "loads":99, "rate_num":4, "author_email":"E-mail", "filters":{ "Супер фильтр":[ "Фильтр 1" ] }, "comments":"yes", "os":[ "Multi-Platform", "Windows 7", "Mac OS" ], "rate_sum":100, "id":1, "category":{ "access2upload":[ { "1":"Пользователи" }, { "2":"Проверенные" }, { "3":"Модераторы" }, { "5":"Новая группа" }, { "251":"Друзья" }, { "999":"Гости" } ], "url":"http://yoursite.ucoz.ru/load/kategorija_u_razdela/3", "access2add":[ "Все группы" ], "name":"Категория у раздела", "access2category":[ "Все группы" ], "id":3, "description":"" }, "ontop":"no", "author_site":"http://Web-site", "subscribe":"no", "pending":"no", "description":"Краткое описание", "title":"Название материала", "archlink":"", "reads":11, "comments_url":"http://yoursite.ucoz.ru/load/kategorija_u_razdela/nazvanie_materiala/3-1-0-1#comments", "proglink":"http://Ссылка на источник материала", "section":{ "url":"http://yoursite.ucoz.ru/load/razdel/2", "name":"newtestname", "access2section":[ "Все группы" ], "id":2 }, "author":"Полное имя", "rating":"9.99", "versions":"версия материала", "add_date":"2014-11-20 07:56", "language":[ "Русский", "Английский" ], "entry_url":"http://yoursite.ucoz.ru/load/kategorija_u_razdela/nazvanie_materiala/3-1-0-1", "who_add":"Dmitry", "sort":0, "comments_num":0, "screenshot":"", "doclink":"http://Ссылка на страницу документации к материалу", "hgu_title":"nazvanie_materiala" } ] }
 

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


       loads – [Массив] – О материалах модуля
    • loads – [Число] – Количество загрузок файла
    • rate_num – [Число] – Количество голосов (рейтинг)
    • author_email – [Строка] – Email автора материала
    • filters – [Массив] – В какие фильтры входит материал
    • archlink_direct – [Строка] – Ссылка для скачивания архива с другого сервера (чистое значение)
    • comments – [Строка] – Позволить оставлять комментарии? (yes/no)
    • os – [Массив] – Значение поля "Операционная Система"
    • rate_sum – [Число] – Общая сумма рейтинга
    • id – [Число] – ID полученного материала
      •   category – [Массив] – О категории
      • access2upload – Группы, имеющие возможность скачивать файлы
      • url – [Строка] – Ссылка на категорию материала
      • access2add – [Массив] – Права на добавление материалов в категорию
      • name – [Строка] – Название категории материала
      • access2category – [Массив] – Право на просмотр категории материала
      • id – [Число] – ID категории материала
      • description – [Строка] – Описание категории материала
    • ontop – [Строка] – Показывать материал всегда сверху? (yes/no)
    • author_site – [Строка] – Ссылка на сайт автора
    • subscribe – [Строка] – Включена ли подписка на комментарии (уведомления) (yes/no)
    • pending – [Строка] – В ожидани ли активации материал? (yes/no)
    • description_type=(html|bb|plain) – [Строка] – Краткое описание материала
    • title – [Строка] – Название материала
    • archlink – [Строка]
    • reads – [Число] – Количество просмотров материала
    • comments_url – [Строка] – Ссылка на страницу материала с комментариями
    • proglink – [Строка] – Ссылка на источник материала
      • section – [Массив] – Информации о разделе, которой принадлежит категория
      • url – [Строка] – Ссылка на раздел, в который входит категория материала
      • name – [Строка] – Название раздела
      • url – [Строка] – Ссылка на категорию, куда был добавлен материал
      • access2section – [Массив] – Какие группы имеют доступ к просмотру раздела
      • id – [Число] – ID раздела
    • author – [Строка] – Никнейм пользователя, оставившего комментарий
    • rating – [Число] – Рейтинг материала (Общая сумма рейтинга/на количество голосов)
    • versions – [Строка] – Значение поля "Версия материала"
    • add_date – [Строка] – Время добавления материала
    • language – [Массив] – Выбор из пункта "Язык платформы"
    • entry_url – [Строка] – Полная ссылка на материал
    • who_add – [Строка] – Никнейм пользователя, добавивший материал
    • sort
    • comments_num – [Число] – Количество добавленных комментариев к материалу
    • screenshot – [Строка] – Прямая ссылка на скриншот
    • doclink – [Строка] – Ссылка на страницу документации к материалу
    • hgu_title – [Строка] – ЧПУ материала

Особенности

1) В переменных description и message переносы строк автоматически меняются на \n (в случае, если перенос строки был сделан без html-тега <br />)
2) В переменных description и message если там есть html-тег переноса <br /> – будет осуществлен и визуальный перенос строки, без вывода <br /> (то есть 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
{ "loads":[ { "loads":99, "rate_num":4, "author_email":"E-mail", "filters":{ "Супер фильтр":[ "Фильтр 1" ] }, "comments":"yes", "os":[ "Multi-Platform", "Windows 7", "Mac OS" ], "rate_sum":100, "id":1, "category":{ "access2upload":[ { "1":"Пользователи" }, { "2":"Проверенные" }, { "3":"Модераторы" }, { "5":"Новая группа" }, { "251":"Друзья" }, { "999":"Гости" } ], "url":"http://yoursite.ucoz.ru/load/kategorija_u_razdela/3", "access2add":[ "Все группы" ], "name":"Категория у раздела", "access2category":[ "Все группы" ], "id":3, "description":"" }, "ontop":"no", "author_site":"http://Web-site", "subscribe":"no", "pending":"no", "description":"Краткое описание", "title":"Название материала", "archlink":"", "reads":11, "comments_url":"http://yoursite.ucoz.ru/load/kategorija_u_razdela/nazvanie_materiala/3-1-0-1#comments", "proglink":"http://Ссылка на источник материала", "section":{ "url":"http://yoursite.ucoz.ru/load/razdel/2", "name":"newtestname", "access2section":[ "Все группы" ], "id":2 }, "author":"Полное имя", "rating":"9.99", "versions":"версия материала", "add_date":"2014-11-20 07:56", "language":[ "Русский", "Английский" ], "entry_url":"http://yoursite.ucoz.ru/load/kategorija_u_razdela/nazvanie_materiala/3-1-0-1", "who_add":"Dmitry", "sort":0, "comments_num":0, "screenshot":"", "doclink":"http://Ссылка на страницу документации к материалу", "hgu_title":"nazvanie_materiala" } ] } { "loads":[ { "loads":99, "rate_num":4, "author_email":"E-mail", "filters":{ "Супер фильтр":[ "Фильтр 1" ] }, "comments":"yes", "os":[ "Multi-Platform", "Windows 7", "Mac OS" ], "rate_sum":100, "id":1, "category":{ "access2upload":[ { "1":"Пользователи" }, { "2":"Проверенные" }, { "3":"Модераторы" }, { "5":"Новая группа" }, { "251":"Друзья" }, { "999":"Гости" } ], "url":"http://yoursite.ucoz.ru/load/kategorija_u_razdela/3", "access2add":[ "Все группы" ], "name":"Категория у раздела", "access2category":[ "Все группы" ], "id":3, "description":"" }, "ontop":"no", "author_site":"http://Web-site", "subscribe":"no", "pending":"no", "description":"Краткое описание", "title":"Название материала", "archlink":"", "reads":11, "comments_url":"http://yoursite.ucoz.ru/load/kategorija_u_razdela/nazvanie_materiala/3-1-0-1#comments", "proglink":"http://Ссылка на источник материала", "section":{ "url":"http://yoursite.ucoz.ru/load/razdel/2", "name":"newtestname", "access2section":[ "Все группы" ], "id":2 }, "author":"Полное имя", "rating":"9.99", "versions":"версия материала", "add_date":"2014-11-20 07:56", "language":[ "Русский", "Английский" ], "entry_url":"http://yoursite.ucoz.ru/load/kategorija_u_razdela/nazvanie_materiala/3-1-0-1", "who_add":"Dmitry", "sort":0, "comments_num":0, "screenshot":"", "doclink":"http://Ссылка на страницу документации к материалу", "hgu_title":"nazvanie_materiala" } ] }
//для особенности 3 "access2add":[ "Все группы" ], //для особенности 3 "access2category":[ "Все группы" ], //для особенности 3 "access2add":[ "Все группы" ], //для особенности 3 "access2category":[ "Все группы" ],
 

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


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

    • page – [Число] – Количество страниц комментариев
    • pages_list – [Массив] – Возможные страницы в переключателе комментариев
    • per_page – [Число] – Количество комментариев на 1 страницу
    • total_loads – [Число] – Количество материалов в модуле
      •  loads – [Массив] – О материалах модуля
      • loads – [Число] – Количество загрузок файла
      • rate_num – [Число] – Количество голосов (рейтинг)
      • author_email – [Строка] – Email автора материала
      • filters – [Массив] – В какие фильтры входит материал
      • archlink_direct – [Строка] – Ссылка для скачивания архива с другого сервера (чистое значение)
      • comments – [Строка] – Позволить оставлять комментарии? (yes/no)
      • os – [Массив] – Значение поля "Операционная Система"
      • rate_sum – [Число] – Общая сумма рейтинга
      • id – [Число] – ID полученного материала
        •   category – [Массив] – О категории
        • access2upload – Группы, имеющие возможность скачивать файлы
        • url – [Строка] – Ссылка на категорию материала
        • access2add – [Массив] – Права на добавление материалов в категорию
        • name – [Строка] – Название категории материала
        • access2category – [Массив] – Право на просмотр категории материала
        • id – [Число] – ID категории материала
        • description – [Строка] – Описание категории материала
      • ontop – [Строка] – Показывать материал всегда сверху? (yes/no)
      • author_site – [Строка] – Ссылка на сайт автора
      • subscribe – [Строка] – Включена ли подписка на комментарии (уведомления) (yes/no)
      • pending – [Строка] – В ожидани ли активации материал? (yes/no)
      • description_type=(html|bb|plain) – [Строка] – Краткое описание материала
      • title – [Строка] – Название материала
      • archlink – [Строка]
      • reads – [Число] – Количество просмотров материала
      • comments_url – [Строка] – Ссылка на страницу материала с комментариями
      • proglink – [Строка] – Ссылка на источник материала
        • section – [Массив] – Информации о разделе, которой принадлежит категория
        • url – [Строка] – Ссылка на раздел, в который входит категория материала
        • name – [Строка] – Название раздела
        • url – [Строка] – Ссылка на категорию, куда был добавлен материал
        • access2section – [Массив] – Какие группы имеют доступ к просмотру раздела
        • id – [Число] – ID раздела
      • author – [Строка] – Никнейм пользователя, оставившего комментарий
      • rating – [Число] – Рейтинг материала (Общая сумма рейтинга/на количество голосов)
      • versions – [Строка] – Значение поля "Версия материала"
      • add_date – [Строка] – Время добавления материала
      • language – [Массив] – Выбор из пункта "Язык платформы"
      • entry_url – [Строка] – Полная ссылка на материал
      • who_add – [Строка] – Никнейм пользователя, добавивший материал
      • sort
      • comments_num – [Число] – Количество добавленных комментариев к материалу
      • screenshot – [Строка] – Прямая ссылка на скриншот
      • doclink – [Строка] – Ссылка на страницу документации к материалу
      • hgu_title – [Строка] – ЧПУ материала
        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
{ "page":1, "pages":"1", "per_page":"10", "total_loads":1, "loads":[ { "reads":11, "archlink":"", "proglink":"http://Ссылка на источник материала", "comments_url":"http://yoursite.ucoz.ru/load/kategorija_u_razdela/nazvanie_materiala/3-1-0-1#comments", "loads":99, "rate_num":4, "author_email":"E-mail", "author":"Полное имя", "filters":{ "Супер фильтр":[ "Фильтр 1" ] }, "comments":"yes", "rating":"9.99", "os":[ "Multi-Platform", "Windows 7", "Mac OS" ], "add_date":"2014-11-20 07:56", "versions":"версия материала", "rate_sum":100, "id":1, "ontop":"no", "author_site":"http://Web-site", "language":[ "Русский", "Английский" ], "subscribe":"no", "pending":"no", "description":"Краткое описание", "entry_url":"http://yoursite.ucoz.ru/load/kategorija_u_razdela/nazvanie_materiala/3-1-0-1", "who_add":"Dmitry", "comments_num":0, "sort":0, "title":"Название материала", "hgu_title":"nazvanie_materiala", "doclink":"http://Ссылка на страницу документации к материалу", "screenshot":"" } ], "category":{ "access2upload":[ { "1":"Пользователи" }, { "2":"Проверенные" }, { "3":"Модераторы" }, { "5":"Новая группа" }, { "251":"Друзья" }, { "999":"Гости" } ], "url":"http://yoursite.ucoz.ru/load/kategorija_u_razdela/3", "access2add":[ "Все группы" ], "name":"Категория у раздела", "access2category":[ "Все группы" ], "id":3, "description":"" } } { "page":1, "pages":"1", "per_page":"10", "total_loads":1, "loads":[ { "reads":11, "archlink":"", "proglink":"http://Ссылка на источник материала", "comments_url":"http://yoursite.ucoz.ru/load/kategorija_u_razdela/nazvanie_materiala/3-1-0-1#comments", "loads":99, "rate_num":4, "author_email":"E-mail", "author":"Полное имя", "filters":{ "Супер фильтр":[ "Фильтр 1" ] }, "comments":"yes", "rating":"9.99", "os":[ "Multi-Platform", "Windows 7", "Mac OS" ], "add_date":"2014-11-20 07:56", "versions":"версия материала", "rate_sum":100, "id":1, "ontop":"no", "author_site":"http://Web-site", "language":[ "Русский", "Английский" ], "subscribe":"no", "pending":"no", "description":"Краткое описание", "entry_url":"http://yoursite.ucoz.ru/load/kategorija_u_razdela/nazvanie_materiala/3-1-0-1", "who_add":"Dmitry", "comments_num":0, "sort":0, "title":"Название материала", "hgu_title":"nazvanie_materiala", "doclink":"http://Ссылка на страницу документации к материалу", "screenshot":"" } ], "category":{ "access2upload":[ { "1":"Пользователи" }, { "2":"Проверенные" }, { "3":"Модераторы" }, { "5":"Новая группа" }, { "251":"Друзья" }, { "999":"Гости" } ], "url":"http://yoursite.ucoz.ru/load/kategorija_u_razdela/3", "access2add":[ "Все группы" ], "name":"Категория у раздела", "access2category":[ "Все группы" ], "id":3, "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] Добавить материал

POST /uapi/load


Параметры для передачи

  • category – [Число] – ID категории
  • title – [Строка] – Название материала
  • description – [Строка] – Краткое описание материала
  • message – [Строка] – Полное описание материала
  • versions – [Строка] – Версия материала
  • language – [Число] – ID языка интерфейса (1 Мультиязычный, 2 Русский, 3 Английский, 4 Немецкий, 5 Испанский, 6 Итальянский, 7 Французский, 8 Португальский, 9 Японский, 10 Китайский, 11 Иврит)
  • archlink – [Строка] – Ссылка для скачивания архива с другого сервера
  • archsize – [Строка] – Размер архива на другом сервере
  • author – [Строка] – Полное имя
  • author_email – [Строка] – E-mail автора
  • author_site – [Строка] – Website автора
  • link2prog – [Строка] – Ссылка на источник материала
  • link2doc – [Строка] – Ссылка на страницу документации к материалу
  • subscribe – [Строка] – Подписка на материал (yes/no)
  • who_add – [Строка] – Никнейм, кто добавляет материал
  • licence – [Строка] – Тип лицензии (Бесплатный/Условно-бесплатный/Платный)
  • os – [Число] – Операционные системы (1 Multi-Platform, 2 Windows 95, 3 Windows 98/Me, 4 Windows NT/2000, 5 Windows XP, 6 Windows 2003, 7 Windows Vista, 17 Windows 7, 18 Windows 8, 8 Mac OS, 9 Unix/Linux, 10 FreeBSD, 11 Windows Mobile, 12 PocketPC, 13 Palm OS, 14 SmartPhone, 15 Symbian OS, 16 Solaris, 19 Android)
  • file1 – [Файл] – Изображение материала (в случае, если нужно несколько, то file2, file3)

Особенности

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('/load', array( 'category' => '1', 'title' => 'Название материала', 'description_type=bb' => 'Краткое описание материала', 'message_type=html' => 'Полное описание материала', 'author_site' => 'Веб-сайт автора', 'author_email' => 'Email автора', 'os' => '1', '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=1" --data-urlencode "title=Новое название" --data-urlencode "description=Краткое описание" --data-urlencode "message=Полное описание материала" --data-urlencode "author_site=Веб-сайт автора" --data-urlencode "author_email=Email автора" --data-urlencode "os=1" http://yoursite.ucoz.ru/uapi/load
{ "end2br_msg":"no", "files":[ { "small":"http://yoursite.ucoz.ru/_ld/0/s57172723.jpg", "full_height":1200, "full_width":1000, "small_height":150, "small_width":125, "full":"http://yoursite.ucoz.ru/_ld/0/57172723.jpg" } ], "author_email":"Email автора", "author":null, "filters":{ "Название из API":[ ], "Супер фильтр":[ ] }, "comments":"yes", "os":[ "Multi-Platform" ], "add_date":"2015-01-22 01:17", "end2br_desc":"no", "category":{ "access2upload":[ "Все группы" ], "url":"http://yoursite.ucoz.ru/load/1/1", "access2add":[ "Все группы" ], "name":"newtestname", "access2category":[ "Все группы" ], "id":1, "description":"" }, "ontop":"no", "includehtml_desc":"yes", "author_site":"http://Веб-сайт автора", "subscribe":"no", "pending":"no", "description_type=bb":"Краткое описание материала", "message_type=html":"Полное описание материала", "who_add":"Dmitry_DM", "title":"Название материала", "includehtml_msg":"yes", "hgu_title":"nazvanie_materiala" } { "end2br_msg":"no", "files":[ { "small":"http://yoursite.ucoz.ru/_ld/0/s57172723.jpg", "full_height":1200, "full_width":1000, "small_height":150, "small_width":125, "full":"http://yoursite.ucoz.ru/_ld/0/57172723.jpg" } ], "author_email":"Email автора", "author":null, "filters":{ "Название из API":[ ], "Супер фильтр":[ ] }, "comments":"yes", "os":[ "Multi-Platform" ], "add_date":"2015-01-22 01:17", "end2br_desc":"no", "category":{ "access2upload":[ "Все группы" ], "url":"http://yoursite.ucoz.ru/load/1/1", "access2add":[ "Все группы" ], "name":"newtestname", "access2category":[ "Все группы" ], "id":1, "description":"" }, "ontop":"no", "includehtml_desc":"yes", "author_site":"http://Веб-сайт автора", "subscribe":"no", "pending":"no", "description_type=bb":"Краткое описание материала", "message_type=html":"Полное описание материала", "who_add":"Dmitry_DM", "title":"Название материала", "includehtml_msg":"yes", "hgu_title":"nazvanie_materiala" }
 

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



Обратите внимание, что именно таким образом (с помощью 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] Отредактировать материал


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

  • end2br_msg – [Строка] – Статус опции "Заменять теги переноса на <br />" для полного описания материала (yes/no)
  • file1 – [Файл] – Изображение материала (в случае, если нужно несколько, то file2, file3)
  • archlink – [Строка]
  • licence – [Строка] – Тип лицензии (Бесплатный/Условно-бесплатный/Платный)
  • author_email – [Строка] – Email автора материала
  • author – [Строка] – Полное имя автора материала
  • filters – [Массив] – В какие фильтры входит материал
  • archsize – [Строка] –
  • comments – [Строка] – Позволить оставлять комментарии? (yes/no)
  • os – [Массив] – Значение поля "Операционная Система"
  • add_date – [Строка] – Время добавления материала
  • end2br_desc – [Строка] – Статус опции "Заменять теги переноса на <br />" для краткого описания материала (yes/no)
    • categories – [Массив] – О категории материала
    • access2upload – Группы, имеющие возможность скачивать файлы
    • url – [Строка] – Ссылка на категорию материала
    • access2add – [Массив] – Права на добавление материалов в категорию
    • name – [Строка] – Название категории материала
    • access2category – [Массив] – Право на просмотр категории материала
    • id – [Число] – ID категории материала
    • description – [Строка] – Описание категории материала
  • ontop – [Строка] – Показывать материал всегда сверху? (yes/no)
  • includehtml_desc – [Строка] – Включить HTML-теги для краткого описания материала? (yes/no)
  • author_site – [Строка] – Ссылка на сайт автора
  • subscribe – [Строка] – Включена ли подписка на комментарии (уведомления) (yes/no)
  • link2prog – [Строка] –
  • pending – [Строка] – В ожидани ли активации материал? (yes/no)
  • description_type=(html|bb|plain) – [Строка] – Краткое описание материала
  • message_type=(html|bb|plain) – [Строка] – Полное описание материала
  • who_add – [Строка] – Никнейм пользователя, добавивший материал
  • link2doc – [Строка] –
  • 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('/load', array( 'id' => '8', 'category' => '1', 'title' => 'Название материала', 'description_type=bb' => 'Краткое описание материала', 'message_type=html' => 'Полное описание материала', 'author_site' => 'Веб-сайт автора', 'author_email' => 'Email автора', 'os' => '1', '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=8" --data-urlencode "title=Название материала" --data-urlencode "description=Краткое описание материала" --data-urlencode "message=Полное описание материала" --data-urlencode "author_site=Веб-сайт автора" --data-urlencode "author_email=Email автора" --data-urlencode "os=1" http://yoursite.ucoz.ru/uapi/load
{ "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" } ], "archlink":"", "licence":null, "author_email":"Email автора", "author":"", "filters":{ "Название из API":[ ], "Супер фильтр":[ ] }, "archsize":"", "comments":"yes", "os":[ "Multi-Platform" ], "end2br_desc":"no", "category":{ "access2upload":[ "Все группы" ], "url":"http://yoursite.ucoz.ru/load/1/1", "access2add":[ "Все группы" ], "name":"newtestname", "access2category":[ "Все группы" ], "id":1, "description":"" }, "ontop":"no", "includehtml_desc":"yes", "author_site":"http://Веб-сайт автора", "subscribe":"no", "link2prog":"", "version":"", "pending":"no", "description_type=bb":"Краткое описание материала", "message_type=html":"Полное описание материала", "who_add":"Dmitry_DM", "link2doc":"", "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" } ], "archlink":"", "licence":null, "author_email":"Email автора", "author":"", "filters":{ "Название из API":[ ], "Супер фильтр":[ ] }, "archsize":"", "comments":"yes", "os":[ "Multi-Platform" ], "end2br_desc":"no", "category":{ "access2upload":[ "Все группы" ], "url":"http://yoursite.ucoz.ru/load/1/1", "access2add":[ "Все группы" ], "name":"newtestname", "access2category":[ "Все группы" ], "id":1, "description":"" }, "ontop":"no", "includehtml_desc":"yes", "author_site":"http://Веб-сайт автора", "subscribe":"no", "link2prog":"", "version":"", "pending":"no", "description_type=bb":"Краткое описание материала", "message_type=html":"Полное описание материала", "who_add":"Dmitry_DM", "link2doc":"", "title":"Название материала", "includehtml_msg":"yes", "hgu_title":"nazvanie_materiala" }
 

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



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

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

<?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('/load/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/load/posts
{ "success":{ "msg":"Материал удалён" } } { "success":{ "msg":"Материал удалён" } }

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