Nutzen
In der Regel speichert sync.blue® eigenständig keine Kontakte und synchronisiert diese stattdessen live zwischen zwei Accounts, wie z.B. einem Microsoft 365 Account (Groupware) und einem Placetel Account (Telefonanlage).
In manchen Szenarien ist es aber erforderlich, dass sync.blue® bewusst als Online-Kontaktspeicher dient und die Kontakte in verschiedensten Formaten auf Abruf zum Download bereitstellt:
- Telefonbuch für IP-Telefone: Kontakte aus einer bestimmten Adressbuch-Quelle wie z.B. Microsoft 365 sollen für ein IP-Telefon (z.B: snom oder Yealink) als Telefonbuch bereitgestellt werden.
- Zusammenführung mehrerer Accounts: Kontakte aus verschiedenen Accounts wie z.B. Microsoft 365, Apple iCloud und Google Contacts sollen zusammengeführt und für eine eigene Unternehmensanwendung ohne Duplikate bereitgestellt werden.
- Push statt Pull: Kontakte können aus einer internen Unternehmens-Anwendung nicht von sync.blue® abgerufen werden und sollen vom internen Netzwerk aus in das sync.blue® Directory gepusht werden.
Technik
Wie kommen Kontakte in das sync.blue® Directory?
sync.blue® Directory als Verbindungs-Ziel
Wähle das sync.blue® Directory als Ziel in einer klassischen sync.blue® Verbindung (z.B. Quelle "Microsoft 365" und Ziel "sync.blue® Directory").
Es können mehrere Verbindungen angelegt werden mit demselben sync.blue® Directory Account als Ziel.
sync.blue® Directory als Push-Ziel
1. Erstelle eine lokale CSV-Datei nach dieser Anleitung.
2. Pushe diese CSV-Datei namens contacts.csv in das sync.blue® Directory z.B. per cURL:
Beispiel für (getestet mit cURL Version 7.77.0 auf macOS):
curl -F 'file=@contacts.csv' https://directory.sync.blue/contacts/YOUR_API_KEY
Beispiel für (getestet mit cURL Version 7.84.0 auf Windows):
curl --insecure -F file=@contacts.csv https://directory.sync.blue/contacts/YOUR_API_KEY
Technische Anforderungen:
- Request: POST
- Formular-Typ: multipart/form-data
- Parametername der CSV-Datei: file
Der API-Key kann dabei selbst ausgedacht werden (genau 14 Zeichen, Zeichen 0-9 und A-Z) und muss eindeutig sein.
Wie stellt das sync.blue® Directory Kontakte bereit?
Je nach URL-Endung gibt das sync.blue® Directory Kontakte in dem gewünschten Format aus:
- Als CSV-Datei (Beispiel: https://directory.sync.blue/contacts/DEMOabcABC0123)
- Als XML-Datei für Yealink IP-Telefone (Beispiel: https://directory.sync.blue/contacts/DEMOabcABC0123/yealink/v1)
- Als XML-Datei für snom IP-Telefone (Beispiel: https://directory.sync.blue/contacts/DEMOabcABC0123/snom/v1)
- Als XML-Datei für Gigaset IP-Telefone/DECT-Basen (Beispiel: http://directory.sync.blue/contacts/DEMOabcABC0123/gigaset/v1)
- Als CardDAV URL (in Entwicklung)
Sicherheit und Datenschutz
- Bereitstellung der Kontakte nur per HTTPS (SSL-verschlüsselt)
- Kontakte nur, wenn persönlicher API-Key bekannt
Mehr dazu auch hier.
Grenzen
- Das sync.blue® ist ein technischer Online-Kontaktspeicher ohne Nutzeroberfläche zum Anlegen, Bearbeiten und Löschen von Kontakten.
- Nur die wichtigsten Felder werden synchronsiert.
Kommentare
0 Kommentare
Bitte melden Sie sich an, um einen Kommentar zu hinterlassen.