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
All requests are made to your installation's base URL, followed by the version and the endpoint
(e.g. /v1/contacts). The base URL depends on the
deployment model:
| Model | Base URL |
|---|---|
| Shared Model (SaaS) | https://www.appssm.ro/api/ |
| Enterprise Model (Dedicated) | https://<installation-domain>/api/, provided at implementation time |
www.appssm.ro is the Shared Model domain
Calls sent to www.appssm.ro do not reach an Enterprise (Dedicated) installation. Keep the base
URL in a configuration variable rather than hard-coded in the source.
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 — see also Encoding |
Encoding (UTF-8)
The body of POST / PATCH requests must be sent as UTF-8 JSON, without a BOM
(Content-Type: application/json; charset=utf-8). A body that cannot be read as valid JSON
returns 400 or 500, without a validation message. Possible causes:
Content-Lengthset manually from the number of characters instead of bytes (truncated body)- an encoding other than UTF-8 (e.g. Windows-1250, Latin-1)
- a BOM at the start of the body