API:REST API/de

Die MediaWiki Core REST API lässt dich mit MediaWiki interagieren, indem HTTP-Abfragen an einzigartige URLs gesendet werden. Du kannst die API nutzen, um Apps und Skripte zu erstellen, die nach Wiki-Seiten suchen und diese anzeigen, Mediendateien erhalten und die Versionsgeschichte untersuchen.

Schnellstart
$ curl

Datenformat
REST-API-Endpunkte geben Daten in den Formaten JSON oder HTML aus. Siehe die API-Referenz für den Inhaltstyp, der von jedem Endpunkt unterstützt wird.

Methoden
Die API unterstützt Standard-HTTP-Anfragemethoden.

URL-Struktur
API-Endpunkte teilen sich eine konsistente URL-Struktur, die die Basis-URL des Wikis, den Skript-Pfad des Wikis und die API-Version enthält.

Versionierung
Die MediaWiki REST API wurde entwickelt, um langfristig stabil für Entwickler zu sein und nutzt daher eine globale Versionsnummer im API-Pfad zur Versionierung (zum Beispiel: ). Da die Prinzipien der semantischen Versionierung befolgt werden, ist die Version inkrementiert, wenn ein Endpunkt so geändert wird, dass er nicht abwärtskompatibel ist, beispielsweise bei Entfernung einer Antworteigenschaft oder Hinzufügung von Pflichtparametern. In einer Hauptversion kann die API so geändert werden, dass sie abwärtskompatibel ist, beispielsweise bei Hinzufügung einer Antworteigenschaft oder eines optionalen Abfrageparameters.

Berechtigungen und Autorisierung
Die REST API wurde so entwickelt, dass sie zusammen mit der Erweiterung zur Benutzer-Authentifizierung und -Autorisierung genutzt werden kann. Unabhängig von der Authentifizierungsmethode reagiert die API auf die Anmeldung eines Benutzers und gibt für die Berechtigungen des Benutzers angemessene Inhalte aus.

Über die REST API auf Wikimedia-Projekte zugreifen
Du kannst die REST API nutzen, um auf Wikipedia, Wiktionary und andere Wikimedia-Projekte in unterschiedlichen Sprachen zuzugreifen. Für eine vollständige Liste der Wikimedia-Projekt-URLs siehe die Liste der Wikis.

Abfragelimit
Es gibt kein festes Limit für Abfragen an die API, dein Client kann jedoch gesperrt werden, wenn du die Stabilität einer Seite gefährdest. Um mit einer sicheren Abfragerate zu beginnen, warte bis eine Abfrage beendet ist, ehe du eine weitere Abfrage sendest.

Client-Identifikation
Wikimedia-Seiten verlangen für alle API-Abfragen einen HTTP-User-Agent-Header. Dies hilft dabei, deine App zu identifizieren und stellt sicher, dass System-Administratoren dich kontaktieren können, falls ein Problem auftritt. IP-Adressen von Clients, die Abfragen ohne User-Agent-Header stellen, können ohne Vorwarnung gesperrt werden

Der User-Agent-Header kann eine Benutzerseite im lokalen Wiki, eine Benutzerseite in einem verwandten Wiki durch Nutzung der Interwiki-Verlinkungs-Syntax, eine URL für eine relevante externe Webseite oder eine Email-Adresse enthalten.

Abhängig von deinem Browser kannst du möglicherweise nicht den User-Agent-Header beeinflussen, wenn du die API über ein browserbasiertes JavaScript ansteuerst. Nutze den -Header, um dies zu umgehen. Siehe die User-Agent-Richtlinie im Meta-Wiki für weitere Informationen.

Authentifizierung
Um deine App zu autorisieren, im Namen eines Benutzer zu handeln, folge der OAuth-Entwickler-Richtlinie, um deine App zu registrieren und Abfragen über OAuth-Tokens zu stellen.

Lizenzierung und Warenzeichen
Wikimedia-Inhalte sind frei und können im Rahmen der Bedingungen der jeweiligen Lizenz weiterverwendet werden. Licenses can differ between projects, so see the individual project for information about licenses and content reuse. For example, English Wikipedia’s text can be used under the terms of the Creative Commons Attribution Share-Alike license, while media files on Wikimedia Commons are licensed individually as indicated on the file’s information page. For more information about licensing and trademark use, see Meta-Wiki’s developer app guidelines.

Einschränkungen in Wikidata
While the REST API is available on Wikimedia projects, it is not fully supported by Wikidata. As of writing, some of the endpoints may return unexpected errors.

Endpunkte von Erweiterungen
MediaWiki extensions can surface extension-specific API endpoints using the REST API interface. See the REST API extension interface docs to get started. For documentation for REST API endpoints provided by extensions, see the extension docs. The REST API extension interface is available in via  and in  and later by default.

Über diese Dokumentation
These docs are written manually based on the. Corrections and additions are welcome! To share a tutorial or app that uses the MediaWiki REST API, add a link to the REST API template.