Главная > Документация > Модуль "Фотоальбомы", материалы
 

[GET] Поиск материалов


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

  • width – [Строка] – Ширина фотографии
  • other3 – [Строка] – Дополнительное поле 3
  • other5 – [Строка] – Дополнительное поле 5
  • other1 – [Строка] – Дополнительное поле 1
  • rate_num – [Число] – Рейтинг материала
  • photo_direct_url – [Строка] – Прямая ссылка на фотографию
    •  section – [Массив] – Информация о разделе, в который входит материал
    • url – [Строка] – Ссылка на раздел
    • access2section – [Массив] – Список групп, которым разрешен просмотр раздела
    • name – [Строка] – Название раздела
    • id – [Строка] – ID раздела
    • description – [Строка] – Описание раздела
  • comments – [Строка] – Разрешено ли комментировать? (yes/no)
  • add_date – [Строка] – Дата добавления материала
  • id – [Строка] – ID материала
    •  category – [Массив] – Информация о категории, в который входит материал
    • url – [Строка] – Ссылка на раздел
    • access2add – [Массив] – Список групп, которым разрешено добавлять материалы в категорию
    • name – [Строка] – Название раздела
    • access2category – [Массив] – Список групп, которым разрешен просмотр категории
    • id – [Строка] – ID раздела
    • description – [Строка] – Описание раздела
  • thumb_small – [Строка] – Ссылка на маленькое изображение
  • other4 – [Строка] – Дополнительное поле 4
  • subscribe – [Строка] – Включена ли подписка на обновления? (yes/no)
  • other2 – [Строка] – Дополнительное поле 2
  • name – [Строка] – Название материала
  • pending – [Строка] – В ожидании ли активации материал? (yes/no)
  • photo_url – [Строка] – Ссылка на страницу материала с фото
  • height – [Число] – Ширина фотографии
  • description – [Строка] – Описание материала
  • entry_url – [Строка] – Полная ссылка на страницу с фотографией, комментариями, описанием
  • who_add – [Строка] – Автор добавленнного материала
  • thumb_mid – [Строка] – Ссылка на уменьшенную фотографию
  • hgu_title – [Строка] – ЧПУ материала
  • prev_entry_url - [Строка] - Полная ссылка на предыдущий материал
  • next_entry_url - [Строка] - Полная ссылка на следующий материал

Особенности

1) Чтобы получить данные материалов со страницы 2, необходимо добавить параметр page=N (где N – номер страницы)
2) Если не найдено материалов, то вы получите ответ {"error":{"msg":"По запросу ничего не найдено"}}

