Wikimedia REST API

Die Wikimedia REST API ermöglicht den Zugriff auf Wikimedia-Inhalte und -Metadaten über maschinenlesbare Formate. Das Projekt richtet seinen Fokus auf Anwendungsfälle mit großen Datenvolumen und integriert sich in die weltweit verteilte Caching-Infrastruktur von Wikimedia. Im Ergebnis profitieren API-Benutzer von reduzierten Latenzen und der Unterstützung hoher Anfragevolumen.

Die REST-API mitsamt ihrer Dokumentation ist hier verfügbar für alle großen Wikimedia-Projekte: /api/rest_v1/. In der englischen Wikipedia lautet die URL beispielsweise https://en.wikipedia.org/api/rest_v1/ .

Während die von den meisten Projekten angebotene Funktionalität weitgehend mit der der englischen Wikipedia übereinstimmt, gibt es einige nennenswerte Ausnahmen:

• wikimedia.org bietet projektübergreifende Informationen wie Seitenabrufstatistiken.
• en.wiktionary.org bietet einen experimentellen Definitions-Endpunkt und zeigt Wiktionary-Informationen als strukturierte Daten. Die Unterstützung für andere Sprachen wird diskutiert.

Versionierung

Die REST-API folgt dieser API-Versions-Richtlinie.

Nutzungsbedingungen

• Durch die Nutzung der REST-API stimmst du den allgemeinen Nutzungsbedingungen und der Datenschutzrichtlinie von Wikimedia zu.
• Begrenze deine Klienten auf insgesamt maximal 200 Abfragen/Sekunde an diese API, um andere API-Nutzer nicht zu beeinträchtigen. Viele Eingangspunkte besitzen restriktivere Beschränkungen und setzen diese durch.
• Wir bitten dich, einen einzigartigen User-Agent- oder Api-User-Agent-Header zu setzen, der es uns ermöglicht, dich schnell zu kontaktieren. Email-Adressen oder URLs auf Kontaktseiten funktionieren gut.

Andere APIs

Für die REST API in MediaWiki 1.35 und neuer, siehe die MediaWiki Core REST API.

API	Erreichbarkeit	URL base	Beispiel
MediaWiki Action API	Enthalten mit MediaWiki Aktiviert auf Wikimedia-Projekte	/api.php	https://de.wikipedia.org/w/api.php?action=query&prop=info&titles=Erde
MediaWiki REST API	Enthalten mit MediaWiki 1.35 Aktiviert auf Wikimedia-Projekte	/rest.php	https://de.wikipedia.org/w/rest.php/v1/page/Erde
Wikimedia REST API	Nicht enthalten mit MediaWiki Nur für Wikimedia-Projekte verfügbar	/api/rest	https://de.wikipedia.org/api/rest_v1/page/title/Erde
For commercial-scale APIs for Wikimedia projects, see Wikimedia Enterprise

Siehe auch

• RESTBase, die Technologie hinter der REST-API
• Blog-Beitrag, der die Veröffentlichung 1.0 ankündigt. Beschreibt unterschiedliche wichtige Anwendungsfälle, diskutiert, wie die REST-API in die größere technische Strategie von Wikimedia passt und bietet Hinweise auf einige Details zur Implementierung.
• Die API wird mit Node.js implementiert. Dieser Blog-Beitrag beschreibt unsere Erfahrung beim Upgrade der REST-API und anderer Dienste auf Node 6.
• Wikimedia-Services-Team, Eigentümer der REST-API.
• Core Platform Team/Initiatives/API Gateway (2020)