[ /b/ /u/ /rf/ /dt/ /vg/ /r/ /cr/ /lor/ /mu/ /oe/ /s/ /w/ /hr/ ] [ /a/ /ma/ /sw/ /hau/ /azu/ ] [ /tv/ /cp/ /gf/ /bo/ /di/ /vn/ /ve/ /wh/ /fur/ /to/ /bg/ /wn/ /slow/ /mad/ ] [ /d/ /news/ ] [ Главная | Настройки | Закладки | Плеер ]

Формат запросов

Параметры запроса:

  • post_id - внутренний номер сообщения
  • thread_id - внутренний номер треда
  • board - символьное обозначение доски ("b", "a", "d", "rf")
  • display_id - внешний (видимый) номер сообщения или треда
  • format - формат ответа, может быть xhtml, json, xml (на данный момент недоступен).

Ответ в json/xml содержит либо объект result либо объект error.

error всегда имеет поля code и message, расшифровывающие ошибку. Дополнительно может содержать поле data, с данными, специфичными для конкретного запроса/ошибки.

Запросы принимают ряд дополнительных параметров:

  • new_format - экспорт в новом (описанном выше формате). Ближайшие два месяца по умолчанию будет использоваться старый формат.
  • message_html - экспорт текста сообщений в виде html
  • message_raw - экспорт текста сообщений в исходном виде

Кеширование

Почти все интерфейсы поддерживают If-Modified-Since/If-None-Match заголовки.

Если ответ содержит Last-Modified или E-Tag - значит данный интерфейс поддерживает соответствующий метод проверки валидности кеша.

Треды

Дополнительные параметры:

  • board - экспорт информации о доске

Тред

  • /api/thread/{thread_id:d+}{.format}
  • /api/thread/{board}/{display_id:d+}{.format}

Примеры: /api/thread/109992.json, /api/thread/d/24368.json

Все сообщения треда

  • /api/thread/{thread_id:d+}/all{.format}
  • /api/thread/{board}/{display_id:d+}/all{.format}

Примеры: /api/thread/109992/all.json?new_format&message_html&board

Новые сообщения треда

  • /api/thread/{thread_id:d+}/new{.format}
  • /api/thread/{board}/{display_id:d+}/new{.format}

Параметры:

  • last_post - обязательный - display_id сообщения, начиная с которого необходимо выбирать сообщения.

Примеры: /api/thread/109992/new.json?last_post=24368

Последние сообщения треда

  • /api/thread/{thread_id:d+}/last{.format}
  • /api/thread/{board}/{display_id:d+}/last{.format}

Параметры:

  • last_post - display_id сообщения, начиная с которого необходимо выбирать сообщения. При отсутствии этого параметра выбираются последние сообщения по количеству.
  • count - число последних сообщений, которые необходимо выбрать. По умолчанию равно 100.

Если количество сообщений после last_post больше count, будут отображены только count последних.

Примеры: /api/thread/109992/last.json?count=10

Сообщения

Дополнительные параметры:

  • thread - экспорт информации о треде и доске

Само сообщение

  • /api/post/{post_id:d+}{.format}
  • /api/post/{board}/{display_id:d+}{.format}
  • /api/post/{board}/{thread_display_id:d+}/{display_id:d+}{.format}'

Примеры: /api/post/2145167.json?thread&new_format&message_html, /api/post/d/24368.json, /api/post/d/24368/24368.json

Пользователь

Дополнительные параметры:

  • threads - данные о закладках, скрытых тредах, тредах с ответами и т.д.

Данные о пользователе

  • /api/user{.format}

Пример: /api/user.json?threads

Поле tokens содержит список всех ограничений и привилегий пользователя, включая информацию о разрешении постинга без капчи. Токены более узкого пространства имеют приоритет над токенами более общего пространства.

Токены:

  • no_user_captcha - разрешение постить без ввода капчи
  • captcha - необходимость ввести капчу указанной сложности
  • readonly - запрет на постинг


[ /b/ /u/ /rf/ /dt/ /vg/ /r/ /cr/ /lor/ /mu/ /oe/ /s/ /w/ /hr/ ] [ /a/ /ma/ /sw/ /hau/ /azu/ ] [ /tv/ /cp/ /gf/ /bo/ /di/ /vn/ /ve/ /wh/ /fur/ /to/ /bg/ /wn/ /slow/ /mad/ ] [ /d/ /news/ ] [ Главная | Настройки | Закладки | Плеер ]