Ein API-Key ist eine Anmeldeinformation auf Ihrem ImageToTable.ai-Konto. Er ermöglicht einem externen Tool, als Ihr Konto zu handeln: Das Google-Sheets-Add-on kann sich damit verbinden, ohne sich anzumelden, und die v1-API verwendet ihn bei jedem Aufruf. Diese Seite erklärt, wo der Schlüssel zu finden ist, wie Sie ihn ersetzen und was Sie danach aktualisieren müssen.
Wo Sie Ihren API-Key finden
Der Schlüssel befindet sich auf Ihrer Profil-Seite, in einem Abschnitt mit dem Titel API-Key. Um dorthin zu gelangen, öffnen Sie das Kontomenü in der oberen rechten Ecke der App – das mit Ihrem Avatar und Benutzernamen – und wählen Sie Profil.
Dieser Abschnitt zeigt alles, was der Schlüssel benötigt:
- Den Schlüssel selbst, standardmäßig hinter Punkten verborgen. Verwenden Sie die Augen-Schaltfläche, um ihn anzuzeigen, und die Kopieren-Schaltfläche, um ihn zu kopieren.
- Eine Schaltfläche mit der Beschriftung API-Schlüssel neu generieren, wenn bereits ein Schlüssel existiert, oder API-Schlüssel generieren, wenn noch keiner vorhanden ist (in diesem Fall zeigt der Abschnitt Noch kein API-Key an).
- Einen kurzen Hinweis, dass der Schlüssel für externe Tools gedacht ist, mit der Erinnerung, ihn geheim zu halten, sowie einen Link zur API-Dokumentation.
Behandeln Sie den Schlüssel wie ein Passwort. Er gehört zum Konto und nicht zu einem einzelnen Tool, daher funktioniert derselbe Wert überall dort, wo ein Schlüssel akzeptiert wird – und jeder, der ihn besitzt, kann als Ihr Konto handeln. Aus diesem Grund fordert Sie der Abschnitt auf, ihn geheim zu halten.
API-Schlüssel neu generieren
Ein Konto besitzt genau einen API Key. Neu generieren ersetzt diesen Wert, anstatt einen zweiten Schlüssel hinzuzufügen, sodass nie mehr als ein aktiver Schlüssel existiert. Der Bestätigungsschritt hängt davon ab, wie sich Ihr Konto anmeldet, da ein mit Google-Anmeldung erstelltes Konto kein Passwort hat, das Sie hier eingeben könnten.
Wenn sich Ihr Konto mit einem Passwort anmeldet
Wenn Sie API-Schlüssel neu generieren wählen, öffnet sich eine Passwortabfrage. Wenn bereits ein Schlüssel existiert, weist die Abfrage darauf hin, dass der aktuelle Schlüssel ungültig gemacht wird, bevor Sie nach Ihrem Passwort gefragt werden; wenn noch kein Schlüssel vorhanden ist, werden Sie nach Ihrem Passwort gefragt, um einen zu erstellen. Geben Sie Ihr Kontopasswort ein und bestätigen Sie, um abzuschließen.
Wenn das Passwort nicht übereinstimmt, ändert sich nichts und die Seite meldet, dass das Passwort falsch war.
Wenn Ihr Konto mit der Google-Anmeldung verknüpft ist
Bei einem Konto, das sich mit Google anmeldet, erfolgt die Bestätigung über einen Google-Anmeldeschritt statt über ein Passwort. Wenn Sie API-Schlüssel neu generieren wählen, öffnet sich ein Dialog mit dem Titel Identität bestätigen, in dem Sie aufgefordert werden, sich über Google zu bestätigen. Wenn das Konto bereits einen Schlüssel hat, weist der Dialog darauf hin, dass der aktuelle Schlüssel zuerst ungültig gemacht wird.
Dies ist der Weg, den Sie nutzen sollten, wenn die obige Passwortabfrage für Sie keine Option ist – das gilt für Konten, die über die Google-Anmeldung erstellt wurden.
Nach der Neugenerierung: Aktualisieren Sie die Stellen, die den Schlüssel verwenden
Das Generieren eines neuen Schlüssels wird sofort wirksam. Der vorherige Wert funktioniert ab diesem Moment nicht mehr – es gibt keine Gnadenfrist und keine Möglichkeit, beide Schlüssel aktiv zu halten. Alles, was noch den alten Schlüssel sendet, wird abgelehnt, bis es den neuen erhält.
| Wo der Schlüssel verwendet wird | Was nach der Neugenerierung zu tun ist |
|---|---|
| Google-Sheets-Add-on | Öffnen Sie den Bereich Konto in der Seitenleiste und fügen Sie den neuen Schlüssel in das Feld API-Schlüssel einfügen ein. Wenn das Add-on stattdessen mit Mit Google anmelden verbunden ist, verwendet es den Schlüssel überhaupt nicht und benötigt keine Änderung. |
| v1-API | Ersetzen Sie den alten Schlüssel überall dort durch den neuen, wo Ihre Anwendung ihn speichert. Aufrufe mit dem alten Schlüssel werden nicht mehr authentifiziert. Aktualisieren Sie den Schlüssel daher vor Ihrem nächsten Lauf. |
Durch die Neugenerierung ändert sich nur der Schlüssel. Ihre Dateien, Vorlagen, Credits und Ihr Plan bleiben unberührt, und der neue Schlüssel hat denselben Zugriff wie der alte.
Häufige Fragen
Ich habe meinen Schlüssel verloren. Kann ich ihn erneut einsehen?
Ja, solange Sie sich anmelden können. Die Profilseite zeigt immer den aktuellen Schlüssel; er ist hinter Punkten verborgen, bis Sie ihn mit der Augen-Schaltfläche anzeigen, und Sie können ihn von dort kopieren. Wenn Sie ihn lieber ersetzen als wiederverwenden möchten, verwenden Sie stattdessen API-Schlüssel neu generieren.
Kann ich mehr als einen Schlüssel gleichzeitig haben?
Nein. Das Konto enthält einen einzigen API Key. Durch die Neugenerierung wird er ersetzt, sodass der vorherige Wert aufhört zu funktionieren, sobald der neue generiert wird.
Benötigt das Google-Sheets-Add-on immer einen Schlüssel?
Nein. Das Add-on kann sich entweder über die Google-Anmeldung oder durch Einfügen eines API Key verbinden. Wenn Sie es mit der Google-Anmeldung verbinden, verwendet die Seitenleiste den Schlüssel nicht, und die Neugenerierung eines Schlüssels hat keine Auswirkungen auf diese Verbindung. Nur die Stellen, die den Schlüssel selbst verwenden, müssen aktualisiert werden. Siehe Google-Sheets-Add-on.
Verwendet die v1-API diesen Schlüssel?
Ja. Jeder v1-API-Aufruf authentifiziert sich mit dem Schlüssel, weshalb der alte nach der Neugenerierung ausgetauscht werden muss. API-Zugriff erklärt, für wen die API gedacht ist und was sie erfordert; die vollständige Referenz finden Sie auf der Entwicklerdokumentations-Website.