Chei API și API-ul

O cheie API este o parolă care aparține unui program în locul unei persoane. Tratați-o la fel: emiteți una per sistem și înlocuiți-o când acel sistem se schimbă.

Creați o cheie

1. Deschis API → Gestionare API și apăsați Cheie nouă.
2. Dați-i un nume care să indice ce sistem îl folosește.
3. Alegeți Permisiuni: Acces complet, sau doar zonele de care sistemul are nevoie. Majoritatea zonelor disting între citire, creare și modificare.
4. Alegeți o dată de expirare sau niciuna.
5. Utilizați Afișare și Copiați pe cardul cheie pentru a preda cheia sistemului apelant. Sistemul o trimite în authtoken antet.

Fiecare card de acces arată permisiunile, data creării, Ultima utilizare și un ecuson precum „activ” sau „expiră în 5 zile”.

Reînnoiți o cheie înainte de expirare

Cu paisprezece zile înainte de expirarea unei chei, primiți o notificare în clopoțel. Apăsați Reînnoiți pe cardul cheie și alegeți noua dată de expirare. IDup creează o nouă cheie cu aceleași permisiuni. Copiați-o imediat, deoarece această afișare apare doar o dată. Cheia veche rămâne valabilă până la expirarea sa, astfel încât să puteți comuta sistemul fără întreruperi.

Zonele la care puteți ajunge

API-ul acoperă datele dumneavoastră de client și, în funcție de planul dumneavoastră, proprietăți și închirieri, profiluri de căutare, fișiere fiscale, fișiere de mandat, contabilitate, runde de salarii și scanare de chitanțe. AI Studio și inbox-ul au propriile lor zone. Ghidul API listează doar zonele incluse în planul dumneavoastră.

Ghidul API

Deschideți Documentație tab pe pagina de gestionare a API-ului, sau API → Ghid API. Fiecare zonă afișează câmpurile sale, exemple de cereri pe care le puteți copia, răspunsuri exemplu și coduri de eroare.

Webhooks și alte interfețe

• The Webhooks tab trimite evenimente către sistemul dumneavoastră pe măsură ce se întâmplă — vedeți Trimiteți evenimente către propriul sistem cu webhooks.
• Dacă API-ul pentru clienți este activat, un Setări API Clienți tab deschide setările sale, de exemplu dacă clienții se pot înregistra prin API.
• Automatizare / fluxuri de lucru → Interfață tehnică emite un token pentru interfața GraphQL.
• AI Studio → Chei API personale este un set separat de chei.

Păstrarea în siguranță

1. O cheie per sistem, niciodată una partajată.
2. Acordați unei chei doar permisiunile de care sistemul are nevoie.
3. Setați o dată de expirare și reînnoiți conform unui program.
4. Ștergeți o cheie imediat ce cineva care o cunoștea pleacă sau sistemul este oprit.