Zweck
Dieser Artikel fasst zusammen, wie die Tulip-API aufgebaut und strukturiert ist.
Welchem Zweck dient der Tulip-API-Unit-Test?
Er ermöglicht das Testen einiger der am häufigsten verwendeten Tulip-API-Funktionen. In der Anwendung enthaltene Funktionen:
- Tulip-Tabellen auflisten
- Datensätze einer Tulip-Tabelle auflisten
- Einen Datensatz in einer Tulip-Tabelle anlegen
- Anzahl der Datensätze einer Tulip-Tabelle ermitteln
- Einen Datensatz einer Tulip-Tabelle löschen
- Einen Datensatz einer Tulip-Tabelle aktualisieren
- Alle Datensätze einer Tulip-Tabelle löschen
- URLs signieren
In der Unit-Test-Umgebung verwendete Tabelle
Um die Funktionen der Tulip-Tabellen-API zu testen, benötigt der Benutzer eine Testtabelle, nämlich die Tulip-API-Beispieltabelle.
App-Struktur
Prior to r383, Service Accounts were called "API Tokens".
Auf der linken Seite jedes Schritts befindet sich ein Menü.
In den Schritten „Einführung“ und „Verbindung konfigurieren“ kann der Benutzer Informationen zum Zweck der Anwendung lesen und Anweisungen zur Konfiguration der Verbindung zwischen dem Tulip-API-Konnektor und seiner Instanz finden.
Wenn in Ihrer Instanz keine Arbeitsbereiche aktiviert sind, navigieren Sie zu „Kontoeinstellungen“ > „Tulip API“, um Ihr Dienstkonto zu erstellen. In diesem Fall müssen Sie in Ihrem API-Endpunkt nicht auf /w/DEFAULT verweisen, d. h., um Tabellen abzurufen, lautet Ihr Endpunkt: Basis-URL + api/v3/tables
Wenn Sie „Workspaces“ aktiviert haben und ein globales API-Dienstkonto verwenden (zu finden unter „Kontoeinstellungen“ > „Tulip API“), müssen Sie den Workspace in Ihrem API-Endpunkt definieren. Um beispielsweise Tabellen abzurufen, lautet Ihr Endpunkt-Basis-URL + api/v3/w/<Workspace-ID>/tables. Weitere Informationen hierzu finden Sie hier: https://support.tulip.co/apidocs/introduction#workspaces
Wenn Sie Arbeitsbereiche aktiviert haben und ein auf den Arbeitsbereich beschränktes Dienstkonto verwenden (zu finden unter „Arbeitsbereichseinstellungen“ > „Tulip-API“), müssen Sie den Arbeitsbereich nicht in Ihrem API-Endpunkt definieren. Um beispielsweise Tabellen abzurufen, lautet Ihr Endpunkt:-BASE-URL + api/v3/tables
Im Schritt „Tabellen abrufen“ wird die Connector-Funktion beim Klicken auf die Schaltfläche „Tabellen abrufen“ ausgeführt, um alle Tabellen in der Instanz aufzulisten. Der Benutzer kann eine Tabelle aus der interaktiven Tabelle auf der linken Seite auswählen und deren Details auf der rechten Seite anzeigen.
Im Schritt „Datensatz erstellen“ kann der Benutzer einen neuen Datensatz erstellen, indem er die Eingabefelder ausfüllt. Wenn die Schaltfläche „Datensatz erstellen“ angeklickt wird und alle Felder ausgefüllt sind, wird der neue Datensatz in der interaktiven Tabelle auf der rechten Seite angezeigt. 
Im Schritt „Datensätze abrufen“ werden die Datensätze der Tabelle „Tulip API Sample“ beim Klicken auf die Schaltfläche „Datensätze abrufen“ aufgelistet. Der Benutzer kann einen Datensatz aus der interaktiven Tabelle auf der linken Seite auswählen und dessen Details auf der rechten Seite anzeigen.
Im Schritt „Datensätze zählen“ wird die Connector-Funktion beim Klicken auf die Schaltfläche ausgeführt, und die Anzahl der Datensätze wird auf der rechten Seite angezeigt.
Im Schritt „Datensatz aktualisieren“ kann der Benutzer die ID des zu aktualisierenden Datensatzes auswählen und die zu aktualisierenden Eingabefelder ausfüllen. Sobald auf die Schaltfläche „Datensatz aktualisieren“ geklickt wird, wird der aktualisierte Datensatz auf der rechten Seite angezeigt.
Im Schritt „Datensatz löschen“ muss der Benutzer einen Datensatz aus der interaktiven Tabelle auf der linken Seite auswählen. Wenn auf die Schaltfläche „Datensatz löschen“ geklickt wird, wird der Datensatz aus der Beispieltabelle gelöscht.
Im Schritt „Alle Datensätze löschen“ werden alle Datensätze aus der Beispieltabelle gelöscht, sobald auf die Schaltfläche „Alle Datensätze löschen“ geklickt wird.
Im Schritt „URL signieren“ kann der Benutzer eine URL eingeben und diese signieren. Sobald die URL signiert ist, kann die signierte URL im rechten Fensterbereich angezeigt werden. 