Aide de l’API MediaWiki
Ceci est une page d’aide de l’API de MediaWiki générée automatiquement.
Documentation et exemples : https://www.mediawiki.org/wiki/Special:MyLanguage/API:Main_page
action=wbsetreference
- Ce module nécessite des droits de lecture.
- Ce module nécessite des droits d’écriture.
- Ce module accepte seulement les requêtes POST.
- Source : WikibaseClient
- Licence : GPL-2.0-or-later
Crée une référence ou définit la valeur d’une référence existante.
- statement
Un GUID identifiant l’énoncé pour lequel une référence a été fixée
- Ce paramètre est obligatoire.
- snaks
Les snaks pour lesquels ont définit la référence. Objet JSON avec des Id de propriété qui pointent vers des tableaux contenant les snaks pour cette propriété
- Ce paramètre est obligatoire.
- snaks-order
L'ordre des snaks. Tableau JSON de chaînes d’ID de propriété
- reference
Une valeur de hachage associée à la référence qui doit être mise à jour. Facultatif. Si elle n'est pas fournie, une nouvelle référence est créée
- index
L'indice à l'intérieur de la liste de références de la déclaration où il faut pour déplacer la référence. Facultatif. Lorsqu'il n'est pas fourni, une référence qui existe restera au même endroit alors qu'une nouvelle référence sera ajoutée à la liste.
- Type: entier
- summary
Résumé de la modification. Sera préfixé par un commentaire généré automatiquement. La taille limite du commentaire automatique ajouté au résumé est de 260 caractères pour l'ensemble. Notez bien que tout ce qui est au-delà de cette limite sera tronqué.
Les balises de modification à appliquer à la version.
- Valeurs (séparées par | ou autre) :
- token
Un jeton « csrf » récupéré par action=query&meta=tokens
- Ce paramètre est obligatoire.
- baserevid
L’identifiant numérique de la révision sur laquelle baser la modification. Il est utilisé pour détecter les conflits à l’enregistrement.
- Type: entier
- bot
Marquer cette modification comme faite par robot. Cette marque d’URL sera respectée uniquement si l’utilisateur appartient au groupe « Robots ».
- Type : booléen (détails)
- returnto
Titre de la page. Si l’enregistrement de la modification a créé un compte temporaire, l’API peut répondre avec un URL que le client doit visiter pour terminer son enregistrement. Si ce paramètre est fourni, l’URL redirigera vers la page indiquée au lieu de la page qui a été modifiée.
- Type : titre de page
- Accepte les pages inexistantes.
- returntoquery
Paramètres de requête de l’URL (avec ? devant). Si l’enregistrement de la modification a créé un compte temporaire, l’API peut répondre avec un URL que le client doit visiter pour terminer son enregistrement. Si ce paramètre est fourni, l’URL redirigera vers une page avec les paramètres de requête indiqués.
- Par défaut : (vide)
- returntoanchor
Fragment d’URL (avec # devant). Si l’enregistrement de la modification a créé un compte temporaire, l’API peut répondre avec un URL que le client doit visiter pour terminer son enregistrement. Si ce paramètre est fourni, l’URL redirigera vers une page avec le fragment indiqué.
- Par défaut : (vide)
- Créer une nouvelle référence pour la réclamation, avec GUID Q999999998$D4FDE516-F20C-4154-ADCE-7C5B609DFDFF
- api.php?action=wbsetreference&statement=Q999999998$D4FDE516-F20C-4154-ADCE-7C5B609DFDFF&snaks={"P212":[{"snaktype":"value","property":"P212","datavalue":{"type":"string","value":"foo"}}]}&baserevid=7201010&token=foobar [ouvrir dans le bac à sable]
- Initialiser la référence pour la demande ayant pour GUID Q999999998$D4FDE516-F20C-4154-ADCE-7C5B609DFDFF et qui a un hachage de 1eb8793c002b1d9820c833d234a1b54c8e94187e
- api.php?action=wbsetreference&statement=Q999999998$D4FDE516-F20C-4154-ADCE-7C5B609DFDFF&reference=1eb8793c002b1d9820c833d234a1b54c8e94187e&snaks={"P212":[{"snaktype":"value","property":"P212","datavalue":{"type":"string","value":"bar"}}]}&baserevid=7201010&token=foobar [ouvrir dans le bac à sable]
- Crée une nouvelle référence pour la demande avec GUID Q999999998$D4FDE516-F20C-4154-ADCE-7C5B609DFDFF et insère la nouvelle référence en haut de la liste des références au lieu de l'ajouter en bas.
- api.php?action=wbsetreference&statement=Q999999998$D4FDE516-F20C-4154-ADCE-7C5B609DFDFF&snaks={"P212":[{"snaktype":"novalue","property":"P212"}]}&index=0&baserevid=7201010&token=foobar [ouvrir dans le bac à sable]