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