Conectori proprii

Un conector propriu este un serviciu pe care îl descrii chiar tu: orice API de pe internet care primește o cheie. După ce este creat, aplicațiile tale îl folosesc ca pe orice conector din listă, prin Setherion, cu cheia ținută pe serverele noastre.

Apasă + în dreapta sus pe pagina Connectors, apoi Custom connector, și completează:

• Details. Un Display name, o Short description pentru listă, o Description mai lungă, o Category și, dacă vrei, o adresă de documentație.
• Authentication. Cum călătorește cheia: un Bearer token, un API key in a header (tu numești antetul), un API key in the address (tu numești parametrul) sau un Username and password. Poți numi și ce li se cere oamenilor, de exemplu „Password”. What requests to this API will look like îți arată cum vor arăta cererile, pe măsură ce alegi. Apoi API base URL, de unde pornește fiecare cerere, și o Test request: un apel simplu care eșuează fără o cheie validă, de pildă unul care întoarce contul curent.
• Who may use it. Only your app's team (implicit), Visitors can read sau Anybody, apoi felurile de cereri pe care aplicațiile le pot trimite: GET citește, celelalte schimbă lucruri. Cu Visitors can read, oricine deschide aplicația poate citi, iar doar echipa schimbă lucruri. Cu Anybody, oricine poate face fiecare apel permis de tine, iar apelurile sunt limitate mai strict pentru fiecare vizitator, așa că alege-l doar pentru un API construit pentru asta.
• Agent knowledge. Opțional, și merită scris: căile, o cerere și un răspuns pentru fiecare, și orice se greșește ușor. Setherion îl citește când îți construiește aplicațiile. Fără el, Setherion trebuie să ghicească căile, iar o ghicire poate fi greșită: spune, de exemplu, ce cale întoarce propriul tău cont. Nu lipi niciodată aici o cheie.

În formular nu intră nicio cheie. Create deschide pagina conectorului, unde adaugi cheia, apeși Test connection și te conectezi, ca la orice alt serviciu. Edit și Delete sunt tot pe pagina aceea. Ștergerea îi șterge și cheia, iar aplicațiile care îl folosesc nu-l mai ajung pe loc.

Cere. După ce este conectat și bifat pentru o aplicație, cere-l pe nume: „Arată-mi pe panoul de control proiectele mele deschise din Acme.” „Adaugă un buton care creează o sarcină în Acme.”

• API base URL trebuie să înceapă cu https:// și să fie pe internetul public. O adresă dintr-o rețea privată, o adresă IP sau una cu alt port decât 443 este refuzată, când o salvezi și din nou la fiecare apel.
• Conectorii proprii sunt ai tăi: nu sunt împrumutați membrilor unui spațiu de lucru de echipă, iar un spațiu de lucru care își listează conectorii permiși aplicațiilor îi lasă pe aceștia deoparte.
• Poți avea cel mult 25.
• Pentru o singură cheie de care are nevoie o aplicație, Chei și secrete pot fi de ajuns.