АПИ сайта

  

Если Вы разработчик, и пишите программу, связанную с нашим сайтом, Вам понадобятся API.

Посмотреть пример использования можно в исходных кодах DVClient доступных на Github

Все обращения к API осуществляются по https протоколу к файлу apps/dvclient.php

Ответ приходит в формате JSON. Ниже список возможностей:

1. Получение ленты материалов с основных разделов

ссылка: dimonvideo.ru/apps/dvclient.php?op=1&razdel=uploader&min=1&c=placeholder,all
- uploader это идентификатор раздела (uploader - Обменник файлами, articles - Каталог статей, gallery - Картинки, usernews - Новости наших посетителей, suploader - Второй обменник, android - Файлы для Android, books - Библиотека, device - Каталог устройств, comments - Главные новости)
- min=1 это страница, 1,2,3 и тп, вывод по 10 элементов.
- c=placeholder,all - фильтр категорий, all - вывести все материалы, android - вывести все для андроид из Обменника или архива, symbian - вывести все для symbian из Обменника, books - вывести библиотеку из Обменника, abooks - вывести аудиокниги из Обменника, hbooks - вывести Худ.книги из Обменника, soft - вывести все программы из раздела андроид, games - игры из андроид, themes - темы. Для музыки: albums, tracks, ringtone,others. Для Видео: movies, serials,clips,humor. Для Картинок: humor, wallpaper, others, animals. Для Новостей: hardware, apple, games, software. Для Библиотеки: audio, fantastic, fantasy, others.

В ответ придут JSON строки, с параметрами:

lid => номер файла
plus => плюсы файла
min => страница файла
views => просмотры файла
file_link => ссылка на файл
mod => ссылка на мод если есть
user => автор файла
size => размер
razdel => ид раздела
headers => название раздела
category => Категория
date => дата
time => время в формате таймпстамп
title => Название
text => Краткое описание
full_text => Полное описание
image => скриншот
rating => число комментариев
fav => 0 (или 1 если файл в Избранном профиле 4)

2. Поиск по ленте материалов с основных разделов

ссылка: dimonvideo.ru/apps/dvclient.php?op=1&razdel=android&min=1&story=dvclient

- передаем поисковую строку story, все остальное как в п.1

3. Получение ленты материалов с основных разделов по категориям

ссылка: dimonvideo.ru/apps/dvclient.php?op=1&razdel=uploader&min=1&c=placeholder,all&where=242

- в параметре where передаем номер категории, ответ как в п.1

4. Получение ленты категорий основных разделов

ссылка: dimonvideo.ru/apps/dvclient.php?op=9&razdel=uploader

- предаём ид раздела, в ответ получим JSON:

lid => номер категории
title => название категории
count =>количество файлов в категории
razdel => ид раздела

5. Получение ленты комментариев к файлу

ссылка: dimonvideo.ru/apps/dvclient.php?op=4&razdel=android&lid=384369

- передаем ид раздела и номер файла, получаем JSON:

topic_id => номер коммента
lid => номер файла
image => аватар юзера
newtopic => 0
user => имя юзера
title => имя файла
text => текст комментария
category => ранг юзера
date => дату комментария
razdel => ид раздела файла
pinned => 0
rating => число ответов юзера
time => время в таймпстамп
views => 0
min => страница комментария если их много

6. Получение ленты тем форума

ссылка: dimonvideo.ru/apps/dvclient.php?op=5&min=1

- в параметре min передаем номер страницы, в ответ получим:

lid => номер темы
last_poster_name => последний ответивший
user => автор темы
title => название темы
text => описание темы
category => форум
date => дата
state => закрыта или открыта тема
pinned => прикреплена или нет
rating => число ответов в теме
time => время последнего ответа
views => просмотры темы
fav => признак в избранном

7. Получение ленты тем форума без ответов

ссылка: dimonvideo.ru/apps/dvclient.php?op=5&min=1&id=-1

- в параметре min передаем номер страницы, в ответ получим как п.6

8. Получение ленты тем конкретного форума

ссылка: dimonvideo.ru/apps/dvclient.php?op=5&min=1&id=6

- в параметре min передаем номер страницы, в параметре id передаем номер форума, в ответ получим как п.6


9. Получение списка форумов

ссылка: dimonvideo.ru/apps/dvclient.php?op=6&min=1

в ответе получим:

lid => номер форума
last_poster_name => имя последнего ответившего в форуме
user => 0
title => имя форума
text => описание форума
category => название последней темы в форуме
date => дата последней темы
state => родительский форум
pinned => 0
rating => 0
time => время последнего ответа
views => 0

10. Получение ответов в заданной теме

ссылка: dimonvideo.ru/apps/dvclient.php?op=7&min=1&id=1728147016

- передаем ид темы и страницу, получим ответ:

topic_id => номер темы
lid => номер ответа
image => аватар юзера
newtopic => признак первого поста
last_poster_name => имя юзера
user => имя автора темы
title => имя темы
text => текст ответа
category => имя форума
date => дата ответа
state => закрыта или открыта тема
pinned => прикреплена ли тема
rating => число ответов
time => время ответа
views => просмотры темы
min => страница

