Connettori personalizzati

Un connettore personalizzato è un servizio che descrivi tu: qualsiasi API su internet che richiede una chiave. Una volta creato, le tue app lo usano come qualsiasi connettore dell’elenco, tramite Setherion, con la chiave conservata sui nostri server.

Premi + in alto a destra nella pagina Connectors, poi Custom connector, e compila:

• Details. Un Display name, una Short description per l’elenco, una Description più lunga, una Category e un indirizzo facoltativo della documentazione.
• Authentication. Come viaggia la chiave: un Bearer token, una API key in a header (dai un nome all’header), una API key in the address (dai un nome al parametro), oppure Username and password. Puoi anche indicare che cosa viene chiesto alle persone, come “Password”. What requests to this API will look like lo mostra man mano che scegli. Poi l’API base URL, da cui parte ogni richiesta, e una Test request: una semplice chiamata che fallisce senza una chiave valida, come una che restituisce l’account corrente.
• Who may use it. Only your app’s team (l’impostazione predefinita), Visitors can read o Anybody, poi i tipi di richiesta che le app possono inviare: GET legge, gli altri modificano. Con Visitors can read, chiunque apra l’app può leggere e solo il team modifica. Con Anybody, tutti possono fare ogni chiamata che hai consentito, e le chiamate sono limitate più strettamente per ogni visitatore, quindi sceglila solo per un’API costruita per questo.
• Agent knowledge. Facoltativa, e vale la pena scriverla: i percorsi, una richiesta e una risposta per ciascuno, e tutto ciò in cui è facile sbagliare. Setherion la legge quando crea le tue app. Senza, Setherion deve indovinare i percorsi, e un’ipotesi può essere sbagliata: di’ quale percorso restituisce il tuo account, per esempio. Non incollare mai qui una chiave.

Nessuna chiave va nel modulo. Create apre la pagina del connettore, dove aggiungi la chiave, premi Test connection e colleghi, come per qualsiasi altro servizio. Anche Edit e Delete sono in quella pagina. Eliminarlo rimuove anche la sua chiave, e le app che lo usano smettono subito di raggiungerlo.

Chiedi. Una volta che è collegato e spuntato per un’app, chiedilo per nome: “Mostra nella dashboard i miei progetti aperti di Acme.” “Aggiungi un pulsante che crea un’attività in Acme.”

• L’API base URL deve iniziare con https:// ed essere sull’internet pubblico. Un indirizzo dentro una rete privata, un indirizzo IP o uno con una porta diversa da 443 viene rifiutato, quando lo salvi e di nuovo a ogni chiamata.
• I connettori personalizzati sono tuoi: non vengono prestati ai membri di uno spazio di lavoro di team, e uno spazio di lavoro che elenca i connettori che le sue app possono usare li lascia fuori.
• Puoi averne fino a 25.
• Per una sola chiave di cui ha bisogno un’app, può bastare la pagina Chiavi e segreti.