Getting Started

This guide will help you get started with the Smart City TVMS API.

Base URL

All API requests should be made to:

https://api.itms.solutions/trpc

Request Format

The API uses tRPC with superjson transformer. All requests follow the tRPC convention:

Query (GET)

GET /trpc/{procedure}?input={encodedJson}

Mutation (POST)

POST /trpc/{procedure}
Content-Type: application/json

{ "json": { ...data } }

Authentication

Most endpoints require authentication via Bearer token:

curl -X GET "https://api.itms.solutions/trpc/auth.me" \
  -H "Authorization: Bearer YOUR_JWT_TOKEN"

Quick Start

1. Login to get a token

curl -X POST "https://api.itms.solutions/trpc/auth.login" \
  -H "Content-Type: application/json" \
  -d '{"json":{"email":"admin@itms.solutions","password":"Admin@123"}}'

Response:

{
  "result": {
    "data": {
      "json": {
        "token": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9...",
        "user": {
          "id": "admin-001",
          "email": "admin@itms.solutions",
          "firstName": "System",
          "lastName": "Administrator",
          "role": "ADMIN"
        }
      }
    }
  }
}

2. Use the token for authenticated requests

curl -X GET "https://api.itms.solutions/trpc/sensors.getAllSensors" \
  -H "Authorization: Bearer YOUR_JWT_TOKEN"

Error Handling

Errors follow the tRPC error format:

{
  "error": {
    "json": {
      "message": "Error message",
      "code": -32001,
      "data": {
        "code": "UNAUTHORIZED",
        "httpStatus": 401
      }
    }
  }
}

Common Error Codes

Code	HTTP Status	Description
-32001	401	Unauthorized - Invalid or missing token
-32004	404	Not Found - Resource doesn't exist
-32600	400	Bad Request - Invalid input
-32603	500	Internal Server Error