<?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('/photo', array( 'id' => '1' )); 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 "id=1" http://yoursite.ucoz.ru/uapi/photo
{ "width":1270, "other3":"3", "other5":"5", "other1":"1", "rate_num":0, "photo_direct_url":"http://yoursite.ucoz.ru/_ph/1/798819546.png", "section":{ "url":"http://yoursite.ucoz.ru/photo/ayva/3", "access2section":[ "All groups" ], "name":"аыва", "id":3, "description":"" }, "comments":"yes", "rating":"0.00", "rate_sum":0, "add_date":"2014-11-19 11:57", "id":1, "category":{ "url":"http://yoursite.ucoz.ru/photo/ayva/1", "access2add":[ "All groups" ], "name":"Мои фотографии", "access2category":[ "All groups" ], "id":1, "description":"В этом разделе собраны мои персональные фотографии.", "access2page":[ "All groups" ] }, "thumb_small":"http://yoursite.ucoz.ru/_ph/1/1/798819546.jpg", "other4":"4", "subscribe":"no", "other2":"2", "name":"Фотография 1", "pending":"no", "photo_url":"http://yoursite.ucoz.ru/photo/1-0-1-3", "height":419, "description":"", "entry_url":"http://yoursite.ucoz.ru/photo/ayva/fotografija_1/1-0-1", "who_add":"Dmitry_DM", "sort":0, "thumb_mid":"http://yoursite.ucoz.ru/_ph/1/2/798819546.jpg", "hgu_title":"fotografija_1", "prev_entry_url":"", "next_entry_url":"https://yoursite.ucoz.ru/photo/ayva/fotografija_1/1-0-2" } { "width":1270, "other3":"3", "other5":"5", "other1":"1", "rate_num":0, "photo_direct_url":"http://yoursite.ucoz.ru/_ph/1/798819546.png", "section":{ "url":"http://yoursite.ucoz.ru/photo/ayva/3", "access2section":[ "All groups" ], "name":"аыва", "id":3, "description":"" }, "comments":"yes", "rating":"0.00", "rate_sum":0, "add_date":"2014-11-19 11:57", "id":1, "category":{ "url":"http://yoursite.ucoz.ru/photo/ayva/1", "access2add":[ "All groups" ], "name":"Мои фотографии", "access2category":[ "All groups" ], "id":1, "description":"В этом разделе собраны мои персональные фотографии.", "access2page":[ "All groups" ] }, "thumb_small":"http://yoursite.ucoz.ru/_ph/1/1/798819546.jpg", "other4":"4", "subscribe":"no", "other2":"2", "name":"Фотография 1", "pending":"no", "photo_url":"http://yoursite.ucoz.ru/photo/1-0-1-3", "height":419, "description":"", "entry_url":"http://yoursite.ucoz.ru/photo/ayva/fotografija_1/1-0-1", "who_add":"Dmitry_DM", "sort":0, "thumb_mid":"http://yoursite.ucoz.ru/_ph/1/2/798819546.jpg", "hgu_title":"fotografija_1", "prev_entry_url":"", "next_entry_url":"https://yoursite.ucoz.ru/photo/ayva/fotografija_1/1-0-2" }
 

[GET] Все материалы альбома


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

       photos – [Массив] – Информация о материалах модуля
    • width – [Число] – Ширина фотографии
    • other3 – [Строка] – Дополнительное поле 3
    • other5 – [Строка] – Дополнительное поле 5
    • other1 – [Строка] – Дополнительное поле 1
      •  section – [Массив] – Информация о разделе материала
      • url – [Строка] – Ссылка на раздел
      • access2section – [Массив] – Список групп, которым разрешен просмотр раздела
      • id – [Число] – ID материала
    • photo_direct_url – [Строка] – Прямая ссылка на фотографию
    • comments – [Строка] – Разрешено ли комментировать? (yes/no)
    • add_date – [Строка] – Дата добавления материала
    • id – [Строка] – ID материала
      •  category – [Массив] – Информация о категории, в который входит материал
      • url – [Строка] – Ссылка на раздел
      • access2add – [Массив] – Список групп, которым разрешено добавлять материалы в категорию
      • name – [Строка] – Название раздела
      • access2category – [Массив] – Список групп, которым разрешен просмотр категории
      • id – [Строка] – ID раздела
      • description – [Строка] – Описание раздела
    • thumb_small – [Строка] – Ссылка на маленькое изображение
    • other4 – [Строка] – Дополнительное поле 4
    • subscribe – [Строка] – Включена ли подписка на обновления? (yes/no)
    • other2 – [Строка] – Дополнительное поле 2
    • name – [Строка] – Название материала
    • pending – [Строка] – В ожидании ли активации материал? (yes/no)
    • photo_url – [Строка] – Ссылка на страницу материала с фото
    • height – [Число] – Ширина фотографии
    • description – [Строка] – Описание материала
    • entry_url – [Строка] – Полная ссылка на страницу с фотографией, комментариями, описанием
    • who_add – [Строка] – Автор добавленнного материала
    • thumb_mid – [Строка] – Ссылка на уменьшенную фотографию
    • hgu_title – [Строка] – ЧПУ материала
  • sorting – [Строка] – Тип сортировки материалов на странице
  • page – [Число] – Текущая страница
  • total_photos – [Число] – Общее количество фотографий в альбоме
  • pages_list – [Строка] – Страницы из переключателей (список страниц)
  • per_page – [Число] – Материалов на 1 страницу

Особенности

1) Чтобы получить данные материалов со страницы 2, необходимо добавить параметр page=N (где N – номер страницы)
2) Если не найдено материалов, то вы получите ответ {"error":{"msg":"По запросу ничего не найдено"}}

