API Reference
Comprehensively document our REST API endpoints, request formats, authentication mechanisms, and response structures for seamless integration.
🔐 Authentication
All API requests require an API key sent in the headers.
Authorization: Bearer YOUR_API_KEY
📡 Base URL
All API requests should be made to the following endpoint:
https://api.egthisas.com/v1
📡 Available Endpoints
| Method | Endpoint | Description | Parameters |
|---|---|---|---|
| POST | /auth/token | Generate new access token | { "clientId": "string", "clientSecret": "string" } |
| GET | /users/me | Get currently authenticated user info | None |
| POST | /data | Submit secure data | { "payload": "string", "metadata": "object" } |
🎯 Example Request
Post Data
POST
https://api.egthisas.com/v1/data
Headers:
Authorization: Bearer YOUR_API_KEY
Content-Type: application/json
Body:
{
"payload": "encrypted-message",
"metadata": {
"category": "secure"
}
}
201 Created
Response:
{
"id": "abc123",
"status": "success",
"timestamp": "2025-09-20T14:30:00Z"
}
❌ Error Responses
Errors return standard HTTP status codes and include details in JSON format:
401 Unauthorized
Response:
{
"error": "Invalid API key",
"code": 401
}
422 Unprocessable Entity
Response:
{
"error": "Invalid request format",
"code": 422,
"details": [
{
"field": "payload",
"message": "Must be Base64 encoded"
}
]
}