Video-Tutorials
Das Video ist auf Englisch (Kommentar und Untertitel).
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, statt 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.
So finden Sie Ihren API Key
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 vorhanden ist, oder API-Schlüssel generieren, wenn noch keiner vorhanden ist (in diesem Fall zeigt der Abschnitt Noch kein API-Key vorhanden).
- 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 vorhanden ist, weist die Abfrage darauf hin, dass der aktuelle Schlüssel ungültig gemacht wird, bevor nach Ihrem Passwort gefragt wird; wenn noch kein Schlüssel vorhanden ist, wird 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, ist die Bestätigung ein Google-Anmeldeschritt anstelle eines Passworts. 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 wählen sollten, wenn die Passwortabfrage oben für Sie keine Option ist – das gilt für Konten, die über die Google-Anmeldung erstellt wurden.
Nach dem Neu generieren: Stellen aktualisieren, 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 dem Neu generieren 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. |
Das Neu generieren ändert nur den 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 wieder 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. Das Neugenerieren ersetzt ihn, 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 das Neugenerieren eines Schlüssels hat keine Auswirkung 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 dem Neugenerieren ausgetauscht werden muss. API Access erklärt, für wen die API gedacht ist und was sie erfordert; die vollständige Referenz finden Sie auf der Entwicklerdokumentationsseite.