API for Developers
ssm.ro API
Overview of the ssm.ro API — base URL, authentication, and available endpoints.
The ssm.ro API allows the platform to be integrated with external HR systems, ERP systems, or any other application that manages employees and documents.
Base URL
https://www.appssm.ro/api/All requests are made to this base URL, followed by the desired version and endpoint (e.g., /v1/contacts).
Authentication
The API uses Bearer token authentication:
Authorization: Bearer {token}The token must be included in the Authorization header for all requests. Contact suport@ssm.ro to obtain an access token.
Available endpoints
| Method | Endpoint | Description |
|---|---|---|
GET | /v1?organizatie= | Check connection status |
GET | /v1/contacts?organizatie=&marca= | Retrieve contact by badge number |
POST | /v1/contacts | Create new contact |
PATCH | /v1/contacts/update | Update existing contact |
POST | /v1/contacts/rfid | Associate RFID card with contact |
GET | /v1/reports/{id} | Retrieve report |
Response codes
| Code | Meaning |
|---|---|
200 | Success |
204 | Success — no changes made |
400 | Invalid request |
401 | Unauthorized — missing or invalid token |
404 | Resource not found |
422 | Operation could not be performed — JSON response with details |
500 | Server error |