<?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('/photo/album', 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=значение" --data-urlencode http://yoursite.ucoz.ru/uapi/photo/album
{ "photos":[ { "width":1136, "other3":"", "other5":"", "other1":"", "rate_num":0, "section":{ "url":"http://yoursite.ucoz.ru/photo/ayva/3", "name":"аыва", "access2section":[ "All groups" ], "id":3 }, "photo_direct_url":"http://yoursite.ucoz.ru/_ph/2/549587095.png", "comments":"yes", "rating":"0.00", "rate_sum":0, "add_date":"2015-01-14 17:51", "id":8, "category":{ "access2upload":[ "All groups" ], "url":"http://yoursite.ucoz.ru/photo/ayva/2", "access2add":[ "All groups" ], "name":"Моя семья", "access2category":[ "All groups" ], "id":2, "description":"" }, "thumb_small":"http://yoursite.ucoz.ru/_ph/2/1/549587095.jpg", "other4":"", "subscribe":"no", "other2":"", "name":"IMG_1561", "pending":"no", "photo_url":"http://yoursite.ucoz.ru/photo/2-0-8-3", "height":640, "description":"", "entry_url":"http://yoursite.ucoz.ru/photo/ayva/img_1561/2-0-8", "who_add":"Dmitry_DM", "sort":0, "thumb_mid":"http://yoursite.ucoz.ru/_ph/2/2/549587095.jpg", "hgu_title":"img_1561" } ], "sorting":"Date (D)", "page":1, "total_photos":9, "pages_list":"1..9", "per_page":"1" } { "photos":[ { "width":1136, "other3":"", "other5":"", "other1":"", "rate_num":0, "section":{ "url":"http://yoursite.ucoz.ru/photo/ayva/3", "name":"аыва", "access2section":[ "All groups" ], "id":3 }, "photo_direct_url":"http://yoursite.ucoz.ru/_ph/2/549587095.png", "comments":"yes", "rating":"0.00", "rate_sum":0, "add_date":"2015-01-14 17:51", "id":8, "category":{ "access2upload":[ "All groups" ], "url":"http://yoursite.ucoz.ru/photo/ayva/2", "access2add":[ "All groups" ], "name":"Моя семья", "access2category":[ "All groups" ], "id":2, "description":"" }, "thumb_small":"http://yoursite.ucoz.ru/_ph/2/1/549587095.jpg", "other4":"", "subscribe":"no", "other2":"", "name":"IMG_1561", "pending":"no", "photo_url":"http://yoursite.ucoz.ru/photo/2-0-8-3", "height":640, "description":"", "entry_url":"http://yoursite.ucoz.ru/photo/ayva/img_1561/2-0-8", "who_add":"Dmitry_DM", "sort":0, "thumb_mid":"http://yoursite.ucoz.ru/_ph/2/2/549587095.jpg", "hgu_title":"img_1561" } ], "sorting":"Date (D)", "page":1, "total_photos":9, "pages_list":"1..9", "per_page":"1" }
 

[GET] Материалы категории


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

       photos – [Массив] – Информация о материалах модуля
    • width – [Число] – Ширина фотографии
    • other3 – [Строка] – Дополнительное поле 3
    • other5 – [Строка] – Дополнительное поле 5
    • other1 – [Строка] – Дополнительное поле 1
    • photo_direct_url – [Строка] – Прямая ссылка на фотографию
    • comments – [Строка] – Разрешено ли комментировать? (yes/no)
    • add_date – [Строка] – Дата добавления материала
    • id – [Строка] – ID материала
    • thumb_small – [Строка] – Ссылка на маленькое изображение
    • other4 – [Строка] – Дополнительное поле 4
    • subscribe – [Строка] – Включена ли подписка на обновления? (yes/no)
    • other2 – [Строка] – Дополнительное поле 2
    • name – [Строка] – Название материала
    • pending – [Строка] – В ожидании ли активации материал? (yes/no)
    • photo_url – [Строка] – Ссылка на страницу материала с фото
    • height – [Число] – Ширина фотографии
    • description – [Строка] – Описание материала
    • entry_url – [Строка] – Полная ссылка на страницу с фотографией, комментариями, описанием
    • who_add – [Строка] – Автор добавленнного материала
    • thumb_mid – [Строка] – Ссылка на уменьшенную фотографию
    • hgu_title – [Строка] – ЧПУ материала
  • sorting – [Строка] – Тип сортировки материалов на странице
  • page – [Число] – Текущая страница
  • total_photos – [Число] – Общее количество фотографий в альбоме
  • pages_list – [Строка] – Страницы из переключателей (список страниц)
  • per_page – [Число] – Материалов на 1 страницу
    •  section – [Массив] – Информация о разделе материала
    • url – [Строка] – Ссылка на раздел
    • access2section – [Массив] – Список групп, которым разрешен просмотр раздела
    • id – [Число] – ID материала
       category – [Массив] – Информация о категории, в который входит материал
    • url – [Строка] – Ссылка на раздел
    • access2add – [Массив] – Список групп, которым разрешено добавлять материалы в категорию
    • name – [Строка] – Название раздела
    • access2category – [Массив] – Список групп, которым разрешен просмотр категории
    • id – [Строка] – ID раздела
    • description – [Строка] – Описание раздела

Особенности

1) Чтобы получить данные материалов со страницы 2, необходимо добавить параметр page=N (где N – номер страницы)
2) Если не найдено материалов, то вы получите ответ {"error":{"msg":"По запросу ничего не найдено"}}

