435889ee79
- 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>
106 lines
2.3 KiB
Markdown
106 lines
2.3 KiB
Markdown
# 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.
|
|
|
|
```http
|
|
Authorization: Bearer <access_token>
|
|
```
|
|
|
|
Obtain tokens through the authentication endpoint. See [Authentication](/developers/authentication) for details.
|
|
|
|
## Request Format
|
|
|
|
```http
|
|
POST /applications HTTP/1.1
|
|
Host: api.tlas.gov.in
|
|
Authorization: Bearer eyJhbGc...
|
|
Content-Type: application/json
|
|
|
|
```
|
|
|
|
## Response Format
|
|
|
|
### Success Response
|
|
|
|
```json
|
|
{
|
|
"success": true,
|
|
"data": {
|
|
"id": "APP-2026-00001",
|
|
"status": "SUBMITTED"
|
|
}
|
|
}
|
|
```
|
|
|
|
### Error Response
|
|
|
|
```json
|
|
{
|
|
"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:
|
|
```http
|
|
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](/developers/authentication) - Token management
|
|
- [Core APIs](/developers/core-apis) - Application and document APIs
|
|
- [Blockchain APIs](/developers/blockchain-apis) - Certificate verification
|
|
- [Webhooks](/developers/webhooks) - Event notifications
|
|
- [Error Handling](/developers/errors) - Error codes and handling
|