Reconciliation API modules: `recon-suggest-type`

Service for suggesting types (https://www.w3.org/community/reports/reconciliation/CG-FINAL-specs-0.2-20230410/#types). In MediaWiki core, a type translates to a Category. In SMW, it translates to either a Concept or a wiki page (e.g. Person) used as the value of a property that stores the class of a page.

Parameters

API documentation

Parameter name

Description

source

Currently supports mw (MediaWiki core) and smw (Semantic MediaWiki).

profile

Used with source=smw.

cat

Used with source=mw. The top category, or categories, from which to search for lower-level subcategories (max. 250), up to a depth of 5 subcategory levels. Optional.

substrpattern

Substring pattern.

substr

Substring.

offset

Result offset.

limit

Result limit.

with source=mw

When this module is used with source=mw, the type suggested is a MediaWiki Category. It also means that the internal mechanics of MediaWiki itself are used for retrieving Categories and their subcategories. It is currently untested if extensions like Semantic MediaWiki could provide a better alternative.

Search for any Category

{{#recon-sitesearch: |apiurl=https://codecs.vanhamel.nl/api.php |apiurlparams=action=recon-suggest-type origin=* source=mw substrpattern=stringprefix substr= |targeturl=https://codecs.vanhamel.nl/Special:Search?search= |dev=true }}

Search for Subcategories of 'Irish texts'

{{#recon-sitesearch: |apiurl=https://codecs.vanhamel.nl/api.php |apiurlparams=action=recon-suggest-type origin=* source=mw cat=Irish texts substrpattern=allchars substr= |targeturl=https://codecs.vanhamel.nl/Special:Search?search= |dev=true }}

Examples from CODECS

https://codecs.vanhamel.nl/api.php?action=recon-suggest-type&origin=*&source=mw&substrpattern=stringprefix&substr=sub (without parent category)
https://codecs.vanhamel.nl/api.php?action=recon-suggest-type&source=mw&cat=Irish%20texts&substrpattern=allchars&substr=sc&offset=0 (with parent category)

with source=smw: Concepts

{{#recon-sitesearch: |apiurl=https://codecs.vanhamel.nl/api.php?origin=* |apiurlparams=action=recon-suggest-type format=json source=smw substrpattern=allchars substr= |targeturl=https://codecs.vanhamel.nl/Special:Search?search= |dev=true }}

https://codecs.vanhamel.nl/api.php?action=recon-suggest-type&source=smw&format=jsonfm&substr=A

with source=smw: 'class pages'