API pentru Dezvoltatori
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ă
https://www.appssm.ro/api/Toate request-urile se fac către acest URL de bază, urmat de versiunea și endpoint-ul dorit (ex: /v1/contacts).
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/{id} | Preluare contact după ID |
POST | /v1/contacts | Creare contact nou |
PATCH | /v1/contacts/update | Modificare contact existent |
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 |