Erstellen und Verwenden von API-Schlüsseln und Zugangstokens

1. Wenn Airtable geöffnet ist, klicken Sie auf Ihr Konto in der oberen rechten Ecke des Bildschirms. Hier sehen Sie ein Drop-down-Menü. Klicken Sie auf die Option Entwickler-Hub. Oder wenn Sie gerade bei Airtable angemeldet sind, können Sie hier klicken, um auf den Entwickler-Hub zuzugreifen.
   
2. Dies bringt Sie zur Seite Persönliche Zugangstokens des Hubs. Von hier aus klicken Sie auf die blaue Option + Neues Token erstellen in der Nähe des oberen rechten Teils des Bildschirms.
3. Dies öffnet die Konfigurationsoptionen für das PAT, das Sie gerade erstellen. 
4. Benennen Sie zunächst das PAT und wählen Sie dann die Bereiche aus, auf die dieses PAT Zugriff haben soll. Weitere Informationen darüber, welche Bereiche wir derzeit anbieten, finden Sie hier.
   
5. Wählen Sie schließlich aus, welche Zugriffsebene dieses PAT haben soll. Sie haben die Wahl zwischen einer einzelnen Base, mehreren Bases (sogar Bases aus verschiedenen Workspaces), allen aktuellen und zukünftigen Bases in einem Workspace, dessen Inhaber*in Sie sind, oder sogar allen Bases aus einem beliebigen Workspace, dessen Inhaber*in Sie sind einschließlich der Bases/Workspaces, die in Zukunft hinzugefügt werden.
   
   Hinweis

   Nur Enterprise-Admins können die Option zum Hinzufügen von Airtable Enterprise wählen. Dies ermöglicht Admins einen besonderen Zugang, um auch Workspaces und Bases einzubeziehen, die ihrer Organisation im Laufe der Zeit hinzugefügt wurden.

1. Navigieren Sie im Entwickler-Hub zum Namen des PAT, das Sie ändern möchten, oder suchen Sie danach. Klicken Sie dann auf den Namen des Tokens.
   
2. Ändern Sie den Namen, die Bereiche oder den Zugang für das PAT. Beachten Sie, dass Sie Bereiche und Zugriffsrechte hinzufügen oder entfernen können.
   
3. Sobald Sie mit den Änderungen zufrieden sind, klicken Sie auf Änderungen speichern.

1. Navigieren Sie im Entwickler-Hub zum Namen des PAT, das Sie ändern möchten, oder suchen Sie danach. Klicken Sie dann auf das Punktemenü ganz rechts neben diesem PAT.
2. Klicken Sie von hier aus auf die Option, die Sie verwenden möchten.
   
3. Wenn Sie ein Token neu generieren, wird eine Warnmeldung angezeigt. Denken Sie daran, dass alle Dienste, die dieses Token derzeit verwenden, mit dem neu generierten Token aktualisiert werden müssen.
4. Wenn Sie ein Token löschen, wird eine Warnmeldung angezeigt. Alle Dienste, die dieses Token derzeit für den Zugriff auf Daten in Airtable verwenden, können dies nicht mehr tun, nachdem Sie auf Löschen gedrückt haben.

1. Um Ihren API-Schlüssel zu finden, navigieren Sie zu Ihrer Kontoseite. Auf Ihrer Übersichtsseite Ihres Kontos gibt es unter der Überschrift <>API eine Schaltfläche mit der Aufschrift API-Schlüssel generieren.
2. Wenn Sie auf diese Schaltfläche klicken, wird ein API-Schlüssel für Sie generiert.
   

Nachdem Sie einen Schlüssel generiert haben, können Sie Ihren Schlüssel neu generieren oder löschen. Um Ihren Schlüssel neu zu generieren, klicken Sie auf die Option API-Schlüssel neu generieren. Daraufhin wird eine Warnung angezeigt, dass die erneute Generierung Ihres Schlüssels Ihre API-Integrationen unterbrechen wird. Klicken Sie auf die blaue Schaltfläche Ja, Schlüssel neu generieren, um die erneute Generierung Ihres Schlüssels zu bestätigen.

Um Ihren Schlüssel zu löschen, klicken Sie auf die Option Schlüssel löschen. Es wird eine Warnung angezeigt, dass das Löschen Ihres Schlüssels Ihre API-Integrationen unterbrechen wird. Klicken Sie auf die rote Schaltfläche Ja, Schlüssel löschen, um die Löschung Ihres Schlüssels zu bestätigen.

Melden Sie sich von Ihrem persönlichen Airtable Konto ab und gehen Sie zu https://airtable.com/signup, um ein neues Konto zu erstellen. Verwenden Sie dazu eine andere E-Mail-Adresse als die, mit der Sie sich normalerweise bei Airtable anmelden.

Sobald Sie das neue Konto erstellt und sich angemeldet haben, gehen Sie zur Kontoseite und generieren einen API-Schlüssel. Eine ausführlichere Anleitung finden Sie hier. Notieren Sie sich diesen API-Schlüssel und halten Sie ihn griffbereit.

Wenn Sie wieder in Ihrem persönlichen Airtable Konto angemeldet sind, fügen Sie dieses neue Konto als schreibgeschützten Mitwirkender in der Base hinzu, auf die Sie mit der zu konfigurierenden Integration zugreifen möchten. In diesem Fall ist es am besten, wenn Sie das schreibgeschützte Konto als Base-Mitwirkender und nicht als Workspace-Mitwirkender hinzufügen. Wenn Sie das Konto als Mitwirkender für einen Workspace hinzufügen, hat es Zugriff auf alle Bases in einem Workspace (einschließlich Bases, die in Zukunft erstellt werden).

Wenn Sie bei der Einrichtung einer neuen Integration nach „Ihrem Airtable API-Schlüssel“ gefragt werden, verwenden Sie den API-Schlüssel, den Sie für dieses neue Konto erstellt haben, und nicht den API-Schlüssel für Ihr persönliches Airtable Konto. Auf diese Weise kann die Integration nur auf die Bases zugreifen, die ausdrücklich für dieses neue Konto freigegeben sind, und nicht auf alle Bases, auf die Sie mit Ihrem persönlichen Airtable Konto zugreifen können.

Im Gegensatz zu herkömmlichen API-Schlüsseln, die den gleichen Zugriff wie Ihr Airtable Konto haben, können Sie den Zugriff Ihrer persönlichen Zugangstokens beschränken und konfigurieren. Dies können Sie tun, indem Sie bei der Erstellung oder Aktualisierung eines Tokens die Bereiche (welche Endpunkte das Token verwenden kann) und den Zugang/Ressourcen (auf welche Bases und Workspaces das Token zugreifen kann) auswählen. 

Unabhängig von den Bereichen und Zugängen, die Benutzer*innen für ihre Tokens auswählen, können die Tokens nur Aktionen ausführen, die die Benutzer*innen selbst ausführen dürfen. Um beispielsweise über die API ein neues Feld in einer Base zu erstellen, müssen die Benutzer*innen Mitwirkende mit Erstellerberechtigung in der Base sein. Außerdem muss das Token den Geltungsbereich schema.bases:write haben und die Base muss als Ressource hinzugefügt sein. 

Weitere Informationen darüber, wie Bereiche und der Zugriff funktionieren, finden Sie in der Entwicklerreferenz für Authentifizierung. Weitere Informationen über die Konfiguration des Zugriffs Ihres Tokens finden Sie im Leitfaden für persönliche Zugangstokens.