Site:API
MetrixAdmin (Talk | contribs) (→Authentication Restrictions) |
MetrixAdmin (Talk | contribs) (→Forums) |
||
Line 1: | Line 1: | ||
+ | = Comments = | ||
+ | |||
+ | == Add Comment == | ||
+ | |||
+ | This API call is responsible for adding a comment to an object. | ||
+ | |||
+ | === Authentication Restrictions === | ||
+ | |||
+ | Any authenticated user. | ||
+ | |||
+ | === Required Parameters === | ||
+ | |||
+ | ;action=comment | ||
+ | ;verb=addcomment | ||
+ | ;objtype | ||
+ | :content, owner, user | ||
+ | ;objid | ||
+ | ;msg | ||
+ | :the comment message; no more than 2048 characters. | ||
+ | |||
+ | === Successful Response === | ||
+ | |||
+ | ;status=ok | ||
+ | ;comment | ||
+ | :;id | ||
+ | ::: the id of the newly created comment. | ||
+ | |||
= Forums = | = Forums = | ||
Revision as of 14:52, 30 April 2012
Contents |
Comments
Add Comment
This API call is responsible for adding a comment to an object.
Authentication Restrictions
Any authenticated user.
Required Parameters
- action=comment
- verb=addcomment
- objtype
- content, owner, user
- objid
- msg
- the comment message; no more than 2048 characters.
Successful Response
- status=ok
- comment
- id
- the id of the newly created comment.
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
- 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