Jump to content

API:贡献订阅

From mediawiki.org
This page is a translated version of the page API:Feedcontributions and the translation is 19% complete.
MediaWiki版本:
1.18

GET request to return a user's contributions feed.

API documentation

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): ASCII text added, AWB, 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, app-ai-assist, app-description-add, app-description-change, app-description-translate, app-full-source, app-image-add-infobox, app-image-add-top, app-image-caption-add, app-image-caption-translate, app-image-tag-add, app-rollback, app-section-source, app-select-source, app-suggestededit, app-talk-reply, app-talk-source, app-talk-topic, app-undo, 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, 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, nuke, possible link spam 2, 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]


示例

GET request

Show contributions of a user as an RSS feed.

Response

<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>

Sample 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 );
} );

Possible errors

In addition to the standard error messages:

代码 信息
feed-unavailable 联合供稿不可用
feed-invalid 无效的订阅源类型。
sizediffdisabled 大小差异在Miser模式中被禁用。

Parameter history

  • v1.28: Introduced hideminor
  • v1.23: Introduced newonly

Additional notes

  • Note that if the request is successful, the output will be in the format requested by the feedformat parameter. The format requested by the standard format parameter (e.g., JSON) will only be used in the event of an error.

See also