Extension:Wikibase Repository/API1

For the moment this is nothing more than the landing page for the link from the API extension, and contains a more complete description of the actual parameters and formats.

Actions
Note that for editing operations the client (usually the browser) must first request an edit token.

GetItem
See also [//en.wikipedia.org/w/api.php?action=help&modules=wbgetitem api-generated help] (localhost).


 * Example normal result : This is a slight rewamp of the result on Wikidata/Data_model/JSON to accommodate for normal output as given by prop=info.


 * Example normalized result : This is really a lookup with some transformation and then the result of the final landing page.


 * Example redirected result : This is really a lookup through a label/alias and then the result of the final landing page. (?)


 * Example failed result : This could imply some attempt to normalize in addition (and most often will).

''This module could be reimplemented as a query module. If its not a query module then it should only return data for one single item (with exact match) and fail if this is not found. Note that even if only one item (entity described on a single page) will be returned the structure still use a plural form (entities described on several found pages).''

GetItemId
See also [//en.wikipedia.org/w/api.php?action=help&modules=wbgetitemid api-generated help] (localhost).

''This module could be reimplemented as a query module. If its not a query module then it should only return data for one single item (with exact match) and fail if this is not found.''

QueryItem
Probably not implemented during Phase I. Note that this only needs the ability to iterate over ordinary page titles and page ids.

AssociateArticle
See also [//en.wikipedia.org/w/api.php?action=help&modules=wbassociatearticle api-generated help] (localhost).

''This is an edit operation and as such needs a valid edit token supplied by a user allowed to edit. It must also be a POST request.''

LinkArticles
See also [//en.wikipedia.org/w/api.php?action=help&modules=wblinkarticles api-generated help] (localhost).

''This is an edit operation and as such needs a valid edit token supplied by a user allowed to edit. It must also be a POST request.''

AddAlias
See also [//en.wikipedia.org/w/api.php?action=help&modules=wbaddalias api-generated help] (localhost).

''This is an edit operation and as such needs a valid edit token supplied by a user allowed to edit. It must also be a POST request.''

RemoveAlias
See also [//en.wikipedia.org/w/api.php?action=help&modules=wbremovealias api-generated help] (localhost).

''This is an edit operation and as such needs a valid edit token supplied by a user allowed to edit. It must also be a POST request.''

SetDescription
See also [//en.wikipedia.org/w/api.php?action=help&modules=wbsetdescription api-generated help] (localhost).

''This is an edit operation and as such needs a valid edit token supplied by a user allowed to edit. It must also be a POST request. According to a REST philosophy it can be argued that this should be a PUT request.''

SetLabel
See also [//en.wikipedia.org/w/api.php?action=help&modules=wbsetlabel api-generated help] (localhost).

''This is an edit operation and as such needs a valid edit token supplied by a user allowed to edit. It must also be a POST request. According to a REST philosophy it can be argued that this should be a PUT request.''

SearchByName
Not implemented during Phase I as this would need some kind of searchable store, most likely a NoSQL store of some kind.

Exceptions
Exceptions may or may not be returned as web pages, but will be structured according for format if the exception is a prepared and expected condition.

See also API:Errors and warnings

Warnings

 * Use a valid warning situation as example.

A warning condition may be given together with the normal output, and it will indicate a situation where the output can be erroneous.

If the warning condition is prepared and expected, and a format is defined, it will have the following form when  is set (example)

or when the  is set (example)

Note that  is the default format and will give the help page.

Errors
If the error condition is prepared and expected, and a format is defined, it will have the following form when  is set (example)

or when the  is set (example)

Note that  is the default format and will give the help page.

Not implemented
Typical error message when an function is not implemented and  is set (example – only works with the extension)

or when the  is set (example – only works with the extension)

Todo

 * Link to the correct instance at the labs cloud.