<?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('/photo/album', array( 'category' => '1' )); 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=1" --data-urlencode http://yoursite.ucoz.ru/uapi/photo/album
{ "photos":[ { "width":1270, "other3":"3", "other5":"5", "other1":"1", "rate_num":0, "photo_direct_url":"http://yoursite.ucoz.ru/_ph/1/798819546.png", "comments":"yes", "rating":"0.00", "rate_sum":0, "add_date":"2014-11-19 11:57", "thumb_small":"http://yoursite.ucoz.ru/_ph/1/1/798819546.jpg", "id":1, "other4":"4", "subscribe":"no", "other2":"2", "name":"Фотография 1", "pending":"no", "photo_url":"http://yoursite.ucoz.ru/photo/1-0-1-3", "height":419, "description":"", "entry_url":"http://yoursite.ucoz.ru/photo/ayva/fotografija_1/1-0-1", "who_add":"Dmitry_DM", "sort":0, "thumb_mid":"http://yoursite.ucoz.ru/_ph/1/2/798819546.jpg", "hgu_title":"fotografija_1" } ], "sorting":"Date (D)", "page":1, "pages_list":"1..4", "per_page":"1", "section":{ "url":"http://yoursite.ucoz.ru/photo/ayva/3", "name":"аыва", "access2section":[ "All groups" ], "id":3 }, "total_photos":4, "category":{ "access2upload":[ "All groups" ], "url":0, "access2add":[ "All groups" ], "name":"Мои фотографии", "access2category":[ "All groups" ], "id":1, "description":"В этом разделе собраны мои персональные фотографии." } } { "photos":[ { "width":1270, "other3":"3", "other5":"5", "other1":"1", "rate_num":0, "photo_direct_url":"http://yoursite.ucoz.ru/_ph/1/798819546.png", "comments":"yes", "rating":"0.00", "rate_sum":0, "add_date":"2014-11-19 11:57", "thumb_small":"http://yoursite.ucoz.ru/_ph/1/1/798819546.jpg", "id":1, "other4":"4", "subscribe":"no", "other2":"2", "name":"Фотография 1", "pending":"no", "photo_url":"http://yoursite.ucoz.ru/photo/1-0-1-3", "height":419, "description":"", "entry_url":"http://yoursite.ucoz.ru/photo/ayva/fotografija_1/1-0-1", "who_add":"Dmitry_DM", "sort":0, "thumb_mid":"http://yoursite.ucoz.ru/_ph/1/2/798819546.jpg", "hgu_title":"fotografija_1" } ], "sorting":"Date (D)", "page":1, "pages_list":"1..4", "per_page":"1", "section":{ "url":"http://yoursite.ucoz.ru/photo/ayva/3", "name":"аыва", "access2section":[ "All groups" ], "id":3 }, "total_photos":4, "category":{ "access2upload":[ "All groups" ], "url":0, "access2add":[ "All groups" ], "name":"Мои фотографии", "access2category":[ "All groups" ], "id":1, "description":"В этом разделе собраны мои персональные фотографии." } }
 

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


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

  • category – [Число] – ID категории
  • photo – [Файл] – Изображение
  • description – [Строка] – Описание материала
  • other1 – [Строка] – Дополнительное поле 1
  • other2 – [Строка] – Дополнительное поле 2
  • other3 – [Строка] – Дополнительное поле 3
  • other4 – [Строка] – Дополнительное поле 4
  • other5 – [Строка] – Дополнительное поле 5
  • tags – [Строка] – Теги материала
  • author – [Строка] – Автор материала
  • save_original – [Строка] – Сохранить оригинал изображения (да/нет)
  • name – [Строка] – Название фотографии
