| |
| datenhub:import [07.03.2024 16:42] – angelegt - Externe Bearbeitung 127.0.0.1 | datenhub:import [24.10.2024 13:40] (aktuell) – admin |
|---|
| ====== API für Datenbezüger ====== | ====== API für Datenbezüger ====== |
| |
| Die Azizi-Plattform liefert die Basis zum Austausch von Event-Daten im Minasa-Schema. Interessierte Bezüger können über eine API die gewünschten Daten abrufen. | Der Minasa-Datenhub liefert die Basis zum Austausch von Event-Daten im Minasa-Schema. Interessierte Bezüger können über eine API die gewünschten Daten abrufen. |
| |
| ===== Abfragen ===== | ===== Abfragen ===== |
| |
| ^System^URL^Methode| | ^System^URL^Methode| |
| |Azizi LIVE|[[https://azizi.2mp.ch/export/events/v/1|https://azizi.2mp.ch/export/events/v/1]]|GET| | |Minasa Datenhub LIVE|[[https://azizi.2mp.ch/export/events/v/1|https://azizi.2mp.ch/export/events/v/1]]|GET| |
| |Testsystem|[[https://azizi.nilkream.ch/export/events/v/1|https://azizi.nilkream.ch/export/events/v/1]]|GET| | |Testsystem|[[https://azizi.nilkream.ch/export/events/v/1|https://azizi.nilkream.ch/export/events/v/1]]|GET| |
| |
| ===== Filter ===== | ===== Filter ===== |
| |
| Azizi stellt verschiedene Filter zur Verfügung, die als HTTP-Query-Parameter übergeben werden: | Der Datenhub stellt verschiedene Filter zur Verfügung, die als HTTP-Query-Parameter übergeben werden: |
| |
| ^Parameter^Beschreibung^Beispiele^Erläuterungen| | ^Parameter^Beschreibung^Beispiele^Erläuterungen| |
| |''category'' |Veranstaltungs-Kategorie, Rubrik|''category=Literatur,Kunst'' |gültige Kategorie gemäss [[:azizi:schema|Azizi-Schema]]| | |''category'' |Veranstaltungs-Kategorie, Rubrik|''category=Literatur,Kunst'' |gültige Kategorie gemäss [[:datenhub:schema|Minasa-Schema]]| |
| |''zip'' |PLZ des Veranstaltungsorts|''zip=9000,9001,9004,9006,9007,9008,9009,9010,9011,9012,9013,9014,9015,9016'' |Bsp. für gesamte Stadt St. Gallen| | |''zip'' |PLZ des Veranstaltungsorts|''zip=9000,9001,9004,9006,9007,9008,9009,9010,9011,9012,9013,9014,9015,9016'' |Bsp. für gesamte Stadt St. Gallen| |
| |''canton'' |Kanton des Veranstaltungsorts|''canton=AI,AR'' |Bsp. für beide Appenzell| | |''canton'' |Kanton des Veranstaltungsorts|''canton=AI,AR'' |Bsp. für beide Appenzell| |
| |''dataProviderIncluded'' |nur diese Azizi-Datenlieferanten|''dataProviderIncluded=0187dc91-efa5-7e6f-a417-5a9bb49bb64e'' |GUIDs von Datenlieferanten werden von Azizi fix vergeben| | |''dataProviderIncluded'' |nur diese Datenlieferanten|''dataProviderIncluded=0187dc91-efa5-7e6f-a417-5a9bb49bb64e'' |GUIDs von Datenlieferanten werden vom Datenhub fix vergeben| |
| |''dataProviderExcluded'' |ausser diese Azizi-Datenlieferanten|''dataProviderExcluded=0187dc91-efa5-7e6f-a417-5a9bb49bb64e'' |GUIDs von Datenlieferanten werden von Azizi fix vergeben| | |''dataProviderExcluded'' |ausser diese Datenlieferanten|''dataProviderExcluded=0187dc91-efa5-7e6f-a417-5a9bb49bb64e'' |GUIDs von Datenlieferanten werden vom Datenhub fix vergeben| |
| |
| Werden mit der Anfrage keine Filter mitgeschickt, liefert Azizi alle aktuellen, verfügbaren Event-Daten aus. | Werden mit der Anfrage keine Filter mitgeschickt, liefert der Datenhub alle aktuellen, verfügbaren Event-Daten aus. |
| |
| Verschiedene Filter können in derselben Abfrage kombiniert werden. | Verschiedene Filter können in derselben Abfrage kombiniert werden. |
| ===== Einschränkungen ===== | ===== Einschränkungen ===== |
| |
| Azizi importiert in der Regel einmal pro Tag Event-Daten aus direkt-angebundenen externen Datenbanken (i.d.R. Websites von Veranstaltern) und aus den verbundenen Minasa-Systemen. | Der Datenhub importiert in der Regel einmal pro Tag Event-Daten aus direkt-angebundenen externen Datenbanken (i.d.R. Websites von Veranstaltern) und aus den verbundenen Minasa-Systemen. |
| |
| Die Event-Daten sind **einmal täglich** abzurufen und für die Weiterverabeitung auf einem Server beim Datenbezüger zu speichern. Downloads werden überwacht und blockiert, falls pro Zeiteinheit mehr als eine definierte Anzahl von Zugriffen mit demselben API-Key erfolgt. | Die Event-Daten sind **einmal täglich** abzurufen und für die Weiterverabeitung auf einem Server beim Datenbezüger zu speichern. Downloads werden überwacht und blockiert, falls pro Zeiteinheit mehr als eine definierte Anzahl von Zugriffen mit demselben API-Key erfolgt. |
| |
| |