Technische Schnittstellen von Crossiety
Auf Wunsch zahlreicher Partnergemeinden hat Crossiety sein Angebot an technischen Schnittstellen erweitert. Unser Ziel ist es, kosteneffiziente, unkomplizierte und schnell umsetzbare Lösungen zu bieten, die auf die individuellen Bedürfnisse unserer Kunden abgestimmt sind.
Aktuell stehen folgende Schnittstellen mit ihren jeweiligen Funktionen zur Verfügung:
Unser Angebot
- Auf Anfrage erstellen wir Ihnen gerne ein Angebot für die einmalige Initialisierungsgebühr und die jährlichen Supportkosten.
- Bei Interesse erhalten Sie von uns die entsprechenden Dokumentationen und Zugangsdaten, die Sie an Ihren Webseitenbetreiber weiterleiten können.
- Gemeinden und Städte können Crossiety nur über die bereitgestellten Schnittstellen (iFrame, RSS, API) anbinden.
- Externe Schnittstellen werden nicht unterstützt, um die Einführung und Betriebskosten der Crossiety-Plattform niedrig zu halten.
- Das Projektmanagement für die Implementierung übernimmt die jeweilige Gemeinde oder Stadt selbst.
Mehr Informationen zu den drei Schnittstellen-Typen
iFrame-Einbindung
Informationen zur iFrame-Einbindung
Das iFrame, auch als „Embedded View“ bezeichnet, ist die einfachste Schnittstellentechnologie von Crossiety. Mit dieser Methode können Beiträge von Crossiety auf einer Webseite eingebettet werden, einschliesslich Veranstaltungen und Neuigkeiten. Die Inhalte können aus dem öffentlichen Dorfplatz-/Event-Bereich oder aus bestimmten Gruppen exportiert werden. Eine Anpassung der Darstellung auf der Webseite ist nicht möglich, die Beiträge werden optisch identisch wie auf Crossiety angezeigt.
- Minimaler Implementierungsaufwand
- Schnelle, kostengünstige und einfache Einbettung auf der Webseite
- Echtzeit-Anzeige von Likes und Kommentaren
- Beiträge im Crossiety-Design
- Export von Events und Neuigkeiten möglich
- Einseitige Datenübertragung von Crossiety zur Webseite
Implementierung der iFrame-Einbindung
Export der öffentlichen Beiträge einer Crossiety-Gruppe
Hinweis: Der Export von Beiträgen kann nur von Gruppenmitgliedern mit der Rolle Besitzer oder Administrator durchgeführt werden. Alle öffentlichen Beiträge der Gruppe werden auf die externe Webseite übertragen.
1. In der Gruppe «Einstellungen» klicken.
2. Zum Punkt «Einbetten» navigieren.
3. Wählen, ob alle öffentlichen Beiträge, nur Neuigkeiten oder nur die Events exportiert werden sollen.
4. Code kopieren.
5. Code auf der Webseite einbinden.
Export der öffentlichen Beiträge eines Dorfplatzes
Hinweis: Der Exportcode für öffentliche Beiträge kann nur von Gemeindeverwaltungen bei Crossiety angefragt werden.
1. Kontaktieren Sie Crossiety per E-Mail an hallo@crossiety.ch und geben Sie an, ob Sie den Code für alle Beiträge, nur Neuigkeiten oder nur Events benötigen.
2. Nach Erhalt des Codes binden Sie diesen auf Ihrer Webseite ein.
Beispiele von implementierten iFrames bei Crossiety-Partnergemeinden
RSS-Schnittstelle
Informationen zur RSS-Schnittstelle
Die RSS-Technologie kann von jedem Webseitenbetreiber einfach eingerichtet werden. Da Crossiety mehr Beitragsmöglichkeiten (Diskussionen, Umfragen, etc.) als typische CMS-Systeme bietet, ist der Export von Crossiety-Inhalten auf die Webseite besonders sinnvoll. Ebenso ist ein RSS-Import von Neuigkeiten auf Crossiety möglich. Importierte Neuigkeiten werden im Namen der entsprechenden Gruppe entweder auf dem Dorfplatz oder im Gruppenforum veröffentlicht. Änderungen an Beiträgen nach dem Import werden nicht automatisch synchronisiert. Diese Schnittstellen wurden bereits erfolgreich in verschiedenen Gemeinden und Städten implementiert.
-
Minimaler Implementierungsaufwand
-
Einfache und kostengünstige Einbettung auf der Webseite
-
Beidseitiger Datentransfer (Export/Import)
-
Export/Import von Neuigkeiten (Achtung: Events können nur exportiert werden)
-
Beiträge werden beim Datentransfer kopiert und nicht automatisch aktualisiert
-
Nachträgliche Anpassungen müssen separat auf der Webseite/Plattform vorgenommen werden
Implementierung der RSS-Schnittstelle
Import eines RSS-Feeds in eine Crossiety-Gruppe
Hinweis: Nur Gruppenmitglieder mit der Rolle Besitzer oder Administrator können einen RSS-Feed importieren. Die RSS-Funktion muss durch Crossiety freigeschaltet sein.durchgeführt werden. Bei Interesse kontaktieren Sie uns unter hallo@crossiety.ch.
Beim Import wählen Sie, ob die Beiträge im Gruppenforum oder im Namen der Gruppe auf dem Dorfplatz veröffentlicht werden sollen. Beachten Sie, dass keine Push-Benachrichtigungen für importierte Beiträge versendet werden. Die Implementierung kann auf Seite des Webseitenbetreibers Kosten verursachen. Erkunden Sie sich im Vorfeld bei Ihrem Webseitenbetreiber.
1. Kontaktieren Sie Crossiety und teilen Sie mit, für welche Gruppe die RSS-Funktion freigeschaltet werden soll.
2. Nach der Freischaltung klicken Sie in der Gruppe unter «Einstellungen» auf «RSS».
3. Klicken Sie auf grünen «+»-Button. Geben Sie dem Feed einen Namen, fügen Sie die URL ein (von Ihrem Webseitenbetreiber) und wählen Sie die Aktualisierungsfrequenz sowie den Veröffentlichungsort (Öffentlich oder Forum). Klicken Sie auf «Erstellen».
4. Klicken Sie auf «RSS-Feeds aktualisieren», um die erste Aktualisierung des Feeds durchzuführen.
Export des RSS-Feeds einer Crossiety-Gruppe
1. In der Gruppe im Menü auf «Gruppenbeiträge» klicken.
2. Auf das «Schallwellen»-Icon rechts neben dem Suchfeld klicken.
3. RSS-Feed (URL) kopieren.
4. URL auf der Webseite einfügen und abspeichern.
Beispiele von implementierten RSS-Feeds
API-Schnittstelle
Informationen zur API-Schnittstelle
Für erweiterte Gestaltungsmöglichkeiten bietet sich die API-Schnittstelle (Application Programming Interface) an. Sie können entscheiden, ob Daten von Crossiety auf Ihre Webseite exportiert oder Neuigkeiten von Ihrer Webseite auf Crossiety importiert werden sollen. Eine Live-Synchronisation der Daten ist ebenfalls möglich, sodass Anpassungen auf einer Seite automatisch auf der anderen Seite übernommen werden.
-
Automatische Anpassungen auf der Webseite oder Crossiety
-
Beidseitiger Datentransfer (Export/Import)
-
Flexibel anpassbares Design der exportierten Daten
-
Aufwendigere Implementierung
-
Zusatzkosten möglich, je nach Anbieter, für die Programmierung des API-Gegenstücks
Implementierung der API-Schnittstelle
Mit unserer API-Dokumentation (auf Anfrage erhältlich) kann Ihr Webseitenanbieter das API-Gegenstück für den Import/Export programmieren. Die Dokumentation enthält alle notwendigen Informationen für die Implementierung der Crossiety-Schnittstelle und ermöglicht eine flexible Anpassung der Daten an das Design Ihrer Webseite. Beachten Sie, dass bei importierten Beiträgen keine Push-Benachrichtigungen versendet werden.
1. Kontaktieren Sie Crossiety unter hallo@crossiety.ch und geben Sie an, bei welcher Person in Ihrer Gemeinde-/Stadtverwaltung die API-Funktion freigeschaltet werden soll.
2. Nach der Freischaltung kann die zuständige Person «Profil» -> «API-Schlüssel» mit einem Klick auf den grünen «+»-Button einen API-Schlüssel generieren.
3. Der API-Schlüssel, die API-Dokumentation und die Township-ID (beides auf Anfrage erhältlich) können an den Webseitenbetreiber weitergeleitet werden. Teilen Sie dem Betreiber Ihre genauen Wünsche zum Import oder Export der Beiträge mit.
Beispiele von implementierten API-Schnittstellen bei Crossiety-Partnergemeinden
Interesse an einer Schnittstelle?
Haben Sie Fragen zu unseren verschiedenen Schnittstellen? Gerne beraten wir Sie in einem persönlichen Gespräch. Wir freuen uns auf Ihre Kontaktaufnahme per E-Mail an hallo@crossiety.ch.