MediaWiki

Extension:StructuredDiscussions/API

< Extension:StructuredDiscussions(Redirected from Extension:Flow/API)
See also Flow/Architecture/API and Gerrit change 107411

Most Flow API read and write interactions are submodules of action=flow. Flow also implements a query property flowinfo and a parsing utility module flow-parsoid-utils.

DetectionEdit

flowinfo

This module cannot be used as a generator.
Prefix fli
Required rights none
Post only? No
Generated help Current

prop=flowinfo (details below) is one way to check if Flow is enabled on the specified pages.

You can alternatively use prop=info to retrieve page info including content model. The content model will be 'flow-board' if it's enabled. Compare https://en.wikipedia.org/w/api.php?action=query&titles=Wikipedia%20talk:WikiProject%20Breakfast&prop=info and https://en.wikipedia.org/w/api.php?action=query&titles=Wikipedia%20talk:Articles%20for%20deletion&prop=info .

In client-side JavaScript (for gadgets and user scripts), call mw.config.get( 'wgPageContentModel' ).

prop=flowinfo (fli)

(main | query | flowinfo)
  • This module is deprecated.
  • This module requires read rights.
  • Source: Flow
  • License: GPL-2.0-or-later

Get basic Structured Discussions information about a page.

Example:
Fetch Structured Discussions information about Talk:Sandbox, Main Page, and Talk:Structured Discussions
api.php?action=query&prop=flowinfo&titles=Talk:Sandbox|Main_Page|Talk:Flow [open in sandbox]

action=flowEdit

flow

This module cannot be used as a generator.
Prefix none
Required rights none
Post only? No
Generated help Current

All action=flow requests take the following parameters:

  • submodule: The specific flow submodule you want to use. See below for documentation on some of them
  • workflow: Id of the workflow to take action upon
  • page: Page title of the page to take action upon
  • token: An edit token (see API:Tokens). This is required for all write modules.
  • render: Include this to have an HTML rendering be returned in the output. Used by the extension's JS modules.

For any action that posts data, you will need a token, which defeats cross-site request forgery. To get this, use meta=tokens: Gets a CSRF token

api.php?action=query&format=json&meta=tokens [try in ApiSandbox]
Result
{
    "query": {
        "tokens": {
            "csrftoken": "d197bab38bd17ee31f0f439202945fdf54c98fb6+\\"
        }
    }
}

view-topiclistEdit

submodule=view-topiclist (vtl)

(main | flow | view-topiclist)

View a list of topics.

Parameters:
vtloffset-dir

Direction to order the topics.

One of the following values: fwd, rev
Default: fwd
vtlsortby

Sorting option of the topics, either updated (ordered by topic update time), or newest (ordered by topic creation time).

One of the following values: newest, updated, user
Default: user
vtlsavesortby

Save sortby option to user preferences, if set.

Type: boolean (details)
vtloffset-id

Offset value (in UUID format) to start fetching topics at; used only with newest ordering

vtloffset

Offset value (as a topic update timestamp, in TS_MW format (YYYYMMDDHHMMSS)), to start fetching topics at; used only with updated ordering

vtlinclude-offset

Includes the offset item in the results as well.

Type: boolean (details)
vtllimit

Number of topics to fetch.

Type: integer or max
The value must be between 0 and 100.
Default: 10
vtltoconly

Whether to respond with only the information required for the TOC.

Type: boolean (details)
vtlformat

Format to return the content in.

One of the following values: fixed-html, html, wikitext
Default: fixed-html
Example:
List topics on Talk:Sandbox
api.php?action=flow&submodule=view-topiclist&page=Talk:Sandbox [open in sandbox]

new-topicEdit

submodule=new-topic (nt)

(main | flow | new-topic)
  • This module requires read rights.
  • This module requires write rights.
  • This module only accepts POST requests.
  • Source: Flow
  • License: GPL-2.0-or-later

Creates a new Structured Discussions topic on the given workflow.

Parameters:
nttopic

Text for new topic title.

This parameter is required.
ntcontent

Content for the topic's initial reply.

This parameter is required.
ntformat

Format of the new topic's initial reply (wikitext|html)

One of the following values: html, wikitext
Default: wikitext
token

A "csrf" token retrieved from action=query&meta=tokens

This parameter is required.
Example:
Create a new topic on Talk:Sandbox
api.php?action=flow&submodule=new-topic&page=Talk:Sandbox&nttopic=Hi&ntcontent=Nice%20to&20meet%20you&ntformat=wikitext [open in sandbox]

(Since this edit operation has to be an HTTP POST, the link in the generated example above won't work.)

action=flow-parsoid-utilsEdit

flow-parsoid-utils

This module cannot be used as a generator.
Prefix none
Required rights none
Post only? No
Generated help Current


action=flow-parsoid-utils

(main | flow-parsoid-utils)

Convert text between wikitext and HTML.

Parameters:
from

Format to convert content from.

This parameter is required.
One of the following values: html, wikitext
to

Format to convert content to.

This parameter is required.
One of the following values: html, wikitext
content

Content to be converted.

This parameter is required.
title

Title of the page. Cannot be used together with pageid.

pageid

ID of the page. Cannot be used together with title.

Type: integer
Example:
Convert wikitext '''lorem''' ''blah'' to HTML
api.php?action=flow-parsoid-utils&from=wikitext&to=html&content='''lorem'''+''blah''&title=Main_Page [open in sandbox]
Retrieved from "https://www.mediawiki.org/w/index.php?title=Extension:StructuredDiscussions/API&oldid=3834630"