<?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('/photo', array( 'category' => '1', 'photo' => '@12.png' )); print_r($response); //Получаем ответ curl -i -X POST -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=1" --data-urlencode "photo=@12.png" http://yoursite.ucoz.ru/uapi/photo
{ "photo_direct_url":"http://yoursite.ucoz.ru/_ph/2/72499661.jpg", "section":{ "url":"http://yoursite.ucoz.ru/my/3", "access2section":[ "Все группы" ], "name":"Раздел", "id":3, "description":"", "hgu_title":"razdel" }, "photo_url":"http://yoursite.ucoz.ru/my/2-0-6-3", "add_date":"2015-07-28 23:11", "id":6, "category":{ "access2add":[ "Все группы" ], "name":"Моя семья", "description":"", "access2page":[ "Все группы" ], "url":"http://yoursite.ucoz.ru/my/2", "id":2, "access2category":[ "Все группы" ], "hgu_title":null }, "thumb_small":"http://yoursite.ucoz.ru/_ph/2/1/72499661.jpg", "thumb_mid":"http://yoursite.ucoz.ru/_ph/2/2/72499661.jpg" } { "photo_direct_url":"http://yoursite.ucoz.ru/_ph/2/72499661.jpg", "section":{ "url":"http://yoursite.ucoz.ru/my/3", "access2section":[ "Все группы" ], "name":"Раздел", "id":3, "description":"", "hgu_title":"razdel" }, "photo_url":"http://yoursite.ucoz.ru/my/2-0-6-3", "add_date":"2015-07-28 23:11", "id":6, "category":{ "access2add":[ "Все группы" ], "name":"Моя семья", "description":"", "access2page":[ "Все группы" ], "url":"http://yoursite.ucoz.ru/my/2", "id":2, "access2category":[ "Все группы" ], "hgu_title":null }, "thumb_small":"http://yoursite.ucoz.ru/_ph/2/1/72499661.jpg", "thumb_mid":"http://yoursite.ucoz.ru/_ph/2/2/72499661.jpg" }
 

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


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

  • category – [Число] – ID категории
  • photo – [Файл] – Изображение
  • description – [Строка] – Описание материала
  • other1 – [Строка] – Дополнительное поле 1
  • other2 – [Строка] – Дополнительное поле 2
  • other3 – [Строка] – Дополнительное поле 3
  • other4 – [Строка] – Дополнительное поле 4
  • other5 – [Строка] – Дополнительное поле 5
  • tags – [Строка] – Теги материала
  • author – [Строка] – Автор материала
  • save_original – [Строка] – Сохранить оригинал изображения (да/нет)
  • name – [Строка] – Название фотографии
<?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('/photo', array( 'id' => '1', 'name' => 'New name' )); print_r($response); //Получаем ответ curl -i -X PUT -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 "id=1" --data-urlencode "name=New name" http://yoursite.ucoz.ru/uapi/photo
{ } { }
 

[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('/photo/entry', array( 'id' => '1' )); print_r($response); //Получаем ответ curl -i -X DELETE -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 "id=1" http://yoursite.ucoz.ru/uapi/photo/entry
{ "success":{ "msg":"Материал удалён" } } { "success":{ "msg":"Материал удалён" } }

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