Files

Mahi 435889ee79 docs: Rebuild documentation as enterprise-grade TLAS platform

- Migrate from custom HTTP server to VitePress framework
- Rename project to Tokenized License Approval System (TLAS)
- Add comprehensive documentation for all stakeholders:
  - Business: Executive summary, value proposition, governance
  - Operations: Infrastructure, installation, monitoring, backup
  - Departments: User guide, workflows, verification, issuance
  - Developers: API reference, authentication, webhooks, SDKs
  - Compliance: OWASP, DPDP Act, IT Act, audit framework
- Add modern theme with dark mode and full-text search
- Update Dockerfile for VitePress build process

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>

2026-02-10 00:05:20 -04:00

2.3 KiB

Raw Blame History

API Documentation

Overview

TLAS provides REST APIs for integrating with external systems. All APIs use JSON for request and response bodies.

Base URL

Production: https://api.tlas.gov.in/v1
Staging:    https://api-staging.tlas.gov.in/v1

Authentication

All API requests require authentication via Bearer token.

Authorization: Bearer <access_token>

Obtain tokens through the authentication endpoint. See Authentication for details.

Request Format

POST /applications HTTP/1.1
Host: api.tlas.gov.in
Authorization: Bearer eyJhbGc...
Content-Type: application/json

{
  "licenseType": "TRADE_LICENSE",
  "applicantId": "12345",
  "data": { ... }
}

Response Format

Success Response

{
  "success": true,
  "data": {
    "id": "APP-2026-00001",
    "status": "SUBMITTED"
  }
}

Error Response

{
  "success": false,
  "error": {
    "code": "VALIDATION_ERROR",
    "message": "Invalid license type",
    "details": [
      { "field": "licenseType", "message": "Must be one of: TRADE_LICENSE, FOOD_LICENSE" }
    ]
  }
}

Rate Limits

Tier	Requests/minute	Burst
Standard	60	100
Premium	300	500

Rate limit headers included in all responses:

X-RateLimit-Limit: 60
X-RateLimit-Remaining: 45
X-RateLimit-Reset: 1707500000

API Endpoints

Category	Endpoint	Description
Auth	`POST /auth/token`	Obtain access token
Applications	`POST /applications`	Submit new application
Applications	`GET /applications/:id`	Get application status
Documents	`POST /documents/upload`	Upload document
Verification	`GET /verify/:tokenId`	Verify certificate

SDKs

Official SDKs available:

JavaScript/TypeScript: npm install @tlas/sdk
Python: pip install tlas-sdk
Java: Maven artifact gov.in.tlas:tlas-sdk

Documentation

Authentication - Token management
Core APIs - Application and document APIs
Blockchain APIs - Certificate verification
Webhooks - Event notifications
Error Handling - Error codes and handling

2.3 KiB Raw Blame History