API ssm.ro
Prezentare generală a API-ului ssm.ro — URL de bază, autentificare și endpoint-uri disponibile.
API-ul ssm.ro permite integrarea platformei cu sisteme externe de HR, ERP sau orice altă aplicație care gestionează angajați și documente.
URL de bază
Toate request-urile se fac către URL-ul de bază al instalării tale, urmat de versiune și de endpoint
(ex: /v1/contacts). URL-ul de bază diferă în funcție de
modelul de deployment:
| Model | URL de bază |
|---|---|
| Model Partajat (SaaS) | https://www.appssm.ro/api/ |
| Model Enterprise (Dedicat) | https://<domeniul-instalarii>/api/, comunicat la implementare |
www.appssm.ro este domeniul Modelului Partajat
Apelurile trimise către www.appssm.ro nu ajung la o instalare Enterprise (Dedicat). Păstrează
URL-ul de bază într-o variabilă de configurare, nu codat în sursă.
Autentificare
API-ul folosește autentificare prin token Bearer:
Authorization: Bearer {token}Tokenul trebuie inclus în headerul Authorization pentru toate request-urile. Contactați suport@ssm.ro pentru obținerea unui token de acces.
Endpoint-uri disponibile
| Metodă | Endpoint | Descriere |
|---|---|---|
GET | /v1?organizatie= | Verificare status conexiune |
GET | /v1/contacts?organizatie=&marca= | Preluare contact după marcă |
POST | /v1/contacts | Creare contact nou |
PATCH | /v1/contacts/update | Modificare contact existent |
POST | /v1/contacts/rfid | Asociere card RFID la contact |
GET | /v1/reports/{id} | Preluare raport |
Coduri de răspuns
| Cod | Semnificație |
|---|---|
200 | Succes |
204 | Succes — nicio modificare efectuată |
400 | Request invalid |
401 | Neautorizat — token lipsă sau invalid |
404 | Resursa nu a fost găsită |
422 | Operațiune imposibil de efectuat — răspuns JSON cu detalii |
500 | Eroare server — vezi și Encoding |
Encoding (UTF-8)
Body-ul request-urilor POST / PATCH trebuie trimis ca JSON codat UTF-8, fără BOM
(Content-Type: application/json; charset=utf-8). Un body care nu poate fi citit ca JSON valid
întoarce 400 sau 500, fără mesaj de validare. Cauze posibile:
Content-Lengthsetat manual din numărul de caractere, nu de bytes (body trunchiat)- alt encoding decât UTF-8 (ex: Windows-1250, Latin-1)
- BOM la începutul body-ului