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.

Detection

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

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

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 Special:ApiSandbox#action=query&titles=Project:Village+pump&prop=info and Special:ApiSandbox#Extension:StructuredDiscussions/API&prop=info.

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

The following documentation is the output of Special:ApiHelp/query+flowinfo, automatically generated by the pre-release version of MediaWiki that is running on this site (MediaWiki.org).

prop=flowinfo (fli)

(main | query | flowinfo)

Этот модуль устарел.
Этот модуль требует прав на чтение.
Источник: Flow
Лицензия: GPL-2.0-or-later

Получить основную информацию Структурированных обсуждений о странице.

https://www.mediawiki.org/wiki/Special:MyLanguage/Extension:Flow/API#action.3Dquery.26prop.3Dflowinfo

Пример:

Извлечь информацию Структурированных обсуждений о Talk:Sandbox, Заглавная страница и Talk:Structured Discussions: api.php?action=query&prop=flowinfo&titles=Talk:Sandbox|Main_Page|Talk:Flow [открыть в песочнице]

action=flow

The following documentation is the output of Special:ApiHelp/flow, automatically generated by the pre-release version of MediaWiki that is running on this site (MediaWiki.org).

action=flow

(main | flow)

Этот модуль требует прав на чтение.
Источник: Flow
Лицензия: GPL-2.0-or-later

Позволяет применять действия к страницам Структурированных обсуждений.

https://www.mediawiki.org/wiki/Extension:Flow/API

Определённые параметры:

Other general parameters are available.

submodule

Вызываемый подмодуль Структурированных обсуждений.

edit-header: Редактирует описание доски.
edit-post: Редактирует содержимое сообщения.
edit-title: Редактирует заголовок темы.
edit-topic-summary: Редактирует описание содержимого темы.
lock-topic: Закрыть или открыть тему в Структурированных обсуждениях.
moderate-post: Модерирование сообщения в Структурированных обсуждениях.
moderate-topic: Модерирует тему в Структурированных обсуждениях.
new-topic: Создаёт новую тему Структурированных обсуждений в заданном потоке.
reply: Отвечает на сообщение.
undo-edit-header: Получить информацию, необходимую для отмены правок описания.
undo-edit-post: Получить информацию, необходимую для отмены правки сообщения.
undo-edit-topic-summary: Получить информацию, необходимую для отмены правок описания темы.
view-header: Просмотреть описание доски.
view-post: Просмотреть сообщение.
view-post-history: Просмотреть историю версий сообщения.
view-topic: Просмотреть тему.
view-topic-history: Просмотреть историю версий темы.
view-topic-summary: Просмотреть описание темы.
view-topiclist: Просмотреть список тем.
close-open-topic: Устарело. Не рекомендуется, используйте action=flow&submodule=lock-topic.

Это обязательный параметр.

Одно из следующих значений: edit-header, edit-post, edit-title, edit-topic-summary, lock-topic, moderate-post, moderate-topic, new-topic, reply, undo-edit-header, undo-edit-post, undo-edit-topic-summary, view-header, view-post-history, view-post, view-topic-history, view-topic-summary, view-topic, view-topiclist, close-open-topic

page

Страница, к которой применяются действия.

По умолчанию: Topic:Flow-enabled_page

token

Токен, полученный из action=query&meta=tokens

По умолчанию: (пусто)

Пример:

Править описание у «Talk:Sandbox»: api.php?action=flow&submodule=edit-header&page=Talk:Sandbox&ehprev_revision=???&ehcontent=Nice%20to&20meet%20you [открыть в песочнице]

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

Replying

In a reply you're replying to a particular post in a workflow (a topic). Flow objects are identified by UUIDs see Flow/Architecture.

To reply to a topic

you'll need a token. Flow recently switched to using the regular 'edit' token for most operations, so you can use mw.api.postWithEditToken to get the editing token if it hasn't been cached yet in the session. it's cached.
Issue a flow API request with flowaction=reply, identifying the topic workflow. The parameters for a reply include the topic and the post.

action=flow
submodule=reply
format=json
repreplyTo=050fed5dc6bd5085237590b11c2fa805
repcontent=My reply, with ''wikitext''.

