Scopo
Questo articolo riassume come è strutturata e realizzata l’API di Tulip.
A cosa serve il test unitario dell’API di Tulip?
Consente di testare alcune delle funzioni dell’API di Tulip utilizzate più frequentemente. Funzioni incluse nell’applicazione:
- Elenco delle tabelle Tulip
- Elenco dei record di una tabella Tulip
- Creazione di un record in una tabella Tulip
- Conta i record di una tabella Tulip
- Eliminare un record da una tabella Tulip
- Aggiorna un record di una tabella Tulip
- Eliminare tutti i record di una tabella Tulip
- Firmare gli URL
Tabella utilizzata nel test unitario
Per testare le funzioni dell'API della tabella Tulip, l'utente ha bisogno di una tabella di prova, ovvero la tabella di esempio dell'API Tulip.
Struttura dell'app
Prior to r383, Service Accounts were called "API Tokens".
Sul lato sinistro di ogni passaggio è presente un menu.
Nei passaggi " Introduzione " e "Configura connessione ", l'utente può leggere informazioni sullo scopo dell'applicazione e trovare istruzioni su come configurare la connessione tra il connettore API di Tulip e la propria istanza.
Se la propria istanza non ha gli spazi di lavoro abilitati, accedere a Impostazioni account > API Tulip per generare il proprio account di servizio. In questo caso, non è necessario fare riferimento a /w/DEFAULT nel proprio endpoint API; in altre parole, per ottenere le tabelle, l’endpoint sarà: URL di base + api/v3/tables
Se hai abilitato gli spazi di lavoro e stai utilizzando un account di servizio API globale (che trovi in Impostazioni account > API Tulip), dovrai definire lo spazio di lavoro nel tuo endpoint API; ad esempio, per recuperare le tabelle, il tuo endpoint sarà-URL di base + api/v3/w/<workspaceID>/tables. Per saperne di più, consulta questa pagina: https://support.tulip.co/apidocs/introduction#workspaces
Se hai abilitato gli spazi di lavoro e stai utilizzando un account di servizio con ambito dello spazio di lavoro (che trovi in Impostazioni dello spazio di lavoro > API Tulip), non è necessario definire lo spazio di lavoro nel tuo endpoint API; ad esempio, per recuperare le tabelle, il tuo endpoint sarà-URL di base + api/v3/tables
Nel passaggio "Ottieni tabelle ", la funzione del connettore viene eseguita quando si preme il pulsante "Ottieni tabelle" per elencare tutte le tabelle presenti nell’istanza. L’utente può selezionare una tabella dalla tabella interattiva a sinistra e visualizzarne i dettagli a destra.
Nel passaggio "Crea record ", l’utente può creare un nuovo record compilando i campi di input. Quando si fa clic sul pulsante "Crea un record " e tutti i campi sono stati compilati, il nuovo record può essere visualizzato nella tabella interattiva a destra. 
Nel passaggio "Ottieni record ", i record della tabella "Tulip API Sample " vengono elencati quando si preme il pulsante "Ottieni record". L’utente può selezionare un record dalla tabella interattiva a sinistra e visualizzarne i dettagli a destra.
Nella fase "Conta record ", la funzione del connettore viene eseguita premendo il pulsante e il numero di record è visibile sulla destra.
Nel passaggio "Aggiorna record ", l’utente può selezionare l’ID del record da aggiornare e compilare i campi di input da modificare. Non appena si fa clic sul pulsante "Aggiorna record ", il record aggiornato è visualizzabile sulla destra.
Nella fase "Elimina record ", l’utente deve selezionare un record dalla tabella interattiva a sinistra. Quando si fa clic sul pulsante "Elimina record ", il record viene eliminato dalla tabella di esempio.
Nel passaggio " Elimina tutti i record ", quando si fa clic sul pulsante "Elimina tutti i record ", tutti i record vengono eliminati dalla tabella di esempio.
Nel passaggio "Firma URL ", l'utente può inserire un URL e firmarlo. Una volta firmato l'URL, l'URL firmato può essere visualizzato nel riquadro di destra. 