##// END OF EJS Templates
Version bumped to 2.3
Version bumped to 2.3

File last commit:

r526:c51c9af8 default
r945:957e2fec 2.3.0 default
Show More
api.markdown
66 lines | 1.5 KiB | text/x-markdown | MarkdownLexer

INTRO

The API is provided to query the data from a neaboard server by any client
application.

Tha data is returned in the json format and got by an http query.

METHODS

Threads

/api/threads/N/?offset=M&tag=O

Get a thread list. You will get N threads (required parameter) starting from
Mth one (optional parameter, default is 0) with the tag O (optional parameter,
threads with any tags are shown by default).

Tags

/api/tags/

Get all active tag list. Active tag is a tag that has at least 1 active thread
associated with it.

Thread

/api/thread/N/

Get all Nth thread post. N is an opening post ID for the thread.

Output format:

  • posts: list of posts
  • last_update: last update timestamp

Thread diff

/api/diff_thread/N/M/?type=O

Get the diff of the thread with id=N from the M timestamp in the O
format. 2 formats are available: html (used in AJAX thread update) and
json. The default format is html. Return list format:

  • added: list of added posts
  • updated: list of updated posts
  • last_update: last update timestamp

General info

In case of incorrect request you can get http error 404.

Response JSON for a post or thread contains:

  • id
  • title
  • text
  • image (if image available)
  • image_preview (if image available)
  • bump_time (for threads)

In future, it will also contain:

  • tags list (for thread)
  • publishing time
  • bump time
  • reply IDs (if available)