API:Externí odkazy

Verze MediaWiki:

≥ 1.11

Žádost GET pro získání seznamu všech externích odkazů na poskytovaných stránkách.

Dokumentace API

prop=extlinks (el)

(main | query | extlinks)

• This module requires read rights.
• Source: MediaWiki
• License: GPL-2.0-or-later

Returns all external URLs (not interwikis) from the given pages.

• https://www.mediawiki.org/wiki/Special:MyLanguage/API:Extlinks

Specific parameters:

Other general parameters are available.

ellimit

How many links to return.

Type: integer or max

The value must be between 1 and 500.

Default: 10

elcontinue

When more results are available, use this to continue. More detailed information on how to continue queries can be found on mediawiki.org.

elprotocol

Protocol of the URL. If empty and elquery is set, the protocol is http and https. Leave both this and elquery empty to list all external links.

One of the following values: Can be empty, or bitcoin, ftp, ftps, geo, git, gopher, http, https, irc, ircs, magnet, mailto, matrix, mms, news, nntp, redis, sftp, sip, sips, sms, ssh, svn, tel, telnet, urn, worldwind, xmpp

Default: (empty)

elquery

Search string without protocol. Useful for checking whether a certain page contains a certain external url.

elexpandurl

Deprecated.

Expand protocol-relative URLs with the canonical protocol.

Type: boolean (details)

Example:

Get a list of external links on the page MediaWiki.

api.php?action=query&prop=extlinks&titles=MediaWiki [open in sandbox]

Příklad

Dotazování přes GET

Získejte seznam externích odkazů na stránce.

api.php?action=query&titles=Albert%20Einstein&prop=extlinks&format=json [zkuste v ApiSandbox]

Odpověď

{
    "continue": {
        "elcontinue": "http://ch.unibe.philosci40./lehre/winter99/einstein/Walker_S|267300440",
        "continue": "||"
    },
    "query": {
        "pages": {
            "736": {
                "pageid": 736,
                "ns": 0,
                "title": "Albert Einstein",
                "extlinks": [
                    {
                        "*": "http://sedici.unlp.edu.ar/handle/10915/2785"
                    },
                    {
                        "*": "http://sedici.unlp.edu.ar/handle/10915/2786"
                    },
                    {
                        "*": "http://einstein.biz/"
                    },
                    ...
                ]
            }
        }
    }
}

Ukázkový kód

Python

#!/usr/bin/python3

"""
    get_extlinks.py
    MediaWiki API Demos
    Demo of `Extlinks` module: Get a list of external links on a page
    MIT License
"""

import requests

S = requests.Session()

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

PARAMS = {
    "action": "query",
    "titles": "Albert Einstein",
    "prop": "extlinks",
    "format": "json"
}

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

print(DATA)

PHP

<?php

/*
    get_extlinks.php
    MediaWiki API Demos
    Demo of `Extlinks` module: Get a list of external links on a page
    MIT License
*/

$endPoint = "https://en.wikipedia.org/w/api.php";
$params = [
    "action" => "query",
    "titles" => "Albert Einstein",
    "prop" => "extlinks",
    "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 );

$result = json_decode( $output, true );
var_dump( $result );

JavaScript

/*
    get_extlinks.js
    MediaWiki API Demos
    Demo of `Extlinks` module: Get a list of external links on a page
    MIT License
*/

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

var params = {
    action: "query",
    titles: "Albert Einstein",
    prop: "extlinks",
    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_extlinks.js
	MediaWiki API Demos
	Demo of `Extlinks` module: Get a list of external links on a page
	MIT License
*/

var params = {
		action: 'query',
		titles: 'Albert Einstein',
		prop: 'extlinks',
		format: 'json'
	},
	api = new mw.Api();

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

Historie parametrů

• v1.21: Představeno elexpandurl
• v1.18: Představeno elprotocol, elquery
• v1.13: Představeno ellimit, eloffset

Související odkazy

• API:Iw odkazy - vrátí všechny interwiki odkazy z daných stránek.
• API:Odkazy - vrátí všechny odkazy z daných stránek.