Mirror
/
zulip
mirror of https://github.com/zulip/zulip.git
1
0
Fork 0
Code Issues Projects Releases Wiki Activity
zulip/templates/zerver/api/get-linkifiers.md

33 lines
557 B
Markdown
Raw Normal View History

linkifiers: Rename articles to current feature name. These were previously called "linkification filters", but we now want to consistently refer to them as "linkifiers" in the UI and API docs.
2018-10-16 21:01:17 +02:00
# List linkifiers
api docs: Document GET /realm/filters.
2018-08-14 03:10:37 +02:00
openapi: Use description markdown for rendering endpoint descriptions. Firstly, change endpoint descriptions in zulip.yaml so that they match their counterpart in the api docs. Then edit the api docs so that they use api description markdown extension for displaying endpoint description.
2020-04-28 20:00:46 +02:00
{generate_api_description(/realm/filters:get)}
api docs: Document GET /realm/filters.
2018-08-14 03:10:37 +02:00
## Usage examples
api_docs: Use tabbed_sections extension in new API docs.
2018-10-18 00:14:30 +02:00
{start_tabs}
{tab|python}
api docs: Document GET /realm/filters.
2018-08-14 03:10:37 +02:00
api_docs: Use tabbed_sections extension in new API docs.
2018-10-18 00:14:30 +02:00
{generate_code_example(python)|/realm/filters:get|example}
{tab|curl}
api docs: Document GET /realm/filters.
2018-08-14 03:10:37 +02:00
docs: Make list-linkifiers use curl example system.
2019-10-14 11:42:03 +02:00
{generate_code_example(curl)|/realm/filters:get|example}
api docs: Document GET /realm/filters.
2018-08-14 03:10:37 +02:00
api_docs: Use tabbed_sections extension in new API docs.
2018-10-18 00:14:30 +02:00
{end_tabs}
api docs: Document GET /realm/filters.
2018-08-14 03:10:37 +02:00
openapi_docs: Replace `argument` with `parameter`. The term `parameter` is a better word than `argument` for data passed to an API endpoint; this is why OpenAPI uses in their terminology. Replace `argument` with `parameter` in the API docs to improve their readability. Fixes #15435.
2020-06-18 15:35:25 +02:00
## Parameters
api docs: Document GET /realm/filters.
2018-08-14 03:10:37 +02:00
{generate_api_arguments_table|zulip.yaml|/realm/filters:get}
## Response
#### Return values
openapi: Add markdown extension for rendering return values in API docs. Currently response return values have to be written twice, once in the docs and once in zulip.yaml. Create a markdown extension so that the return values in api docs are rendered using content from zulip.yaml
2020-05-20 11:57:57 +02:00
{generate_return_values_table|zulip.yaml|/realm/filters:get}
api docs: Document GET /realm/filters.
2018-08-14 03:10:37 +02:00
#### Example response
A typical successful JSON response may look like:
{generate_code_example|/realm/filters:get|fixture(200)}