Puteți gestiona propriile token-uri în contul companiei. Pentru a o configura, accesați Setări - Gestionarea token-urilor API.

Secțiunea și funcționalitatea sunt disponibile pentru proprietarul companiei și pentru rolul de administrator.

Dacă firma are deja token-uri - acestea vor fi afișate în această secțiune cu drepturile și perioada de valabilitate.

Crearea de token-uri

Butonul "Creați un token" generează un token cu următorii parametri

1. Câmpul "Name" (Numele poate conține litere, cifre și simboluri ʼ'-). Nu este necesar să specificați o denumire pentru a crea un token, atunci tokenul va fi creat cu un nume automat. De exemplu: Cheia 12334567.
2. Câmpul "Valid până la" (perioada maximă posibilă este de 1 an, iar perioada minimă este de 1 zi)
3. Dropdown cu configurarea accesului (doar pentru citire/citire și scriere/fără acces) pentru fiecare set de metode.

Există 7 metode în API-ul public, care sunt configurate în contul de vanzator:

Rețineți! Cel puțin un bloc trebuie să aibă permisiuni deschise, în caz contrar va fi afișată o eroare:

Drepturi de acces și coduri de eroare:
1). fără acces - ca răspuns la orice solicitare se retrimite eroarea (403 Forbidden);
2). numai citire - solicitările GET au succes (200 OK); solicitările POST retrimit eroarea (403 Forbidden);
3). citire și scriere - atât GET, cât și POST au succes (200 OK).
În cazul în care token-ul a expirat, va fi retrimis codul de eroare 401 (401 Not Authenticated).

Ce puteți face cu token-ul creat:

1. Vizualizare. Făcând click pe acesta se va deschide o fereastră derulată cu un token care poate fi copiat (tokenul va fi salvat în clipboard).
2. Editare. Atunci când faceți click, se deschide o fereastră derulantă cu câmpuri care pot fi editate. Toate câmpurile sunt editabile, iar modificările sunt aplicate online după salvarea modificărilor. Puteți modifica denumirea, data expirării (nu mai mult de 1 an de la data curentă a modificărilor), drepturile de acces.
3. Ștergere. Tokenul poate fi șters, dar rețineți că ștergerea unui token este irevocabilă. Imediat ce confirmați acțiunea de ștergere, tokenul nu va mai apărea în cont. Iar atunci când încercați să obțineți date cu un astfel de token, se va afișa eroarea 401 Not Authenticated.

Notificare de dezactivare

Cu 30 și respectiv 7 zile înainte de dezactivarea tokenului, se trimite o notificare privind expirarea apropiată a tokenului către contul companiei și este trimis un mesaj de tip push.

Pentru a continua să lucrați cu api, reînnoiți data de expirare a token-ului sau creați unul nou.

Lucrăm constant la îmbunătățirea marketplace-ului și am dori să auzim părerea dvs. Vă rugăm să răspundeți la 4 întrebări despre experiența dvs. pe Vendigo.ro.