Die SeaTable API ist eine standardisierte Schnittstelle, mit der man praktisch jede Aktion durchführen könnte, die man als Benutzer auch über das Webinterface ausführen könnte. Mit der SeaTable-API können sowohl neue Strukturen wie Bases, Tabellen oder Zeilen angelegt werden, sowie auch existierende Werte ausgelesen werden.
Was ist genau eine API? #
Die Abkürzung API steht für Application Programming Interface und bezeichnet typischerweise eine Programmierschnittstelle, um Informationen zwischen einer Anwendung und einzelnen Programmteilen standardisiert auszutauschen. Eine API definiert die Struktur und die Syntax, die man zum Ausführen von vordefinierten Befehlen benötigt.
APIs trifft man typischerweise bei Webanwendungen und sollen primär Entwicklern das Leben erleichtern. Eine etwas umfassendere Erklärung von APIs finden Sie unter dem folgenden Artikel von howtogeek.com. Die vollständige API-Dokumentation von SeaTable finden Sie unter diesem Link.
API-Calls für die Interaktion mit den eigenen Bases und dem eigenen Account #
Die SeaTable API lässt sich grob in zwei Bereiche einteilen. Der eine Bereich bietet Möglichkeiten, um mit den Strukturen, Informationen und Daten in einer Base zu interagieren. Der andere Bereich dient der Interaktion mit dem eigenen Account. Diese Unterteilung findet man auch in der offiziellen API-Dokumentation.
In der API-Dokumentation werden deshalb die folgenden Bereiche unterschieden:
- Account Operations
- Base Operations
Authentifizierung eines API-Calls #
Genauso wie die Nutzung der SeaTable Cloud die Eingabe eines Benutzernamen und Passworts erfordert, muss jeder API-Call authentifiziert werden. Dies erfolgt über einen mitgeschickten Token. Ein Token ist somit so zu behandeln, wie ein Passwort und sollte weder weitergegeben noch veröffentlicht werden. Wenn jemand in den Besitz eines Tokens kommt, kann diese Person so auf die Base oder den Account zugreifen, wie es der ursprüngliche Besitzer es könnte.
Jeder Token trägt dabei die folgenden Informationen in sich:
- Ziel – Für welche Base oder welche Benutzeraccounts gilt dieser Token.
- Berechtigung – Welche Berechtigung wird dadurch erteilt.
- Gültigkeit – Wie lange ist dieser Token gültig.
Häufige Fragen #
Was kann man alles mit der SeaTable API tun?
Antwort 1
Wie starte ich mit der SeaTable API?
Antwort 2
Gibt es ein Ausführungslimit der SeaTable API?
Ja, die SeaTable-API hat verschiedene Limitationen. Das wichtigste Limit beträgt maximal 300 Anfragen pro Minute und 5.000 Anfragen pro Tag und einzelner Base. Sobald dieses Limit erreicht ist, werden alle weiteren Anfragen mit dem Fehlercode 429 abgelehnt. Im Admin-Handbuch finden eine Übersicht über alle API-Limitationen.
