Overview
public. Retrieve pages with tag
Uri Parameters
| Name | Type | Description |
| tagid | string | either an integer tag ID or "=" followed by a double uri-encoded tag name |
Query Parameters
| Name | Type | Description |
| authenticate | bool? | Force authentication for request (default: false) |
| language | string? | filter pages by language (default: all languages) |
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
Input: None
Output:
<tag value="{text}" id="{int}" href="{uri}" count="{int}">
<type>{text|date|define}</type>
<uri>{uri}</uri>
<title>{text}</title>
<pages count="{int}">
<page id="{int}" href="{uri}">
<uri.ui>{uri}</uri.ui>
<title>{text}</title>
<path>{text}</path>
<namespace>{namespace}</namespace>
</page>
</pages>
</tag>
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.