- Stampa
Come utilizzare l'API dell'operatore
Utilizzo dell'API dell'operatore
Come impostare l'API dell'operatore
:::(Info) (NOTA) Articolo avanzato: Presuppone un'esperienza precedente con le API. Fare clic qui per visualizzare la documentazione dell'API degli operatori:
L'aggiunta di operatori al vostro sito è necessaria per popolare gli utenti che eseguiranno le applicazioni sviluppate in Tulip. Gli operatori sono tradizionalmente creati all'interno delle Impostazioni dai proprietari degli account. È anche possibile creare questi operatori utilizzando un sistema esterno tramite l'API di Tulip.
Aggiunta di un token API dell'operatore
Nel vostro sito Tulip, andate sul vostro profilo nell'angolo in alto a destra.
Selezionare le opzioni Impostazioni da questo menu.
All'interno delle Impostazioni, selezionare l'opzione Token API.
Sul lato destro della pagina, selezionare Crea token API.
Nella sezione Creazione, date un nome al token API e assicuratevi che sia selezionato l'ambito Utenti:Scrivi, quindi fate clic su Crea.
Nota: Assicurarsi di salvare le informazioni del token API per la chiave API, il segreto e l'intestazione di autorizzazione.
Utilizzo dell'API dell'operatore
Di seguito viene illustrato come creare un operatore. In questo caso, l'esempio utilizzerà Postman per eseguire la creazione.
Per prima cosa, aggiungere il proprio endpoint API alla richiesta Post.
:::(Info) (NOTA) Se si utilizza una chiave API globale, è necessario specificare lo spazio di lavoro. Se la chiave API ha un ambito di lavoro, è opzionale. :::
https://(yourinstancenamehere).tulip.co/api/v3/w/(workspace)/tables/(TableID)/records
Quindi, in Autorizzazione, selezionare Autorizzazione di base e inserire la Chiave API come Nome utente e il Segreto API come Password.
In Headers, aggiungere l'intestazione Auth.
In Body, formattare la richiesta per accogliere l'oggetto JSON. Il formato generico per questa richiesta è il seguente.
{"role": "operator", "name": "string", "badge_id": "string" }
L'aspetto sarà simile a questo:
Premere invio per eseguire la richiesta e si riceverà una risposta 201 per indicare il successo. Per verificare, si può controllare l'elenco degli utenti in Impostazioni e confermare che l'utente è stato creato con successo.
Se la richiesta non è andata a buon fine, verificare che la chiave e il segreto siano corretti. Per ulteriori informazioni su codici di risposta specifici, consultate la sezione Documentazione API nella pagina Token API.
Avete trovato quello che cercavate?
Potete anche andare su community.tulip.co per porre la vostra domanda o vedere se altri hanno affrontato una domanda simile!