Site:API
From Metrixstream
(Difference between revisions)
MetrixAdmin (Talk | contribs) (→Add Forum) |
MetrixAdmin (Talk | contribs) (→Forums) |
||
Line 39: | Line 39: | ||
::;canonical_id | ::;canonical_id | ||
::: the canonical_id of the newly created forum. | ::: the canonical_id of the newly created forum. | ||
+ | |||
+ | == 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. | ||
+ | ; description | ||
+ | : the thread description. | ||
+ | |||
+ | === Successful Response === | ||
+ | |||
+ | ;status=ok | ||
+ | ;item | ||
+ | |||
+ | :;thread | ||
+ | |||
+ | ::;id | ||
+ | ::: the id of the newly created thread. | ||
+ | |||
+ | ::;canonical_id | ||
+ | ::: the canonical_id of the newly created thread. |
Revision as of 12:48, 11 April 2012
Contents |
Forums
Add Forum
This API call is responsible for adding a forum to a site.
Authentication Restrictions
Superuser or user with moderator or administrator access.
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.
Successful Response
- status=ok
- item
- forum
- id
- the id of the newly created forum.
- canonical_id
- the canonical_id of the newly created forum.
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.
- description
- the thread description.
Successful Response
- status=ok
- item
- thread
- id
- the id of the newly created thread.
- canonical_id
- the canonical_id of the newly created thread.