Documentație API

Modulul API din SmartCRM îți permite să integrezi sistemul cu alte aplicații externe prin generarea de chei API. Aceste chei API sunt necesare pentru a securiza și controla accesul aplicațiilor externe la datele din SmartCRM.

Crearea unei Chei API

Pentru a genera o cheie API, urmează pașii de mai jos:

Accesează Profilul Utilizatorului:

Din meniul principal, mergi la Profil Utilizator.

Setări API:

În profilul utilizatorului, selectează secțiunea Setări API.

Adaugă o Cheie API Nouă:

Apasă pe Adaugă Cheie API pentru a iniția procesul de generare a unei chei.

Completează Numele Cheii:

În câmpul dedicat, introdu un nume pentru cheie, care să reflecte utilizarea sau integrarea pentru care este creată.

Vizualizează și Salvează Token-ul:

După adăugarea cheii, token-ul generat va fi afișat pe ecran.
Atenție: Token-ul este vizibil o singură dată în momentul creării. Asigură-te că îl salvezi într-un loc sigur, deoarece nu va mai fi afișat ulterior.

Autorizarea request-urilor

Pentru a securiza accesul la API-ul SmartCRM, toate requesturile către endpointuri necesită un token de autorizare. Acest token trebuie inclus în headerul requestului sub forma Authorization: Bearer.

Cum se Utilizează Token-ul pentru Autorizare:

Include Token-ul în Header:

Pentru fiecare request către API, adaugă headerul Authorization cu valoarea Bearer, urmat de token-ul generat.

CODE

curl -X 'GET' \
  'https://API_URL' \
  -H 'accept: application/json' \
  -H 'Authorization: Bearer TOKEN'

API_URL - se obține din secțiunea Setări API din Profilul meu

Concluzie

Autorizarea prin token Bearer asigură că doar cererile autentificate vor putea accesa datele din SmartCRM, menținând astfel un nivel ridicat de securitate pentru API. Asigură-te că token-ul este păstrat în siguranță și nu este dezvăluit neautorizat.