|
|
Line 1: |
Line 1: |
| ; [[Site:API:Comments|Comments]] | | ; [[Site:API:Comments|Comments]] |
| ; [[Site:API:Forums|Forums]] | | ; [[Site:API:Forums|Forums]] |
− |
| |
− | = Forums =
| |
− |
| |
− | == Add Forum ==
| |
− |
| |
− | This API call is responsible for adding a forum to a site.
| |
− |
| |
− | === Authentication Restrictions ===
| |
− |
| |
− | Administrators only.
| |
− |
| |
− | === Required Parameters ===
| |
− |
| |
− | ;action=forum
| |
− | ;verb=addforum
| |
− | ;title
| |
− | :the forum title; this field is used to calculate the canonical_id, if not provided.
| |
− |
| |
− | === Optional Parameters ===
| |
− |
| |
− | ; description
| |
− | : the forum description.
| |
− | ;layout
| |
− | : the position of this forum relative to other forums.
| |
− | ;label
| |
− | : allows grouping of forums based on label.
| |
− | ;canonical_id
| |
− | : the nice looking identifier for human readable ids; filtering will be performed to ensure proper syntax.
| |
− |
| |
− | === Successful Response ===
| |
− |
| |
− | ;status=ok
| |
− | ;item
| |
− |
| |
− | :;forum
| |
− |
| |
− | ::;id
| |
− | ::: the id of the newly created forum.
| |
− |
| |
− | ::;canonical_id
| |
− | ::: the canonical_id of the newly created forum.
| |
− |
| |
− | == Edit Forum ==
| |
− |
| |
− | This API call is responsible for editing a forum.
| |
− |
| |
− | === Authentication Restrictions ===
| |
− |
| |
− | Administrators only.
| |
− |
| |
− | === Required Parameters ===
| |
− |
| |
− | ;action=forum
| |
− | ;verb=editforum
| |
− | ;forumId
| |
− | :the forum id.
| |
− |
| |
− | === Optional Parameters ===
| |
− |
| |
− | ;title
| |
− | :the forum title; this field is used to calculate the canonical_id, if not provided.
| |
− | ; description
| |
− | : the forum description.
| |
− | ;layout
| |
− | : the position of this forum relative to other forums.
| |
− | ;label
| |
− | : allows grouping of forums based on label.
| |
− | ;canonical_id
| |
− | : the nice looking identifier for human readable ids; filtering will be performed to ensure proper syntax.
| |
− |
| |
− | === Successful Response ===
| |
− |
| |
− | ;status=ok
| |
− |
| |
− | == Delete Forum ==
| |
− |
| |
− | This API call is responsible for deleting a forum and all of its threads and replies.
| |
− |
| |
− | === Authentication Restrictions ===
| |
− |
| |
− | Administrators only.
| |
− |
| |
− | === Required Parameters ===
| |
− |
| |
− | ;action=forum
| |
− | ;verb=delforum
| |
− | ;forumId
| |
− | :the forum id.
| |
− |
| |
− | === Successful Response ===
| |
− |
| |
− | ;status=ok
| |
− |
| |
− | == Add Thread ==
| |
− |
| |
− | This API call is responsible for adding a thread to a forum.
| |
− |
| |
− | === Authentication Restrictions ===
| |
− |
| |
− | Any authenticated user.
| |
− |
| |
− | === Required Parameters ===
| |
− |
| |
− | ;action=forum
| |
− | ;verb=addthread
| |
− | ;forumId
| |
− | :the forum id
| |
− | ;title
| |
− | :the thread title; this field is used to calculate the canonical_id, if no canonical_id is supplied.
| |
− | ; description
| |
− | : the thread description.
| |
− |
| |
− | === Optional Parameters ===
| |
− |
| |
− | ;canonical_id
| |
− | : the nice looking identifier for human readable ids; filtering will be performed to ensure proper syntax.
| |
− |
| |
− |
| |
− | === Successful Response ===
| |
− |
| |
− | ;status=ok
| |
− | ;item
| |
− |
| |
− | :;thread
| |
− |
| |
− | ::;id
| |
− | ::: the id of the newly created thread.
| |
− |
| |
− | ::;canonical_id
| |
− | ::: the canonical_id of the newly created thread.
| |
− |
| |
− | == Add Reply ==
| |
− |
| |
− | This API call is responsible for adding a reply to a forum post.
| |
− |
| |
− | === Authentication Restrictions ===
| |
− |
| |
− | Any authenticated user.
| |
− |
| |
− | === Required Parameters ===
| |
− |
| |
− | ;action=forum
| |
− | ;verb=addreply
| |
− | ;postId
| |
− | :the post id; this can be either a thread id or a reply id.
| |
− | ; description
| |
− | : the reply description.
| |
− |
| |
− | === Optional Parameters ===
| |
− | ;quote
| |
− | :text that you want to quote in your reply; this only applies if postId is a reply id; this is limited to 255 characters.
| |
− |
| |
− | === Successful Response ===
| |
− |
| |
− | ;status=ok
| |
− | ;item
| |
− |
| |
− | :;reply
| |
− |
| |
− | ::;id
| |
− | ::: the id of the newly created reply.
| |
− |
| |
− | == Edit Post ==
| |
− |
| |
− | This API call is responsible for editing a forum post.
| |
− |
| |
− | === Authentication Restrictions ===
| |
− |
| |
− | Superuser or user with moderator or administrator access. Post user is only able to update title and description for threads and description for replies.
| |
− |
| |
− | === Required Parameters ===
| |
− |
| |
− | ;action=forum
| |
− | ;verb=editpost
| |
− | ;postId
| |
− | :the post id; this can be either a thread id or a reply id.
| |
− |
| |
− | === Optional Parameters ===
| |
− | ; title
| |
− | : the post title; only applies if postId is a thread id;
| |
− | ; description
| |
− | : the post description.
| |
− | ;canonical_id
| |
− | :the canonical id of the forum post; only applies if postId is a thread id.
| |
− | ;forumId
| |
− | :the id of the forum that this post belongs to; only applies if postId is a thread id.
| |
− | ;sticky=yes|no
| |
− | :whether or not this post is sticky; only applies if postId is a thread id.
| |
− | ;quote
| |
− | :text that you want to quote in your reply; only applies if postId is a reply id; this is limited to 255 characters.
| |
− |
| |
− | === Successful Response ===
| |
− |
| |
− | ;status=ok
| |
− |
| |
− | == Delete Post ==
| |
− |
| |
− | This API call is responsible for deleting a forum post.
| |
− |
| |
− | === Authentication Restrictions ===
| |
− |
| |
− | Administrators or Moderators; Post user is able to delete as long as post is not a thread with a reply count greater than 0.
| |
− |
| |
− | === Required Parameters ===
| |
− |
| |
− | ;action=forum
| |
− | ;verb=delpost
| |
− | ;postId
| |
− | :the post id; this can be either a thread id or a reply id.
| |
− |
| |
− | === Successful Response ===
| |
− |
| |
− | ;status=ok
| |