💓 Health & Monitoring
🔓 No Auth Required
GET
/ping
Liveness probe
▼
Fast liveness check for load balancers and orchestrators.
GET
/health
Detailed subsystem health
▼
Reports status of SOMS API, token storage, configuration, and rate limiting.
GET
/api/soms/test
SOMS connectivity test
▼
Verifies outbound connectivity to the RealTime-SOMS API.
🔑 Authentication
🔓 No Auth Required
POST
/api/token
Exchange credentials for bearer token
▼
Validates UserClientID and UserClientSecret against the APIConfiguration table.
Returns a signed + encrypted JWT (AES-256-KW / AES-128-CBC-HMAC-SHA256) valid for 60 minutes.
Use the Authenticate panel on the left — it fills in your token automatically.
👥 Subjects
🔒 Bearer Token Required
GET
/api/subjects
Search subjects
🔒
▼
⚠️ Authenticate first to enable this request.
Search SOMS subject records. At least one search field is recommended.
GET
/api/subjects/{subjectId}
Get subject by ID
🔒
▼
⚠️ Authenticate first to enable this request.
POST
/api/subjects
Create subject
🔒
▼
⚠️ Authenticate first to enable this request.
PUT
/api/subjects/{subjectId}
Update subject
🔒
▼
⚠️ Authenticate first to enable this request.
POST
/api/subjects/{subjectId}/studies
Add study to subject
🔒
▼
⚠️ Authenticate first to enable this request.