v3.2.0+
| Status: | effective |
| Progress: | 100% |
| Version: | 3.2.0+ |
API module "smwbrowse"
From semantic-mediawiki.org
| smwbrowse | |
|---|---|
| Allows to search for properties, categories and concepts | |
| Keywords | |
| Further Information | |
| Provided by: | Semantic MediaWiki |
| Added: | 3.0.0 |
| Removed: | still available |
The "smwbrowse" API module supports the search for pages, properties, categories and concepts via action "smwbrowse" (?action=smwbrowse) against Semantic MediaWiki using the MediaWiki API and get results back serialized in one of the supported formats. This module is similar to API-module "browsebyproperty"Allows to fetch information about a property or a list of properties. It was introduced with Semantic MediaWiki 3.0.0Released on 11 October 2018 and compatible with MW 1.27.0 - 1.31.x..1234
The module supports two submodules:
- "
browse": The object to be searched. One of the possible object types:- "
page" - "
subject" - "
property" - "
pvalue" - "
category" - "
concept"
- "
- "
params": The query parameters to be used in JSON-format.- primary selectors:
- "
limit" - "
offset" - "
search" (allows to use*as a wildcard identifier; available since Semantic MediaWiki 3.2.0Released on 7 September 2020 and compatible with MW 1.31.0 - 1.35.x.5) - "
property" (only available if "pvalue" was chosen as the object type for the "browse" parameter)
- "
- special selectors:
- "
description" - "
prefLabel" - "
usageCount" (only available if "property" was chosen as the object type for the "browse" parameter)
- "
- primary selectors:
Returned results are by default cached for one hour. This time span may be adapted via the "
api.browse" or "api.browse.pvalue" option respectively to configuration parameter $smwgCacheUsageSets how the caching behaviour or special pages related to Semantic MediaWiki is controlled.
Examples[edit]
- page information
../api.php?action=smwbrowse&browse=page¶ms={ "limit": 10, "offset": 0, "search": "Main", "fullText": true, "fullURL": true }- → run example
- subobject information
../api.php?action=smwbrowse&browse=subject¶ms={ "subject": "Examples/Subobject_identifiers_(named_vs._anonymous)", "ns" :0, "iw": "", "subobject": "_21f057b12efd9f579b1da4d2c7f14f66"- → run example
- property information
../api.php?action=smwbrowse&browse=property¶ms={ "limit": 10, "offset": 0, "search": "Date", "description": true, "prefLabel": true, "usageCount": true }- → run example
- property values
../api.php?action=smwbrowse&browse=pvalue¶ms={ "limit": 10, "offset": 0, "property" : "Located in", "search": "Germany" }- → run example
- category information
../api.php?action=smwbrowse&browse=category¶ms={ "limit": 10, "offset": 0, "search": "Date" }- → run example
- concept information
../api.php?action=smwbrowse&browse=concept¶ms={ "limit": 10, "offset": 0, "search": "Event" }- → run example
References
- ^ | Semantic MediaWiki: GitHub pull request gh:smw:2696
- ^ Semantic MediaWiki: GitHub pull request gh:smw:2721
- ^ Semantic MediaWiki: GitHub pull request gh:smw:3129
- ^ Semantic MediaWiki: GitHub pull request gh:smw:3445
- ^ Semantic MediaWiki: GitHub pull request gh:smw:4428