render=true
token=43a71deb105e7c0be7e8eeab4bdff4f7+\
workflow=050f698e3f6e5624fa1590b11c27932f

Set render=true if you want the server to respond with the "fully-decorated" HTML to interact with the new post (preview buttons, actions, etc.).
UUID format will soon change to be more compact, using 88-bit represented as alphadecimal.
Obviously you get the topic and post to respond by making API queries, rather than hardcoding these numbers.

Note that a wiki may store Flow content with $wgFlowContentFormat 'html' or 'wikitext', but in any edit submission you must submit wikitext.

If successful, the server responds with the post-id of the new post, and the HTML to insert into the DOM.

Note this API request doesn't name the page on which the topic appears. Users interact with topics on a Flow board with a wiki page name, but a topic might (eventually) appear on multiple pages, e.g. a user's "subscription feed".

On WMF wikis, Flow stores post content as HTML with embedded Parsoid markup so that something resembling the original wikitext can be reconstituted for editing. This will not be the case on all wikis, others might store as wikitext.

Block requests

When you make a "Block" API request such as &submodule=new-topic, the API normally returns a flow.new-topic.result.topiclist containing updated information about the top 10 topics on the board, including their HTML. This allows the Flow board to redisplay the board contents, but it can be a lot of data.

If you are just trying to add a topic and you're not interested in the board contents, you should pass the flag ntmetadataonly=true (gerrit:180588)

Flow returns the metadata in a top-level flow.newtopic.committed key in the API response. For consistency the information about the new content is returned as topic-page, topic-id, topic-revision-id, post-id, header-post-id (but see phab:T84954), etc.

Editing the board header

If you want to update the Flow board header, it's similar

make a GET request action=flow, submodule=view-header, vhformat=wikitext to get the current contents. This will return a flow.view-header.result.header.revision including a UUID of the most recent version of the header in revisionId, and its contents in content.content.
make a POST request, action=flow, submodule=edit-header. Set ehprev_revision to the revision returned by the GET request and set ehcontent to your updated wikitext.

The update may fail with error.code = 'prev_revision' if someone else updated this board's header between the two requests; if so the return has a prev_revision.revision_id giving the new latest revision, so you can retry with that. However, you should avoid clobbering the previous editors' work (e.g. by presenting an edit conflict form, or re-running the algorithm if a bot is making the requests, etc.).

Posting a new topic from on-wiki JavaScript

If an on-wiki user script or gadget needs to be post a new topic, the best way is to use MessagePoster. The advantage is that you don't need to know whether the talk pages uses old-style talk pages or Flow. It will work either way (LiquidThreads is not supported).

mw.loader.using( [ 'mediawiki.Title', 'mediawiki.messagePoster' ], function () {
    var title = new mw.Title( 'Talk:MyTalkPage' );
    var posterPromise = mw.messagePoster.factory.create( title );
    posterPromise.done( function ( poster ) {
        poster.post( 'This is the topic title', 'This is the body of a message posted with MessagePoster' );
    } );
} );

action=flow-parsoid-utils

The following documentation is the output of Special:ApiHelp/flow-parsoid-utils, automatically generated by the pre-release version of MediaWiki that is running on this site (MediaWiki.org).

action=flow-parsoid-utils

(main | flow-parsoid-utils)

Этот модуль требует прав на чтение.
Источник: Flow
Лицензия: GPL-2.0-or-later

Конвертировать текст между вики-кодом и HTML.

Определённые параметры:

Other general parameters are available.

from: Формат из которого преобразуется содержимое.; Это обязательный параметр.; Одно из следующих значений: html, wikitext
to: Формат в который преобразуется содержимое.; Это обязательный параметр.; Одно из следующих значений: html, wikitext
content: Конвертируемое содержимое.; Это обязательный параметр.
title: Заголовок страницы. Не может использоваться вместе с pageid.
pageid: Идентификатор страницы. Не может использоваться вместе с title.; Тип: целочисленное значение

Пример:

Преобразование вики-текста '''lorem''' ''blah'' в HTML: api.php?action=flow-parsoid-utils&from=wikitext&to=html&content='''lorem'''+''blah''&title=Main_Page [открыть в песочнице]