In Sheltra kannst du keine eigenen API-Schlüssel erstellen oder verwalten. Es gibt auch keine dafür vorgesehenen technischen Benutzerkonten.
Ein API-Schlüssel ist eine geheime Zugangskennung, mit der sich ein Programm bei einem Dienst ausweisen kann. Fragt jemand nach einem solchen Schlüssel, ist deshalb zuerst wichtig: Geht es um eure öffentliche Tierliste, einen anderen Anbieter oder einen persönlichen Kalender-Link?
„Unsere Website braucht Zugang zur Tierliste“
Für die öffentliche Tierliste ist kein Schlüssel und kein Passwort erforderlich. Sie ist dafür vorgesehen, freigegebene Tierdaten ohne Anmeldung abzurufen.
Die passenden Adressen stehen unter Einstellungen → Öffentliche API. Eine Person mit Administrationsrechten kann sie an eure Website-Betreuung weitergeben.
Prüft vorher unter Sichtbare Felder, welche Angaben öffentlich werden dürfen, und am einzelnen Tier das Feld Veröffentlicht. Weitere Veröffentlichungsregeln verhindern etwa, dass deaktivierte oder verstorbene Tiere ausgegeben werden. Mehr dazu: Gibt es eine API?.
Gib für diesen Zweck nicht dein persönliches Sheltra-Passwort weiter.
„Ein Feld in Sheltra fragt trotzdem nach einem API-Schlüssel“
Dann geht es um den Zugang zu einem anderen Dienst, zum Beispiel eurem eigenen KI-Anbieter oder Webling beim Import von Buchhaltungsdaten.
Den Schlüssel erstellst du im Konto bei diesem Anbieter und trägst ihn anschließend in der passenden Sheltra-Verbindung ein. Er ist nicht mit deinem normalen Anmeldepasswort gleichzusetzen.
Bei der KI-Verbindung steht am Feld Verschlüsselt gespeichert. Wird nach dem Speichern nie wieder angezeigt. Auch ein gespeicherter Webling-Schlüssel wird nicht wieder offengelegt. Bewahre benötigte Zugangsdaten deshalb nach euren internen Sicherheitsregeln auf, nicht in einer frei zugänglichen Notiz oder E-Mail.
Soll ein solcher Schlüssel ungültig werden, musst du ihn beim ausstellenden Anbieter sperren oder ersetzen. Aktualisiere eine weiterhin benötigte Verbindung anschließend mit dem neuen Schlüssel. Die Einrichtung einer KI-Verbindung erklärt Wie verbinde ich die Anwendung mit meinem eigenen KI-Assistenten?.
„Ein anderes Programm soll interne Daten lesen oder ändern“
Sheltra bietet dafür keine allgemeine externe API mit selbst anlegbaren Zugriffsschlüsseln. Die öffentliche Tier-Schnittstelle erlaubt nur das Lesen freigegebener Tierdaten.
Das ist von den bereits eingebauten Verbindungen zu bestimmten Diensten zu unterscheiden. Welche vorhanden sind, steht unter Welche Integrationen werden unterstützt?.
Lege kein gemeinsam genutztes persönliches Konto als Ersatz für eine technische Schnittstelle an. Es wäre dann schwerer nachzuvollziehen, wer auf Daten zugegriffen oder etwas geändert hat.
„Ich habe einen Kalender-Link, den ich geheim halten soll“
Der Link zum Kalender-Abo ist etwas anderes als die öffentliche Tierliste. Er gehört zu deinem Kalender. Wer ihn kennt, kann die darüber bereitgestellten Termine sehen.
Du findest ihn im Kalender unter Abonnieren. Füge ihn in deiner Kalender-App als Abo hinzu, nicht nur als einmaligen Import. Andere Personen sollten ihren eigenen Link verwenden.
Der Link hat kein festes Ablaufdatum. Wurde er versehentlich weitergegeben, nutze Link neu erzeugen. Die bisherige Adresse funktioniert danach sofort nicht mehr. Ersetze sie anschließend in jeder Kalender-App, die den alten Link verwendet. Sonst kann der Kalender dort leer bleiben.
Ein solcher privater Kalender-Link gehört nicht in öffentliche Beiträge oder ungeschützte Support-Screenshots.
„Eine externe Person soll regelmäßig mitarbeiten“
Dann ist ein eigenes persönliches Konto mit passenden Rechten der richtige Weg. Lade die Person ein und begrenze den Zugriff auf ihre Aufgaben.
Die Schritte stehen unter Wie lade ich weitere Personen ein?. Ein persönlicher Zugang ist für menschliche Mitarbeit gedacht, nicht als zugesagte allgemeine Programmierschnittstelle.
„Wir brauchen Daten nur einmal für eine Auswertung“
Nutze dafür den Datenexport. Du brauchst keinen API-Schlüssel und keine dauerhafte Verbindung. Beachte, dass eine heruntergeladene Datei unabhängig von den späteren Berechtigungen in Sheltra weitergegeben werden kann.
Mehr dazu: Wie exportiere oder lade ich meine Daten herunter?.
Fehlt euch eine bestimmte Anbindung, beschreibe unter hallo@sheltra.cloud, welche Daten in welche Richtung übertragen werden sollen. Schicke dabei keine geheimen Schlüssel mit.