Действия, требующие авторизацию на сайте


1. Проверка, авторизован ли пользователь и получение информации о нем.

ссылка: dimonvideo.ru/apps/dvclient.php?op=10&login_name=read_only&login_password=123456

- передаем логин и пароль, получаем state = 0 если не успешно, или JSON данные, если успешно (попытки перебора блокируются сервером, будьте внимательны):

pm_unread => число непрочтенных ЛС
lid => ид юзера
user => ник
image => аватар
headers => ранг
reputation => репутация
reg_date => дата регистрации
rating => рейтинг
count => посты
time => время последнего визита
state => 1 если авторизация прошла

2. Установка отметки Понравилось к файлу.

ссылка: dimonvideo.ru/apps/dvclient.php?op=8&razdel=android&login_name=read_only&t=1&id=432

- передаем раздел, логин и номер файла. Ответ не придет.

3. Снятие отметки Понравилось к файлу.

ссылка: dimonvideo.ru/apps/dvclient.php?op=8&razdel=android&login_name=read_only&t=2&id=432

- передаем раздел, логин и номер файла. Ответ не придет.

4. Добавление файла в Избранное (профиль 4).

ссылка: dimonvideo.ru/apps/dvclient.php?op=10&login_name=read_only&login_password=123456&razdel=android&id=432&addfav=1

- передаем логин и пароль, раздел и номер файла получаем state = 0 если не авторизован, или JSON данные п.1 если авторизован и файл добавился.

5. Удаление файла из Избранного (профиль 4).

ссылка: dimonvideo.ru/apps/dvclient.php?op=10&login_name=read_only&login_password=123456&razdel=android&id=432&addfav=2

- передаем логин и пароль, раздел и номер файла получаем state = 0 если не авторизован, или JSON данные п.1 если авторизован и файл удален из избранного.

6. Установка отметки Понравилось к ответу на форуме.

ссылка: dimonvideo.ru/apps/dvclient.php?op=8&login_name=read_only&t=1&id=432

- передаем логин и номер темы. Ответ не придет.

7. Снятие отметки Понравилось к ответу на форуме.

ссылка: dimonvideo.ru/apps/dvclient.php?op=8&login_name=read_only&t=2&id=432

- передаем логин и номер темы. Ответ не придет.

8. Регистрация на сайте.

ссылка: dimonvideo.ru/apps/dvclient.php?op=12

- необходимо в POST запросах передать параметры userName, userPassword, userEmail, в ответ получите JSON параметр state, от 0 до 5.
0 - ошибка
1 - уже зарегистрирован ранее
2 - успешная регистрация
3 - почта занята
4 - почта введена неверно
5 - имя занято

9. Отправка комментария к файлу.

ссылка: dimonvideo.ru/apps/dvclient.php?op=11&delete=20&pm=12&razdel=android&pm_id=432&login_name=read_only&login_password=123456

- передаем логин, пароль, раздел и номер файла, в ответ придет state 1
- текст сообщения необходимо передать через POST запрос pm_text

10. Отправка ответа на форум.

ссылка: dimonvideo.ru/apps/dvclient.php?op=11&delete=2&pm=12&pm_id=432&login_name=read_only&login_password=123456

- передаем логин, пароль и номер темы, в ответ придет state 1
- текст сообщения необходимо передать через POST запрос pm_text

11. Получение списка Личных сообщений.

ссылка: dimonvideo.ru/apps/dvclient.php?op=11&pm=0&login_name=read_only&login_password=123456

- передаем логин, пароль и параметр pm если необходимо получения дополнительных папок.
pm=0 для Входящих
pm=1 для Отправленных
pm=2 для Архива
pm=3 для Исходящих
pm=4 для Задач
pm=5 для Корзины

в ответ получаем JSON:
lid => номер сообщения
last_poster_name => отправитель
user => получатель
title => тема
full_text => текст
text => краткий текст
category => аватар
date => дата
state => признак системного (1 или 0)
pinned => приоритет (1,2,3)
rating => признак отвечено (0,1)
time => время
views => признак вложенных файлов (0,1)

12. Ответ на Личное сообщение.

ссылка: dimonvideo.ru/apps/dvclient.php?op=11&pm=12&pm_id=1728139707&login_name=read_only&login_password=123456

- передаем логин, пароль и номер сообщения, в ответ придет state 1
- текст сообщения необходимо передать через POST запрос pm_text

13. Удаление Личного сообщения.

ссылка: dimonvideo.ru/apps/dvclient.php?op=11&pm=10&delete=0&pm_id=1728139707&login_name=read_only&login_password=123456

- передаем логин, пароль и номер сообщения, в ответ придет status 1

14. Восстановление Личного сообщения.

ссылка: dimonvideo.ru/apps/dvclient.php?op=11&pm=10&delete=1&pm_id=1728139707&login_name=read_only&login_password=123456

- передаем логин, пароль и номер сообщения, в ответ придет status 1




------
Здесь находятся
всего 0
Рейтинг: 4
голосов: 1
Яндекс.Метрика