API:Feedcontributions

From mediawiki.org
This page is a translated version of the page API:Feedcontributions and the translation is 100% complete.
Version de MediaWiki :
1.18

Requête GET pour obtenir le flux des contributions d'un utilisateur.

Documentation de l'API


action=feedcontributions

(main | feedcontributions)

Returns a user's contributions feed.

Specific parameters:
Other general parameters are available.
feedformat

The format of the feed.

One of the following values: atom, rss
Default: rss
user

What users to get the contributions for.

This parameter is required.
Type: user, by any of username, IP, Temporary user, IP range, interwiki name (e.g. "prefix>ExampleName") and user ID (e.g. "#12345")
namespace

Which namespace to filter the contributions by.

One of the following values: 0, 1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15, 90, 91, 92, 93, 100, 101, 102, 103, 104, 105, 106, 107, 486, 487, 710, 711, 828, 829, 1198, 1199, 2600, 5500, 5501
year

From year (and earlier).

Type: integer
month

From month (and earlier).

Type: integer
tagfilter

Filter contributions that have these tags.

Values (separate with | or alternative): Added PHP closing tag, Blocked user editing own talk page, Emoji, New user editing project page, OAuth CID: 21, OAuth CID: 31, OAuth CID: 429, OAuth CID: 1188, OAuth CID: 1261, OAuth CID: 1352, OAuth CID: 1805, OAuth CID: 1809, OAuth CID: 1841, OAuth CID: 2071, OAuth CID: 4458, OAuth CID: 4664, OAuth CID: 6365, OTRS permission added by non-OTRS member, Potentially problematic translation, Rapid reverts, T144167, abusefilter-condition-limit, advanced mobile edit, android app edit, blanking, centralnotice, centralnotice translation, convenient-discussions, deletion template removed, disambiguator-link-added, discussiontools, discussiontools-added-comment, discussiontools-edit, discussiontools-newtopic, discussiontools-reply, discussiontools-source, discussiontools-source-enhanced, discussiontools-visual, disneynew, editcheck-newcontent, editcheck-newreference, editcheck-reference-decline-common-knowledge, editcheck-reference-decline-irrelevant, editcheck-reference-decline-other, editcheck-reference-decline-uncertain, editcheck-references, editcheck-references-activated, emoji, fileimporter-remote, ios app edit, massmessage-delivery, meta spam id, mobile app edit, mobile edit, mobile web edit, mw-blank, mw-changed-redirect-target, mw-contentmodelchange, mw-manual-revert, mw-new-redirect, mw-removed-redirect, mw-replace, mw-reverted, mw-rollback, mw-server-side-upload, mw-undo, possible link spam 2, possible vandalism, repeated xwiki CoI abuse, repeating characters, translate-translation-pages, visualeditor, visualeditor-needcheck, visualeditor-switched, visualeditor-wikitext, wikieditor, wikilove
Maximum number of values is 50 (500 for clients that are allowed higher limits).
Default: (empty)
deletedonly

Show only deleted contributions.

Type: boolean (details)
toponly

Only show edits that are the latest revisions.

Type: boolean (details)
newonly

Only show edits that are page creations.

Type: boolean (details)
hideminor

Hide minor edits.

Type: boolean (details)
showsizediff

Disabled due to miser mode.

Type: boolean (details)
Example:
Return contributions for user Example.
api.php?action=feedcontributions&user=Example [open in sandbox]

Exemple

Requête GET

Affiche les contributions d'un utilisateur sous forme de flux RSS.


Réponse

<rss xmlns:dc="http://purl.org/dc/elements/1.1/" version="2.0">
  <channel>
    <title>Wikipedia - User contributions [en]</title>
    <link>
      https://en.wikipedia.org/wiki/Special:Contributions/Jimbo_Wales
    </link>
    <description>User contributions</description>
    <language>en</language>
    <generator>MediaWiki 1.27.0-wmf.5</generator>
    <lastBuildDate>Wed, 11 Nov 2015 20:56:27 GMT</lastBuildDate>
    <item>
      <title>User talk:Jimbo Wales</title>
      <link>
        https://en.wikipedia.org/w/index.php?title=User_talk:Jimbo_Wales&diff=###
      </link>
      <guid isPermaLink="false">
        https://en.wikipedia.org/w/index.php?title=User_talk:Jimbo_Wales&diff=###
      </guid>
      <description>
        ...
      </description>
      <comments>
        https://en.wikipedia.org/wiki/User_talk:Jimbo_Wales
      </comments>
    </item>
  </channel>
</rss>

Exemple de code

Python

#!/usr/bin/python3

"""
    get_user_contributions_feed.py

    MediaWiki API Demos
    Demo of `Feedcontributions` module: Show contributions of a user as an RSS feed.

    MIT License
"""

import requests

S = requests.Session()

URL = "https://en.wikipedia.org/w/api.php"

PARAMS = {
    "action": "feedcontributions",
    "user": "Jimbo Wales",
    "format": "json"
}

R = S.get(url=URL, params=PARAMS)
DATA = R.content

print(DATA)

PHP

<?php
/*
    get_user_contributions_feed.php

    MediaWiki API Demos
    Demo of `Feedcontributions` module: Show contributions of a user as an RSS feed.

    MIT License
*/

$endPoint = "https://en.wikipedia.org/w/api.php";
$params = [
    "action" => "feedcontributions",
    "user" => "Jimbo Wales",
    "format" => "json"
];

$url = $endPoint . "?" . http_build_query( $params );

$ch = curl_init( $url );
curl_setopt( $ch, CURLOPT_RETURNTRANSFER, true );
$output = curl_exec( $ch );
curl_close( $ch );

var_dump( $output );

JavaScript

/*
    get_user_contributions_feed.js

    MediaWiki API Demos
    Demo of `Feedcontributions` module: Show contributions of a user as an RSS feed.

    MIT License
*/

var url = "https://en.wikipedia.org/w/api.php"; 

var params = {
    action: "feedcontributions",
    user: "Jimbo Wales",
    format: "json"
};

url = url + "?origin=*";
Object.keys(params).forEach(function(key){url += "&" + key + "=" + params[key];});

fetch(url)
    .then(function(response){return response.json();})
    .then(function(response) {console.log(response);})
    .catch(function(error){console.log(error);});

MediaWiki JS

/*
	get_user_contributions_feed.js

	MediaWiki API Demos
	Demo of `Feedcontributions` module: Show contributions of a user as an RSS feed.

	MIT License
*/

var params = {
		action: 'feedcontributions',
		user: 'Jimbo Wales',
		format: 'json'
	},
	api = new mw.Api();

api.get( params ).done( function ( data ) {
	console.log( data );
} );

Erreurs possibles

En plus des messages d'erreur standards :

Code Info
feed-unavailable Les flux de syndication ne sont pas disponibles
feed-invalid Type de flux d’abonnement non valide.
sizediffdisabled La différence de taille est désactivée dans le mode économe.

Historique des paramètres

  • v1.28: Ajouté hideminor
  • v1.23: Ajouté newonly

Notes supplémentaires

  • Notez-bien que, si la requête est acceptée, la sortie sera dans le format demandé par le paramètre feedformat. Le format demandé par le paramètre standard format (c'est à dire JSON) ne sera utilisé que s'il s'agit d'un événement représentant une erreur.

Voir aussi