Papervee Public API: token și date disponibile
Papervee Public API permite unui sistem extern, de exemplu o aplicație construită de dezvoltatorii tăi, să citească și să scrie date în Papervee. Sistemul extern se identifică printr-un token generat de tine. Pentru fiecare spațiu de lucru există un singur token. Doar Owner-ul îl poate genera, copia sau șterge.
Înainte să începi
- Ești Owner-ul spațiului de lucru. Pentru HR Manageri, panoul apare estompat.
- Token-ul dă acces la datele tale din Papervee. Trimite-l doar persoanelor sau sistemelor în care ai încredere.
Generează token-ul
- Apasă Integrări și automatizare, din meniul din stânga, apoi cardul Papervee Public API.
- Apasă Generează token nou.
- Citește întrebarea de confirmare. Prima dată, întrebarea este Ești sigur că vrei să generezi un nou API token?.
- Apasă Generează token nou în fereastra de confirmare. Apare mesajul Ai generat un nou token cu succes.
Token-ul rămâne vizibil în panou. Nu apare o singură dată, ci îl poți vedea oricând redeschizi cardul.
Copiază token-ul
Apasă Copiază, de lângă câmpul cu token-ul. Butonul se schimbă în Copiat, iar token-ul este pe clipboard.
Generează un token nou sau șterge-l
- Dacă ai deja un token și apeși Generează token nou, Papervee te întreabă dacă vrei să dezactivezi token-ul actual și să generezi altul. Token-ul vechi nu mai funcționează după ce îl înlocuiești.
- Pentru a șterge token-ul, apasă iconița de coș și confirmă. Apare mesajul Ai șters acest token API cu succes.
Ce date poate folosi un sistem extern
Cu token-ul, un sistem extern poate:
- citi clienții de proiect cu proiectele lor, proiectele cu utilizatorii alocați și subproiectele;
- citi intrările de timp încheiate ale utilizatorilor pe proiecte, cu client, proiect și subproiect. O cerere acoperă cel mult 31 de zile;
- citi lista angajaților activi, cu nume, adresă de email, funcție, echipele de proiect și câmpurile personalizate pe care le-ai marcat ca publice;
- citi concediile și evenimentele dintr-o perioadă, de cel mult 366 de zile;
- crea un utilizator, cu aceleași reguli ca la adăugarea din aplicație. Utilizatorul primește notificările obișnuite de bun venit;
- porni și opri pontajul unui utilizator, eventual pe un proiect sau subproiect, și porni sau opri pauza.
Dacă ai conectat Slack, pornirea și oprirea pontajului prin Public API generează aceleași mesaje ca în aplicație.
Bine de știut
- Sistemul extern poate trimite cel mult 60 de cereri pe minut de la aceeași adresă IP.
- Dacă sistemul extern cere pentru un utilizator nou acces la un modul pentru care spațiul tău de lucru nu are abonament activ, utilizatorul nu se creează, iar cererea primește o eroare.
