MedServLink API

Register a new user. Returns a JWT Token on success.

{
  "username": "engineer01",
  "password": "pass123",
  "role": "engineer",
  "name": "Engineer Zhang"
}

role: admin | manufacturer | engineer | hospital

Response 201:

{
  "access_token": "eyJhbG...",
  "user": {
    "id": "uuid",
    "username": "engineer01",
    "role": "engineer",
    "name": "Engineer Zhang"
  }
}

User login. Returns a JWT Token. Token is valid for 7 days.

{
  "username": "admin",
  "password": "admin123"
}

Response 200 / 401

Get the current logged-in user's information.

Headers: Authorization: Bearer <token>

{
  "id": "uuid",
  "username": "admin",
  "role": "admin",
  "name": "Andrew",
  "email": null,
  "phone": null,
  "company": null,
  "active": true,
  "createdAt": "2026-08-06T..."
}

Get a list of all users.

Get details of a single user.

Create a new user. Note: The password is not bcrypt-hashed (calls UsersService directly). It is recommended to create users via /api/auth/register instead.

Update user information.

Delete a user.

Get a list of all devices.

Register a new device.

{
  "name": "Non-contact Tonometer",
  "model": "TX-20",
  "category": "Ophthalmology - Tonometer",
  "manufacturerId": "uuid",
  "serialNumber": "SN-2026-001",
  "status": "active"
}

Get a list of orders. Optional ?status=xxx filter.

{
  "title": "Tonometer Calibration Fault",
  "description": "Device displays E02 error code...",
  "deviceCategory": "Ophthalmology - Tonometer",
  "deviceModel": "TX-20",
  "manufacturerId": "uuid",
  "engineerId": "uuid",
  "priority": "medium",
  "status": "pending"
}

status: pending → accepted → in_progress → completed | cancelled

priority: low | medium | high | urgent

{
  "orderId": "uuid",
  "manufacturerUserId": "uuid",
  "engineerUserId": "uuid",
  "trtcRoomId": "room-123",
  "notes": "Tonometer mainboard troubleshooting"
}

Generate a TRTC UserSig for the client to enter an audio/video room.

{
  "userId": "engineer-01"
}

{
  "sdkAppId": 1600155894,
  "userId": "engineer-01",
  "userSig": "eJwt..."
}

SDKAppID: 1600155894. UserSig is valid for 7 days by default.