FlexiProject oferă un API REST prin care un alt sistem poate citi și modifica datele organizației — poate alimenta un raport BI, sincroniza proiecte cu un ERP sau automatiza o operațiune repetitivă. Descrierea completă a endpoint-urilor se află la developers.flexi-project.com.

Pentru a apela API-ul aveți nevoie de un token personal de acces (token API). Îl creați singur în profilul dvs., în fila API, iar el funcționează cu permisiunile dvs.: API-ul arată exact datele pe care le vedeți în aplicație și nimic mai mult.

Token personal de acces

Cine poate crea un token

Un token este creat, pentru propriul cont, de un utilizator cu licență Completă (vezi Licențe) și de un administrator de sistem; fila API este vizibilă numai pentru ei. Nu este necesară nicio permisiune de administrator. Tokenul preia permisiunile proprietarului său, deci ajunge la aceleași proiecte și câmpuri pe care proprietarul le vede în aplicație. Două persoane cu roluri diferite obțin rezultate diferite pentru aceeași cerere.

Un token nu mai funcționează atunci când contul este dezactivat, eliminat din organizație sau blocat, deci nu trebuie să ștergeți tokenurile când pleacă cineva.

Crearea unui token

1. Deschideți meniul avatarului, alegeți Profilul utilizatorului și treceți la fila API (vezi Profilul utilizatorului).
2. Faceți clic pe Token nou.
3. Introduceți o Denumire — cel mult 100 de caractere. Denumirea trebuie să arate cărei integrări îi este destinat tokenul, deoarece este singura modalitate de a vă deosebi ulterior tokenurile.
4. Setați Data expirării. Cea mai apropiată este mâine, cea mai îndepărtată — peste 365 de zile, iar câmpul se deschide cu 30 de zile. Tokenul expiră la sfârșitul zilei alese.
5. Faceți clic pe Creează token.

Copiați tokenul imediat

Fereastra Tokenul personal de acces a fost creat arată valoarea completă o singură dată, cu un avertisment: Copiați tokenul și păstrați-l într-un loc sigur — după închiderea acestei ferestre nu va mai fi posibilă vizualizarea acestuia. Butonul Copiază copiază valoarea în clipboard; lipiți-o imediat în sistemul care o va folosi. După ce închideți fereastra, nimeni nu mai poate recupera valoarea — nici dvs., nici un administrator, nici asistența tehnică. Dacă pierdeți un token, ștergeți-l și creați unul nou.

Lista tokenurilor

Fila API listează tokenurile dvs. în coloanele Denumire, Token, Creat la și Expiră la. Coloana Token arată doar primele caractere ale valorii — suficient pentru a recunoaște tokenul salvat într-o integrare.

Coloana Expiră la avertizează din timp: un token care expiră în decurs de șapte zile are o etichetă cu numărul de zile rămase, unul care expiră astăzi afișează expiră astăzi, iar unul expirat afișează expirat. Un token expirat rămâne în listă până îl ștergeți, dar nu mai autentifică nimic.

Puteți avea cel mult zece tokenuri active în același timp. După atingerea limitei, aplicația refuză crearea altuia, cu mesajul Aveți deja 10 tokenuri personale de acces active. Ștergeți un token neutilizat pentru a crea unul nou. Tokenurile expirate nu se numără în limită.

Ștergerea unui token

Pictograma coșului de gunoi din rândul unui token îl șterge după confirmare. Aplicația avertizează că integrările care îl folosesc vor înceta să funcționeze imediat — și chiar încetează, la următoarea cerere. Ștergerea nu poate fi anulată; înlocuirea unui token înseamnă întotdeauna un token nou, cu o valoare nouă.

Utilizarea unui token

Tokenul API nu se trimite cu fiecare cerere. Îl schimbați o singură dată pe un token de acces și apoi folosiți acel token de acces.

Trimiteți un POST la /api/user/token/personal cu adresa dvs. de e-mail și valoarea tokenului:

POST /api/user/token/personal
Content-Type: application/json

{ "email": "anna.kowalska@example.com", "token": "fpat_…" }

Răspunsul conține access_token, tipul lui, identificatorul organizației căreia îi aparține tokenul și numărul de secunde pentru care este valabil. Trimiteți tokenul de acces în antetul Authorization al apelurilor următoare și repetați schimbul după expirarea lui.

Adresa de e-mail trebuie să aparțină contului care a creat tokenul, iar organizația în care ajungeți este stabilită de token — dacă lucrați în mai multe, creați câte un token separat în fiecare.

Încercările eșuate repetate sunt limitate: după zece încercări eșuate pentru aceeași adresă de e-mail, următoarele sunt respinse timp de cincisprezece minute. Dacă o integrare începe brusc să primească refuzuri în masă, verificați valoarea salvată, în loc să reîncercați într-o buclă.

Schimbul unui token API funcționează și când autentificarea cu parolă este oprită, deoarece nu este vorba de o persoană care se autentifică (vezi Metode de autentificare).