Overview
public. Retrieve the tags on a page.
Uri Parameters
| Name | Type | Description |
| pageid | string | either an integer page ID, "home", or "=" followed by a double uri-encoded page title |
Query Parameters
| Name | Type | Description |
| authenticate | bool? | Force authentication for request (default: false) |
| redirects | int? | If zero, do not follow page redirects. |
Return Codes
| Name | Value | Description |
| BadRequest | 400 | Invalid input parameter or request body |
| Forbidden | 403 | Read access to the page is required |
| NotFound | 404 | The requested page could not be found |
| Ok | 200 | The request completed successfully |
Message Format
Output:
<tags count="{int}" href="{uri}">
<tag value="{text}">
<type>{text|date|define}</type>
<uri>{text}</uri>
<title>{text}</title>
<related count="{int}">
<page id="{int}" href="{uri}">
<title>{text}</title>
<path>{text}</path>
</page>
</related>
</tag>
...
</tags>
Implementation Notes
Tagging is a means
of categorizing pages. There are currently three types of supported tags:
- Date: Defines a date or date range for the page.
- Define: Indicates that this is a defining tag. All other pages with a text tag having the same name will be marked as related to the page.
- Text: Standard tag type.
