2025-12-17 11:08:04 +07:00
|
|
|
{
|
|
|
|
|
"openapi": "3.0.0",
|
|
|
|
|
"info": {
|
|
|
|
|
"title": "API Retribusi",
|
2025-12-18 11:13:06 +07:00
|
|
|
"description": "API Retribusi BAPENDA Kabupaten Garut untuk monitoring Retribusi",
|
2025-12-17 11:08:04 +07:00
|
|
|
"version": "1.0.0",
|
|
|
|
|
"contact": {
|
|
|
|
|
"name": "BTekno Development Team"
|
|
|
|
|
}
|
|
|
|
|
},
|
|
|
|
|
"servers": [
|
|
|
|
|
{
|
|
|
|
|
"url": "https://api.btekno.cloud",
|
|
|
|
|
"description": "Production Server"
|
|
|
|
|
},
|
|
|
|
|
{
|
|
|
|
|
"url": "http://localhost",
|
|
|
|
|
"description": "Local Development"
|
|
|
|
|
}
|
|
|
|
|
],
|
|
|
|
|
"tags": [
|
|
|
|
|
{
|
|
|
|
|
"name": "Health",
|
|
|
|
|
"description": "Health check endpoint"
|
|
|
|
|
},
|
|
|
|
|
{
|
|
|
|
|
"name": "Authentication",
|
|
|
|
|
"description": "JWT authentication"
|
|
|
|
|
},
|
|
|
|
|
{
|
|
|
|
|
"name": "Ingest",
|
|
|
|
|
"description": "Event ingestion (mesin YOLO)"
|
|
|
|
|
},
|
|
|
|
|
{
|
|
|
|
|
"name": "Frontend",
|
|
|
|
|
"description": "Frontend CRUD operations"
|
|
|
|
|
},
|
|
|
|
|
{
|
|
|
|
|
"name": "Summary",
|
|
|
|
|
"description": "Data summary & aggregation"
|
|
|
|
|
},
|
|
|
|
|
{
|
|
|
|
|
"name": "Dashboard",
|
|
|
|
|
"description": "Dashboard visualization data"
|
|
|
|
|
},
|
|
|
|
|
{
|
|
|
|
|
"name": "Realtime",
|
|
|
|
|
"description": "Real-time events (SSE)"
|
|
|
|
|
}
|
|
|
|
|
],
|
|
|
|
|
"components": {
|
|
|
|
|
"securitySchemes": {
|
|
|
|
|
"BearerAuth": {
|
|
|
|
|
"type": "http",
|
|
|
|
|
"scheme": "bearer",
|
|
|
|
|
"bearerFormat": "JWT",
|
|
|
|
|
"description": "JWT token untuk frontend API"
|
|
|
|
|
},
|
|
|
|
|
"ApiKeyAuth": {
|
|
|
|
|
"type": "apiKey",
|
|
|
|
|
"in": "header",
|
|
|
|
|
"name": "X-API-KEY",
|
|
|
|
|
"description": "API Key untuk ingest endpoint"
|
|
|
|
|
}
|
|
|
|
|
},
|
|
|
|
|
"schemas": {
|
|
|
|
|
"Error": {
|
|
|
|
|
"type": "object",
|
|
|
|
|
"properties": {
|
|
|
|
|
"error": {
|
|
|
|
|
"type": "string",
|
|
|
|
|
"description": "Error code"
|
|
|
|
|
},
|
|
|
|
|
"message": {
|
|
|
|
|
"type": "string",
|
|
|
|
|
"description": "Error message"
|
|
|
|
|
},
|
|
|
|
|
"fields": {
|
|
|
|
|
"type": "object",
|
|
|
|
|
"description": "Validation errors (optional)"
|
|
|
|
|
}
|
|
|
|
|
}
|
|
|
|
|
},
|
|
|
|
|
"Success": {
|
|
|
|
|
"type": "object",
|
|
|
|
|
"properties": {
|
|
|
|
|
"success": {
|
|
|
|
|
"type": "boolean",
|
|
|
|
|
"example": true
|
|
|
|
|
},
|
|
|
|
|
"data": {
|
|
|
|
|
"type": "object"
|
|
|
|
|
},
|
|
|
|
|
"timestamp": {
|
|
|
|
|
"type": "integer",
|
|
|
|
|
"description": "Unix timestamp"
|
|
|
|
|
}
|
|
|
|
|
}
|
|
|
|
|
}
|
|
|
|
|
}
|
|
|
|
|
},
|
|
|
|
|
"paths": {
|
|
|
|
|
"/health": {
|
|
|
|
|
"get": {
|
|
|
|
|
"tags": ["Health"],
|
|
|
|
|
"summary": "Health check",
|
|
|
|
|
"description": "Check API health status",
|
|
|
|
|
"responses": {
|
|
|
|
|
"200": {
|
|
|
|
|
"description": "API is healthy",
|
|
|
|
|
"content": {
|
|
|
|
|
"application/json": {
|
|
|
|
|
"schema": {
|
|
|
|
|
"type": "object",
|
|
|
|
|
"properties": {
|
|
|
|
|
"status": {
|
|
|
|
|
"type": "string",
|
|
|
|
|
"example": "ok"
|
|
|
|
|
},
|
|
|
|
|
"time": {
|
|
|
|
|
"type": "integer",
|
|
|
|
|
"example": 1735123456
|
|
|
|
|
}
|
|
|
|
|
}
|
|
|
|
|
}
|
|
|
|
|
}
|
|
|
|
|
}
|
|
|
|
|
}
|
|
|
|
|
}
|
|
|
|
|
}
|
|
|
|
|
},
|
|
|
|
|
"/auth/v1/login": {
|
|
|
|
|
"post": {
|
|
|
|
|
"tags": ["Authentication"],
|
|
|
|
|
"summary": "Login",
|
|
|
|
|
"description": "Authenticate user dan dapatkan JWT token",
|
|
|
|
|
"requestBody": {
|
|
|
|
|
"required": true,
|
|
|
|
|
"content": {
|
|
|
|
|
"application/json": {
|
|
|
|
|
"schema": {
|
|
|
|
|
"type": "object",
|
|
|
|
|
"required": ["username", "password"],
|
|
|
|
|
"properties": {
|
|
|
|
|
"username": {
|
|
|
|
|
"type": "string",
|
|
|
|
|
"example": "admin"
|
|
|
|
|
},
|
|
|
|
|
"password": {
|
|
|
|
|
"type": "string",
|
|
|
|
|
"format": "password",
|
|
|
|
|
"example": "password123"
|
|
|
|
|
}
|
|
|
|
|
}
|
|
|
|
|
}
|
|
|
|
|
}
|
|
|
|
|
}
|
|
|
|
|
},
|
|
|
|
|
"responses": {
|
|
|
|
|
"200": {
|
|
|
|
|
"description": "Login successful",
|
|
|
|
|
"content": {
|
|
|
|
|
"application/json": {
|
|
|
|
|
"schema": {
|
|
|
|
|
"allOf": [
|
|
|
|
|
{"$ref": "#/components/schemas/Success"},
|
|
|
|
|
{
|
|
|
|
|
"type": "object",
|
|
|
|
|
"properties": {
|
|
|
|
|
"data": {
|
|
|
|
|
"type": "object",
|
|
|
|
|
"properties": {
|
|
|
|
|
"token": {
|
|
|
|
|
"type": "string"
|
|
|
|
|
},
|
|
|
|
|
"expires_in": {
|
|
|
|
|
"type": "integer"
|
|
|
|
|
},
|
|
|
|
|
"user": {
|
|
|
|
|
"type": "object",
|
|
|
|
|
"properties": {
|
|
|
|
|
"id": {"type": "integer"},
|
|
|
|
|
"username": {"type": "string"},
|
|
|
|
|
"role": {"type": "string"}
|
|
|
|
|
}
|
|
|
|
|
}
|
|
|
|
|
}
|
|
|
|
|
}
|
|
|
|
|
}
|
|
|
|
|
}
|
|
|
|
|
]
|
|
|
|
|
}
|
|
|
|
|
}
|
|
|
|
|
}
|
|
|
|
|
},
|
|
|
|
|
"401": {
|
|
|
|
|
"description": "Unauthorized",
|
|
|
|
|
"content": {
|
|
|
|
|
"application/json": {
|
|
|
|
|
"schema": {
|
|
|
|
|
"$ref": "#/components/schemas/Error"
|
|
|
|
|
}
|
|
|
|
|
}
|
|
|
|
|
}
|
|
|
|
|
},
|
|
|
|
|
"403": {
|
|
|
|
|
"description": "Forbidden (user inactive)",
|
|
|
|
|
"content": {
|
|
|
|
|
"application/json": {
|
|
|
|
|
"schema": {
|
|
|
|
|
"$ref": "#/components/schemas/Error"
|
|
|
|
|
}
|
|
|
|
|
}
|
|
|
|
|
}
|
|
|
|
|
}
|
|
|
|
|
}
|
|
|
|
|
}
|
|
|
|
|
},
|
|
|
|
|
"/retribusi/v1/ingest": {
|
|
|
|
|
"post": {
|
|
|
|
|
"tags": ["Ingest"],
|
|
|
|
|
"summary": "Ingest event data",
|
|
|
|
|
"description": "Masukkan event data dari mesin YOLO",
|
|
|
|
|
"security": [
|
|
|
|
|
{
|
|
|
|
|
"ApiKeyAuth": []
|
|
|
|
|
}
|
|
|
|
|
],
|
|
|
|
|
"requestBody": {
|
|
|
|
|
"required": true,
|
|
|
|
|
"content": {
|
|
|
|
|
"application/json": {
|
|
|
|
|
"schema": {
|
|
|
|
|
"type": "object",
|
|
|
|
|
"required": ["timestamp", "location_code", "gate_code", "category"],
|
|
|
|
|
"properties": {
|
|
|
|
|
"timestamp": {
|
|
|
|
|
"type": "integer",
|
|
|
|
|
"description": "Unix timestamp",
|
|
|
|
|
"example": 1735123456
|
|
|
|
|
},
|
|
|
|
|
"location_code": {
|
|
|
|
|
"type": "string",
|
|
|
|
|
"example": "kerkof_01"
|
|
|
|
|
},
|
|
|
|
|
"gate_code": {
|
|
|
|
|
"type": "string",
|
|
|
|
|
"example": "gate01"
|
|
|
|
|
},
|
|
|
|
|
"category": {
|
|
|
|
|
"type": "string",
|
|
|
|
|
"example": "motor"
|
|
|
|
|
}
|
|
|
|
|
}
|
|
|
|
|
}
|
|
|
|
|
}
|
|
|
|
|
}
|
|
|
|
|
},
|
|
|
|
|
"responses": {
|
|
|
|
|
"200": {
|
|
|
|
|
"description": "Event stored successfully",
|
|
|
|
|
"content": {
|
|
|
|
|
"application/json": {
|
|
|
|
|
"schema": {
|
|
|
|
|
"$ref": "#/components/schemas/Success"
|
|
|
|
|
}
|
|
|
|
|
}
|
|
|
|
|
}
|
|
|
|
|
},
|
|
|
|
|
"401": {
|
|
|
|
|
"description": "Unauthorized (invalid API key)",
|
|
|
|
|
"content": {
|
|
|
|
|
"application/json": {
|
|
|
|
|
"schema": {
|
|
|
|
|
"$ref": "#/components/schemas/Error"
|
|
|
|
|
}
|
|
|
|
|
}
|
|
|
|
|
}
|
|
|
|
|
},
|
|
|
|
|
"404": {
|
|
|
|
|
"description": "Not found (location/gate/tariff not found)",
|
|
|
|
|
"content": {
|
|
|
|
|
"application/json": {
|
|
|
|
|
"schema": {
|
|
|
|
|
"$ref": "#/components/schemas/Error"
|
|
|
|
|
}
|
|
|
|
|
}
|
|
|
|
|
}
|
|
|
|
|
},
|
|
|
|
|
"422": {
|
|
|
|
|
"description": "Validation error",
|
|
|
|
|
"content": {
|
|
|
|
|
"application/json": {
|
|
|
|
|
"schema": {
|
|
|
|
|
"$ref": "#/components/schemas/Error"
|
|
|
|
|
}
|
|
|
|
|
}
|
|
|
|
|
}
|
|
|
|
|
}
|
|
|
|
|
}
|
|
|
|
|
}
|
|
|
|
|
},
|
|
|
|
|
"/retribusi/v1/frontend/locations": {
|
|
|
|
|
"get": {
|
|
|
|
|
"tags": ["Frontend"],
|
|
|
|
|
"summary": "Get locations list",
|
|
|
|
|
"description": "Mendapatkan daftar lokasi dengan pagination",
|
|
|
|
|
"security": [
|
|
|
|
|
{
|
|
|
|
|
"BearerAuth": []
|
|
|
|
|
}
|
|
|
|
|
],
|
|
|
|
|
"parameters": [
|
|
|
|
|
{
|
|
|
|
|
"name": "page",
|
|
|
|
|
"in": "query",
|
|
|
|
|
"schema": {
|
|
|
|
|
"type": "integer",
|
|
|
|
|
"default": 1,
|
|
|
|
|
"minimum": 1
|
|
|
|
|
},
|
|
|
|
|
"description": "Page number"
|
|
|
|
|
},
|
|
|
|
|
{
|
|
|
|
|
"name": "limit",
|
|
|
|
|
"in": "query",
|
|
|
|
|
"schema": {
|
|
|
|
|
"type": "integer",
|
|
|
|
|
"default": 20,
|
|
|
|
|
"minimum": 1,
|
|
|
|
|
"maximum": 100
|
|
|
|
|
},
|
|
|
|
|
"description": "Items per page"
|
|
|
|
|
}
|
|
|
|
|
],
|
|
|
|
|
"responses": {
|
|
|
|
|
"200": {
|
|
|
|
|
"description": "Success",
|
|
|
|
|
"content": {
|
|
|
|
|
"application/json": {
|
|
|
|
|
"schema": {
|
|
|
|
|
"$ref": "#/components/schemas/Success"
|
|
|
|
|
}
|
|
|
|
|
}
|
|
|
|
|
}
|
|
|
|
|
},
|
|
|
|
|
"401": {
|
|
|
|
|
"description": "Unauthorized",
|
|
|
|
|
"content": {
|
|
|
|
|
"application/json": {
|
|
|
|
|
"schema": {
|
|
|
|
|
"$ref": "#/components/schemas/Error"
|
|
|
|
|
}
|
|
|
|
|
}
|
|
|
|
|
}
|
|
|
|
|
}
|
|
|
|
|
}
|
|
|
|
|
},
|
|
|
|
|
"post": {
|
|
|
|
|
"tags": ["Frontend"],
|
|
|
|
|
"summary": "Create location",
|
|
|
|
|
"description": "Membuat lokasi baru (operator/admin only)",
|
|
|
|
|
"security": [
|
|
|
|
|
{
|
|
|
|
|
"BearerAuth": []
|
|
|
|
|
}
|
|
|
|
|
],
|
|
|
|
|
"requestBody": {
|
|
|
|
|
"required": true,
|
|
|
|
|
"content": {
|
|
|
|
|
"application/json": {
|
|
|
|
|
"schema": {
|
|
|
|
|
"type": "object",
|
|
|
|
|
"required": ["code", "name", "type", "is_active"],
|
|
|
|
|
"properties": {
|
|
|
|
|
"code": {
|
|
|
|
|
"type": "string",
|
|
|
|
|
"example": "kerkof_01"
|
|
|
|
|
},
|
|
|
|
|
"name": {
|
|
|
|
|
"type": "string",
|
|
|
|
|
"example": "Kerkof Garut"
|
|
|
|
|
},
|
|
|
|
|
"type": {
|
|
|
|
|
"type": "string",
|
|
|
|
|
"example": "parkir"
|
|
|
|
|
},
|
|
|
|
|
"is_active": {
|
|
|
|
|
"type": "integer",
|
|
|
|
|
"enum": [0, 1],
|
|
|
|
|
"example": 1
|
|
|
|
|
}
|
|
|
|
|
}
|
|
|
|
|
}
|
|
|
|
|
}
|
|
|
|
|
}
|
|
|
|
|
},
|
|
|
|
|
"responses": {
|
|
|
|
|
"201": {
|
|
|
|
|
"description": "Location created",
|
|
|
|
|
"content": {
|
|
|
|
|
"application/json": {
|
|
|
|
|
"schema": {
|
|
|
|
|
"$ref": "#/components/schemas/Success"
|
|
|
|
|
}
|
|
|
|
|
}
|
|
|
|
|
}
|
|
|
|
|
},
|
|
|
|
|
"401": {
|
|
|
|
|
"description": "Unauthorized",
|
|
|
|
|
"content": {
|
|
|
|
|
"application/json": {
|
|
|
|
|
"schema": {
|
|
|
|
|
"$ref": "#/components/schemas/Error"
|
|
|
|
|
}
|
|
|
|
|
}
|
|
|
|
|
}
|
|
|
|
|
},
|
|
|
|
|
"403": {
|
|
|
|
|
"description": "Forbidden (insufficient permissions)",
|
|
|
|
|
"content": {
|
|
|
|
|
"application/json": {
|
|
|
|
|
"schema": {
|
|
|
|
|
"$ref": "#/components/schemas/Error"
|
|
|
|
|
}
|
|
|
|
|
}
|
|
|
|
|
}
|
|
|
|
|
},
|
|
|
|
|
"409": {
|
|
|
|
|
"description": "Conflict (code already exists)",
|
|
|
|
|
"content": {
|
|
|
|
|
"application/json": {
|
|
|
|
|
"schema": {
|
|
|
|
|
"$ref": "#/components/schemas/Error"
|
|
|
|
|
}
|
|
|
|
|
}
|
|
|
|
|
}
|
|
|
|
|
}
|
|
|
|
|
}
|
|
|
|
|
}
|
|
|
|
|
},
|
|
|
|
|
"/retribusi/v1/summary/daily": {
|
|
|
|
|
"get": {
|
|
|
|
|
"tags": ["Summary"],
|
|
|
|
|
"summary": "Get daily summary",
|
|
|
|
|
"description": "Mendapatkan rekap harian",
|
|
|
|
|
"security": [
|
|
|
|
|
{
|
|
|
|
|
"BearerAuth": []
|
|
|
|
|
}
|
|
|
|
|
],
|
|
|
|
|
"parameters": [
|
|
|
|
|
{
|
|
|
|
|
"name": "date",
|
|
|
|
|
"in": "query",
|
|
|
|
|
"required": true,
|
|
|
|
|
"schema": {
|
|
|
|
|
"type": "string",
|
|
|
|
|
"format": "date",
|
|
|
|
|
"example": "2025-01-01"
|
|
|
|
|
},
|
|
|
|
|
"description": "Date (Y-m-d format)"
|
|
|
|
|
},
|
|
|
|
|
{
|
|
|
|
|
"name": "location_code",
|
|
|
|
|
"in": "query",
|
|
|
|
|
"schema": {
|
|
|
|
|
"type": "string"
|
|
|
|
|
}
|
|
|
|
|
},
|
|
|
|
|
{
|
|
|
|
|
"name": "gate_code",
|
|
|
|
|
"in": "query",
|
|
|
|
|
"schema": {
|
|
|
|
|
"type": "string"
|
|
|
|
|
}
|
|
|
|
|
}
|
|
|
|
|
],
|
|
|
|
|
"responses": {
|
|
|
|
|
"200": {
|
|
|
|
|
"description": "Success",
|
|
|
|
|
"content": {
|
|
|
|
|
"application/json": {
|
|
|
|
|
"schema": {
|
|
|
|
|
"$ref": "#/components/schemas/Success"
|
|
|
|
|
}
|
|
|
|
|
}
|
|
|
|
|
}
|
|
|
|
|
}
|
|
|
|
|
}
|
|
|
|
|
}
|
|
|
|
|
},
|
docs: update OpenAPI spec dengan endpoint baru dan field camera - Tambah GET /locations/{code}, GET /gates/{location_code}/{gate_code}, GET /tariffs, GET /tariffs/{location_code}/{gate_code}/{category}, GET /audit-logs, GET /entry-events, GET /streams, GET /realtime/events, GET /realtime/snapshot, GET /summary/hourly, GET /dashboard/by-category, GET /dashboard/summary - Update field camera di gates (support HLS, RTSP, HTTP)
2025-12-18 06:46:03 +07:00
|
|
|
"/retribusi/v1/summary/hourly": {
|
|
|
|
|
"get": {
|
|
|
|
|
"tags": ["Summary"],
|
|
|
|
|
"summary": "Get hourly summary",
|
|
|
|
|
"description": "Mendapatkan rekap per jam untuk chart (24 jam)",
|
|
|
|
|
"security": [
|
|
|
|
|
{
|
|
|
|
|
"BearerAuth": []
|
|
|
|
|
}
|
|
|
|
|
],
|
|
|
|
|
"parameters": [
|
|
|
|
|
{
|
|
|
|
|
"name": "date",
|
|
|
|
|
"in": "query",
|
|
|
|
|
"required": true,
|
|
|
|
|
"schema": {
|
|
|
|
|
"type": "string",
|
|
|
|
|
"format": "date",
|
|
|
|
|
"example": "2025-01-01"
|
|
|
|
|
}
|
|
|
|
|
},
|
|
|
|
|
{
|
|
|
|
|
"name": "location_code",
|
|
|
|
|
"in": "query",
|
|
|
|
|
"schema": {
|
|
|
|
|
"type": "string"
|
|
|
|
|
}
|
|
|
|
|
},
|
|
|
|
|
{
|
|
|
|
|
"name": "gate_code",
|
|
|
|
|
"in": "query",
|
|
|
|
|
"schema": {
|
|
|
|
|
"type": "string"
|
|
|
|
|
}
|
|
|
|
|
}
|
|
|
|
|
],
|
|
|
|
|
"responses": {
|
|
|
|
|
"200": {
|
|
|
|
|
"description": "Success",
|
|
|
|
|
"content": {
|
|
|
|
|
"application/json": {
|
|
|
|
|
"schema": {
|
|
|
|
|
"$ref": "#/components/schemas/Success"
|
|
|
|
|
}
|
|
|
|
|
}
|
|
|
|
|
}
|
|
|
|
|
}
|
|
|
|
|
}
|
|
|
|
|
}
|
|
|
|
|
},
|
2025-12-17 11:08:04 +07:00
|
|
|
"/retribusi/v1/dashboard/daily": {
|
|
|
|
|
"get": {
|
|
|
|
|
"tags": ["Dashboard"],
|
|
|
|
|
"summary": "Get daily chart data",
|
|
|
|
|
"description": "Data untuk line chart harian",
|
|
|
|
|
"security": [
|
|
|
|
|
{
|
|
|
|
|
"BearerAuth": []
|
|
|
|
|
}
|
|
|
|
|
],
|
|
|
|
|
"parameters": [
|
|
|
|
|
{
|
|
|
|
|
"name": "start_date",
|
|
|
|
|
"in": "query",
|
|
|
|
|
"required": true,
|
|
|
|
|
"schema": {
|
|
|
|
|
"type": "string",
|
|
|
|
|
"format": "date"
|
|
|
|
|
}
|
|
|
|
|
},
|
|
|
|
|
{
|
|
|
|
|
"name": "end_date",
|
|
|
|
|
"in": "query",
|
|
|
|
|
"required": true,
|
|
|
|
|
"schema": {
|
|
|
|
|
"type": "string",
|
|
|
|
|
"format": "date"
|
|
|
|
|
}
|
|
|
|
|
},
|
|
|
|
|
{
|
|
|
|
|
"name": "location_code",
|
|
|
|
|
"in": "query",
|
|
|
|
|
"schema": {
|
|
|
|
|
"type": "string"
|
|
|
|
|
}
|
|
|
|
|
},
|
|
|
|
|
{
|
|
|
|
|
"name": "gate_code",
|
|
|
|
|
"in": "query",
|
|
|
|
|
"schema": {
|
|
|
|
|
"type": "string"
|
|
|
|
|
}
|
|
|
|
|
}
|
|
|
|
|
],
|
|
|
|
|
"responses": {
|
|
|
|
|
"200": {
|
|
|
|
|
"description": "Success",
|
|
|
|
|
"content": {
|
|
|
|
|
"application/json": {
|
|
|
|
|
"schema": {
|
|
|
|
|
"$ref": "#/components/schemas/Success"
|
|
|
|
|
}
|
|
|
|
|
}
|
|
|
|
|
}
|
|
|
|
|
}
|
|
|
|
|
}
|
|
|
|
|
}
|
|
|
|
|
},
|
docs: update OpenAPI spec dengan endpoint baru dan field camera - Tambah GET /locations/{code}, GET /gates/{location_code}/{gate_code}, GET /tariffs, GET /tariffs/{location_code}/{gate_code}/{category}, GET /audit-logs, GET /entry-events, GET /streams, GET /realtime/events, GET /realtime/snapshot, GET /summary/hourly, GET /dashboard/by-category, GET /dashboard/summary - Update field camera di gates (support HLS, RTSP, HTTP)
2025-12-18 06:46:03 +07:00
|
|
|
"/retribusi/v1/dashboard/by-category": {
|
|
|
|
|
"get": {
|
|
|
|
|
"tags": ["Dashboard"],
|
|
|
|
|
"summary": "Get by category chart data",
|
|
|
|
|
"description": "Data chart grouped by category (bar/donut chart)",
|
|
|
|
|
"security": [
|
|
|
|
|
{
|
|
|
|
|
"BearerAuth": []
|
|
|
|
|
}
|
|
|
|
|
],
|
|
|
|
|
"parameters": [
|
|
|
|
|
{
|
|
|
|
|
"name": "date",
|
|
|
|
|
"in": "query",
|
|
|
|
|
"required": true,
|
|
|
|
|
"schema": {
|
|
|
|
|
"type": "string",
|
|
|
|
|
"format": "date"
|
|
|
|
|
}
|
|
|
|
|
},
|
|
|
|
|
{
|
|
|
|
|
"name": "location_code",
|
|
|
|
|
"in": "query",
|
|
|
|
|
"schema": {
|
|
|
|
|
"type": "string"
|
|
|
|
|
}
|
|
|
|
|
},
|
|
|
|
|
{
|
|
|
|
|
"name": "gate_code",
|
|
|
|
|
"in": "query",
|
|
|
|
|
"schema": {
|
|
|
|
|
"type": "string"
|
|
|
|
|
}
|
|
|
|
|
}
|
|
|
|
|
],
|
|
|
|
|
"responses": {
|
|
|
|
|
"200": {
|
|
|
|
|
"description": "Success",
|
|
|
|
|
"content": {
|
|
|
|
|
"application/json": {
|
|
|
|
|
"schema": {
|
|
|
|
|
"$ref": "#/components/schemas/Success"
|
|
|
|
|
}
|
|
|
|
|
}
|
|
|
|
|
}
|
|
|
|
|
}
|
|
|
|
|
}
|
|
|
|
|
}
|
|
|
|
|
},
|
|
|
|
|
"/retribusi/v1/dashboard/summary": {
|
|
|
|
|
"get": {
|
|
|
|
|
"tags": ["Dashboard"],
|
|
|
|
|
"summary": "Get summary statistics",
|
|
|
|
|
"description": "Mendapatkan summary statistics (stat cards)",
|
|
|
|
|
"security": [
|
|
|
|
|
{
|
|
|
|
|
"BearerAuth": []
|
|
|
|
|
}
|
|
|
|
|
],
|
|
|
|
|
"parameters": [
|
|
|
|
|
{
|
|
|
|
|
"name": "date",
|
|
|
|
|
"in": "query",
|
|
|
|
|
"required": true,
|
|
|
|
|
"schema": {
|
|
|
|
|
"type": "string",
|
|
|
|
|
"format": "date"
|
|
|
|
|
}
|
|
|
|
|
},
|
|
|
|
|
{
|
|
|
|
|
"name": "location_code",
|
|
|
|
|
"in": "query",
|
|
|
|
|
"schema": {
|
|
|
|
|
"type": "string"
|
|
|
|
|
}
|
|
|
|
|
}
|
|
|
|
|
],
|
|
|
|
|
"responses": {
|
|
|
|
|
"200": {
|
|
|
|
|
"description": "Success",
|
|
|
|
|
"content": {
|
|
|
|
|
"application/json": {
|
|
|
|
|
"schema": {
|
|
|
|
|
"$ref": "#/components/schemas/Success"
|
|
|
|
|
}
|
|
|
|
|
}
|
|
|
|
|
}
|
|
|
|
|
}
|
|
|
|
|
}
|
|
|
|
|
}
|
|
|
|
|
},
|
2025-12-17 11:08:04 +07:00
|
|
|
"/retribusi/v1/realtime/stream": {
|
|
|
|
|
"get": {
|
|
|
|
|
"tags": ["Realtime"],
|
|
|
|
|
"summary": "SSE Stream",
|
|
|
|
|
"description": "Server-Sent Events stream untuk real-time updates",
|
|
|
|
|
"security": [
|
|
|
|
|
{
|
|
|
|
|
"BearerAuth": []
|
|
|
|
|
}
|
|
|
|
|
],
|
|
|
|
|
"parameters": [
|
|
|
|
|
{
|
|
|
|
|
"name": "last_id",
|
|
|
|
|
"in": "query",
|
|
|
|
|
"schema": {
|
|
|
|
|
"type": "integer"
|
|
|
|
|
},
|
|
|
|
|
"description": "Last event ID received"
|
|
|
|
|
},
|
|
|
|
|
{
|
|
|
|
|
"name": "location_code",
|
|
|
|
|
"in": "query",
|
|
|
|
|
"schema": {
|
|
|
|
|
"type": "string"
|
|
|
|
|
}
|
|
|
|
|
}
|
|
|
|
|
],
|
|
|
|
|
"responses": {
|
|
|
|
|
"200": {
|
|
|
|
|
"description": "SSE stream",
|
|
|
|
|
"content": {
|
|
|
|
|
"text/event-stream": {
|
|
|
|
|
"schema": {
|
|
|
|
|
"type": "string"
|
|
|
|
|
}
|
|
|
|
|
}
|
|
|
|
|
}
|
|
|
|
|
},
|
|
|
|
|
"401": {
|
|
|
|
|
"description": "Unauthorized",
|
|
|
|
|
"content": {
|
|
|
|
|
"application/json": {
|
|
|
|
|
"schema": {
|
|
|
|
|
"$ref": "#/components/schemas/Error"
|
|
|
|
|
}
|
|
|
|
|
}
|
|
|
|
|
}
|
|
|
|
|
}
|
|
|
|
|
}
|
|
|
|
|
}
|
docs: update OpenAPI spec dengan endpoint baru dan field camera - Tambah GET /locations/{code}, GET /gates/{location_code}/{gate_code}, GET /tariffs, GET /tariffs/{location_code}/{gate_code}/{category}, GET /audit-logs, GET /entry-events, GET /streams, GET /realtime/events, GET /realtime/snapshot, GET /summary/hourly, GET /dashboard/by-category, GET /dashboard/summary - Update field camera di gates (support HLS, RTSP, HTTP)
2025-12-18 06:46:03 +07:00
|
|
|
},
|
|
|
|
|
"/retribusi/v1/frontend/locations/{code}": {
|
|
|
|
|
"get": {
|
|
|
|
|
"tags": ["Frontend"],
|
|
|
|
|
"summary": "Get location detail",
|
|
|
|
|
"description": "Mendapatkan detail location berdasarkan code",
|
|
|
|
|
"security": [
|
|
|
|
|
{
|
|
|
|
|
"BearerAuth": []
|
|
|
|
|
}
|
|
|
|
|
],
|
|
|
|
|
"parameters": [
|
|
|
|
|
{
|
|
|
|
|
"name": "code",
|
|
|
|
|
"in": "path",
|
|
|
|
|
"required": true,
|
|
|
|
|
"schema": {
|
|
|
|
|
"type": "string"
|
|
|
|
|
},
|
|
|
|
|
"description": "Location code"
|
|
|
|
|
}
|
|
|
|
|
],
|
|
|
|
|
"responses": {
|
|
|
|
|
"200": {
|
|
|
|
|
"description": "Success",
|
|
|
|
|
"content": {
|
|
|
|
|
"application/json": {
|
|
|
|
|
"schema": {
|
|
|
|
|
"$ref": "#/components/schemas/Success"
|
|
|
|
|
}
|
|
|
|
|
}
|
|
|
|
|
}
|
|
|
|
|
},
|
|
|
|
|
"404": {
|
|
|
|
|
"description": "Location not found",
|
|
|
|
|
"content": {
|
|
|
|
|
"application/json": {
|
|
|
|
|
"schema": {
|
|
|
|
|
"$ref": "#/components/schemas/Error"
|
|
|
|
|
}
|
|
|
|
|
}
|
|
|
|
|
}
|
|
|
|
|
}
|
|
|
|
|
}
|
|
|
|
|
},
|
|
|
|
|
"put": {
|
|
|
|
|
"tags": ["Frontend"],
|
|
|
|
|
"summary": "Update location",
|
|
|
|
|
"description": "Update location (code tidak bisa diubah)",
|
|
|
|
|
"security": [
|
|
|
|
|
{
|
|
|
|
|
"BearerAuth": []
|
|
|
|
|
}
|
|
|
|
|
],
|
|
|
|
|
"parameters": [
|
|
|
|
|
{
|
|
|
|
|
"name": "code",
|
|
|
|
|
"in": "path",
|
|
|
|
|
"required": true,
|
|
|
|
|
"schema": {
|
|
|
|
|
"type": "string"
|
|
|
|
|
}
|
|
|
|
|
}
|
|
|
|
|
],
|
|
|
|
|
"requestBody": {
|
|
|
|
|
"required": true,
|
|
|
|
|
"content": {
|
|
|
|
|
"application/json": {
|
|
|
|
|
"schema": {
|
|
|
|
|
"type": "object",
|
|
|
|
|
"properties": {
|
|
|
|
|
"name": {
|
|
|
|
|
"type": "string"
|
|
|
|
|
},
|
|
|
|
|
"type": {
|
|
|
|
|
"type": "string"
|
|
|
|
|
},
|
|
|
|
|
"is_active": {
|
|
|
|
|
"type": "integer",
|
|
|
|
|
"enum": [0, 1]
|
|
|
|
|
}
|
|
|
|
|
}
|
|
|
|
|
}
|
|
|
|
|
}
|
|
|
|
|
}
|
|
|
|
|
},
|
|
|
|
|
"responses": {
|
|
|
|
|
"200": {
|
|
|
|
|
"description": "Location updated",
|
|
|
|
|
"content": {
|
|
|
|
|
"application/json": {
|
|
|
|
|
"schema": {
|
|
|
|
|
"$ref": "#/components/schemas/Success"
|
|
|
|
|
}
|
|
|
|
|
}
|
|
|
|
|
}
|
|
|
|
|
},
|
|
|
|
|
"404": {
|
|
|
|
|
"description": "Location not found",
|
|
|
|
|
"content": {
|
|
|
|
|
"application/json": {
|
|
|
|
|
"schema": {
|
|
|
|
|
"$ref": "#/components/schemas/Error"
|
|
|
|
|
}
|
|
|
|
|
}
|
|
|
|
|
}
|
|
|
|
|
}
|
|
|
|
|
}
|
|
|
|
|
},
|
|
|
|
|
"delete": {
|
|
|
|
|
"tags": ["Frontend"],
|
|
|
|
|
"summary": "Delete location",
|
|
|
|
|
"description": "Soft delete location (admin only)",
|
|
|
|
|
"security": [
|
|
|
|
|
{
|
|
|
|
|
"BearerAuth": []
|
|
|
|
|
}
|
|
|
|
|
],
|
|
|
|
|
"parameters": [
|
|
|
|
|
{
|
|
|
|
|
"name": "code",
|
|
|
|
|
"in": "path",
|
|
|
|
|
"required": true,
|
|
|
|
|
"schema": {
|
|
|
|
|
"type": "string"
|
|
|
|
|
}
|
|
|
|
|
}
|
|
|
|
|
],
|
|
|
|
|
"responses": {
|
|
|
|
|
"200": {
|
|
|
|
|
"description": "Location deleted",
|
|
|
|
|
"content": {
|
|
|
|
|
"application/json": {
|
|
|
|
|
"schema": {
|
|
|
|
|
"$ref": "#/components/schemas/Success"
|
|
|
|
|
}
|
|
|
|
|
}
|
|
|
|
|
}
|
|
|
|
|
},
|
|
|
|
|
"403": {
|
|
|
|
|
"description": "Forbidden (admin only)",
|
|
|
|
|
"content": {
|
|
|
|
|
"application/json": {
|
|
|
|
|
"schema": {
|
|
|
|
|
"$ref": "#/components/schemas/Error"
|
|
|
|
|
}
|
|
|
|
|
}
|
|
|
|
|
}
|
|
|
|
|
}
|
|
|
|
|
}
|
|
|
|
|
}
|
|
|
|
|
},
|
|
|
|
|
"/retribusi/v1/frontend/gates": {
|
|
|
|
|
"get": {
|
|
|
|
|
"tags": ["Frontend"],
|
|
|
|
|
"summary": "Get gates list",
|
|
|
|
|
"description": "Mendapatkan daftar gates dengan pagination",
|
|
|
|
|
"security": [
|
|
|
|
|
{
|
|
|
|
|
"BearerAuth": []
|
|
|
|
|
}
|
|
|
|
|
],
|
|
|
|
|
"parameters": [
|
|
|
|
|
{
|
|
|
|
|
"name": "page",
|
|
|
|
|
"in": "query",
|
|
|
|
|
"schema": {
|
|
|
|
|
"type": "integer",
|
|
|
|
|
"default": 1,
|
|
|
|
|
"minimum": 1
|
|
|
|
|
}
|
|
|
|
|
},
|
|
|
|
|
{
|
|
|
|
|
"name": "limit",
|
|
|
|
|
"in": "query",
|
|
|
|
|
"schema": {
|
|
|
|
|
"type": "integer",
|
|
|
|
|
"default": 20,
|
|
|
|
|
"minimum": 1,
|
|
|
|
|
"maximum": 100
|
|
|
|
|
}
|
|
|
|
|
},
|
|
|
|
|
{
|
|
|
|
|
"name": "location_code",
|
|
|
|
|
"in": "query",
|
|
|
|
|
"schema": {
|
|
|
|
|
"type": "string"
|
|
|
|
|
}
|
|
|
|
|
}
|
|
|
|
|
],
|
|
|
|
|
"responses": {
|
|
|
|
|
"200": {
|
|
|
|
|
"description": "Success",
|
|
|
|
|
"content": {
|
|
|
|
|
"application/json": {
|
|
|
|
|
"schema": {
|
|
|
|
|
"$ref": "#/components/schemas/Success"
|
|
|
|
|
}
|
|
|
|
|
}
|
|
|
|
|
}
|
|
|
|
|
}
|
|
|
|
|
}
|
|
|
|
|
},
|
|
|
|
|
"post": {
|
|
|
|
|
"tags": ["Frontend"],
|
|
|
|
|
"summary": "Create gate",
|
|
|
|
|
"description": "Membuat gate baru (operator/admin only)",
|
|
|
|
|
"security": [
|
|
|
|
|
{
|
|
|
|
|
"BearerAuth": []
|
|
|
|
|
}
|
|
|
|
|
],
|
|
|
|
|
"requestBody": {
|
|
|
|
|
"required": true,
|
|
|
|
|
"content": {
|
|
|
|
|
"application/json": {
|
|
|
|
|
"schema": {
|
|
|
|
|
"type": "object",
|
|
|
|
|
"required": ["location_code", "gate_code", "name", "direction", "is_active"],
|
|
|
|
|
"properties": {
|
|
|
|
|
"location_code": {
|
|
|
|
|
"type": "string",
|
|
|
|
|
"example": "kerkof_01"
|
|
|
|
|
},
|
|
|
|
|
"gate_code": {
|
|
|
|
|
"type": "string",
|
|
|
|
|
"example": "gate01"
|
|
|
|
|
},
|
|
|
|
|
"name": {
|
|
|
|
|
"type": "string",
|
|
|
|
|
"example": "Gate 01"
|
|
|
|
|
},
|
|
|
|
|
"direction": {
|
|
|
|
|
"type": "string",
|
|
|
|
|
"enum": ["in", "out"],
|
|
|
|
|
"example": "in"
|
|
|
|
|
},
|
|
|
|
|
"camera": {
|
|
|
|
|
"type": "string",
|
|
|
|
|
"description": "Camera URL (HLS, RTSP, HTTP) atau camera ID",
|
|
|
|
|
"example": "https://example.com/stream.m3u8",
|
|
|
|
|
"maxLength": 500
|
|
|
|
|
},
|
|
|
|
|
"is_active": {
|
|
|
|
|
"type": "integer",
|
|
|
|
|
"enum": [0, 1],
|
|
|
|
|
"example": 1
|
|
|
|
|
}
|
|
|
|
|
}
|
|
|
|
|
}
|
|
|
|
|
}
|
|
|
|
|
}
|
|
|
|
|
},
|
|
|
|
|
"responses": {
|
|
|
|
|
"201": {
|
|
|
|
|
"description": "Gate created",
|
|
|
|
|
"content": {
|
|
|
|
|
"application/json": {
|
|
|
|
|
"schema": {
|
|
|
|
|
"$ref": "#/components/schemas/Success"
|
|
|
|
|
}
|
|
|
|
|
}
|
|
|
|
|
}
|
|
|
|
|
},
|
|
|
|
|
"409": {
|
|
|
|
|
"description": "Conflict (gate already exists)",
|
|
|
|
|
"content": {
|
|
|
|
|
"application/json": {
|
|
|
|
|
"schema": {
|
|
|
|
|
"$ref": "#/components/schemas/Error"
|
|
|
|
|
}
|
|
|
|
|
}
|
|
|
|
|
}
|
|
|
|
|
}
|
|
|
|
|
}
|
|
|
|
|
}
|
|
|
|
|
},
|
|
|
|
|
"/retribusi/v1/frontend/gates/{location_code}/{gate_code}": {
|
|
|
|
|
"get": {
|
|
|
|
|
"tags": ["Frontend"],
|
|
|
|
|
"summary": "Get gate detail",
|
|
|
|
|
"description": "Mendapatkan detail gate berdasarkan location_code dan gate_code",
|
|
|
|
|
"security": [
|
|
|
|
|
{
|
|
|
|
|
"BearerAuth": []
|
|
|
|
|
}
|
|
|
|
|
],
|
|
|
|
|
"parameters": [
|
|
|
|
|
{
|
|
|
|
|
"name": "location_code",
|
|
|
|
|
"in": "path",
|
|
|
|
|
"required": true,
|
|
|
|
|
"schema": {
|
|
|
|
|
"type": "string"
|
|
|
|
|
}
|
|
|
|
|
},
|
|
|
|
|
{
|
|
|
|
|
"name": "gate_code",
|
|
|
|
|
"in": "path",
|
|
|
|
|
"required": true,
|
|
|
|
|
"schema": {
|
|
|
|
|
"type": "string"
|
|
|
|
|
}
|
|
|
|
|
}
|
|
|
|
|
],
|
|
|
|
|
"responses": {
|
|
|
|
|
"200": {
|
|
|
|
|
"description": "Success",
|
|
|
|
|
"content": {
|
|
|
|
|
"application/json": {
|
|
|
|
|
"schema": {
|
|
|
|
|
"$ref": "#/components/schemas/Success"
|
|
|
|
|
}
|
|
|
|
|
}
|
|
|
|
|
}
|
|
|
|
|
},
|
|
|
|
|
"404": {
|
|
|
|
|
"description": "Gate not found",
|
|
|
|
|
"content": {
|
|
|
|
|
"application/json": {
|
|
|
|
|
"schema": {
|
|
|
|
|
"$ref": "#/components/schemas/Error"
|
|
|
|
|
}
|
|
|
|
|
}
|
|
|
|
|
}
|
|
|
|
|
}
|
|
|
|
|
}
|
|
|
|
|
},
|
|
|
|
|
"put": {
|
|
|
|
|
"tags": ["Frontend"],
|
|
|
|
|
"summary": "Update gate",
|
|
|
|
|
"description": "Update gate (location_code dan gate_code tidak bisa diubah)",
|
|
|
|
|
"security": [
|
|
|
|
|
{
|
|
|
|
|
"BearerAuth": []
|
|
|
|
|
}
|
|
|
|
|
],
|
|
|
|
|
"parameters": [
|
|
|
|
|
{
|
|
|
|
|
"name": "location_code",
|
|
|
|
|
"in": "path",
|
|
|
|
|
"required": true,
|
|
|
|
|
"schema": {
|
|
|
|
|
"type": "string"
|
|
|
|
|
}
|
|
|
|
|
},
|
|
|
|
|
{
|
|
|
|
|
"name": "gate_code",
|
|
|
|
|
"in": "path",
|
|
|
|
|
"required": true,
|
|
|
|
|
"schema": {
|
|
|
|
|
"type": "string"
|
|
|
|
|
}
|
|
|
|
|
}
|
|
|
|
|
],
|
|
|
|
|
"requestBody": {
|
|
|
|
|
"required": true,
|
|
|
|
|
"content": {
|
|
|
|
|
"application/json": {
|
|
|
|
|
"schema": {
|
|
|
|
|
"type": "object",
|
|
|
|
|
"properties": {
|
|
|
|
|
"name": {
|
|
|
|
|
"type": "string"
|
|
|
|
|
},
|
|
|
|
|
"direction": {
|
|
|
|
|
"type": "string",
|
|
|
|
|
"enum": ["in", "out"]
|
|
|
|
|
},
|
|
|
|
|
"camera": {
|
|
|
|
|
"type": "string",
|
|
|
|
|
"description": "Camera URL (HLS, RTSP, HTTP) atau camera ID",
|
|
|
|
|
"maxLength": 500
|
|
|
|
|
},
|
|
|
|
|
"is_active": {
|
|
|
|
|
"type": "integer",
|
|
|
|
|
"enum": [0, 1]
|
|
|
|
|
}
|
|
|
|
|
}
|
|
|
|
|
}
|
|
|
|
|
}
|
|
|
|
|
}
|
|
|
|
|
},
|
|
|
|
|
"responses": {
|
|
|
|
|
"200": {
|
|
|
|
|
"description": "Gate updated",
|
|
|
|
|
"content": {
|
|
|
|
|
"application/json": {
|
|
|
|
|
"schema": {
|
|
|
|
|
"$ref": "#/components/schemas/Success"
|
|
|
|
|
}
|
|
|
|
|
}
|
|
|
|
|
}
|
|
|
|
|
},
|
|
|
|
|
"404": {
|
|
|
|
|
"description": "Gate not found",
|
|
|
|
|
"content": {
|
|
|
|
|
"application/json": {
|
|
|
|
|
"schema": {
|
|
|
|
|
"$ref": "#/components/schemas/Error"
|
|
|
|
|
}
|
|
|
|
|
}
|
|
|
|
|
}
|
|
|
|
|
}
|
|
|
|
|
}
|
|
|
|
|
},
|
|
|
|
|
"delete": {
|
|
|
|
|
"tags": ["Frontend"],
|
|
|
|
|
"summary": "Delete gate",
|
|
|
|
|
"description": "Soft delete gate (admin only)",
|
|
|
|
|
"security": [
|
|
|
|
|
{
|
|
|
|
|
"BearerAuth": []
|
|
|
|
|
}
|
|
|
|
|
],
|
|
|
|
|
"parameters": [
|
|
|
|
|
{
|
|
|
|
|
"name": "location_code",
|
|
|
|
|
"in": "path",
|
|
|
|
|
"required": true,
|
|
|
|
|
"schema": {
|
|
|
|
|
"type": "string"
|
|
|
|
|
}
|
|
|
|
|
},
|
|
|
|
|
{
|
|
|
|
|
"name": "gate_code",
|
|
|
|
|
"in": "path",
|
|
|
|
|
"required": true,
|
|
|
|
|
"schema": {
|
|
|
|
|
"type": "string"
|
|
|
|
|
}
|
|
|
|
|
}
|
|
|
|
|
],
|
|
|
|
|
"responses": {
|
|
|
|
|
"200": {
|
|
|
|
|
"description": "Gate deleted",
|
|
|
|
|
"content": {
|
|
|
|
|
"application/json": {
|
|
|
|
|
"schema": {
|
|
|
|
|
"$ref": "#/components/schemas/Success"
|
|
|
|
|
}
|
|
|
|
|
}
|
|
|
|
|
}
|
|
|
|
|
}
|
|
|
|
|
}
|
|
|
|
|
}
|
|
|
|
|
},
|
|
|
|
|
"/retribusi/v1/frontend/tariffs": {
|
|
|
|
|
"get": {
|
|
|
|
|
"tags": ["Frontend"],
|
|
|
|
|
"summary": "Get tariffs list",
|
|
|
|
|
"description": "Mendapatkan daftar tariffs dengan pagination",
|
|
|
|
|
"security": [
|
|
|
|
|
{
|
|
|
|
|
"BearerAuth": []
|
|
|
|
|
}
|
|
|
|
|
],
|
|
|
|
|
"parameters": [
|
|
|
|
|
{
|
|
|
|
|
"name": "page",
|
|
|
|
|
"in": "query",
|
|
|
|
|
"schema": {
|
|
|
|
|
"type": "integer",
|
|
|
|
|
"default": 1,
|
|
|
|
|
"minimum": 1
|
|
|
|
|
}
|
|
|
|
|
},
|
|
|
|
|
{
|
|
|
|
|
"name": "limit",
|
|
|
|
|
"in": "query",
|
|
|
|
|
"schema": {
|
|
|
|
|
"type": "integer",
|
|
|
|
|
"default": 20,
|
|
|
|
|
"minimum": 1,
|
|
|
|
|
"maximum": 100
|
|
|
|
|
}
|
|
|
|
|
},
|
|
|
|
|
{
|
|
|
|
|
"name": "location_code",
|
|
|
|
|
"in": "query",
|
|
|
|
|
"schema": {
|
|
|
|
|
"type": "string"
|
|
|
|
|
}
|
|
|
|
|
},
|
|
|
|
|
{
|
|
|
|
|
"name": "gate_code",
|
|
|
|
|
"in": "query",
|
|
|
|
|
"schema": {
|
|
|
|
|
"type": "string"
|
|
|
|
|
}
|
|
|
|
|
}
|
|
|
|
|
],
|
|
|
|
|
"responses": {
|
|
|
|
|
"200": {
|
|
|
|
|
"description": "Success",
|
|
|
|
|
"content": {
|
|
|
|
|
"application/json": {
|
|
|
|
|
"schema": {
|
|
|
|
|
"$ref": "#/components/schemas/Success"
|
|
|
|
|
}
|
|
|
|
|
}
|
|
|
|
|
}
|
|
|
|
|
}
|
|
|
|
|
}
|
|
|
|
|
},
|
|
|
|
|
"post": {
|
|
|
|
|
"tags": ["Frontend"],
|
|
|
|
|
"summary": "Create tariff",
|
|
|
|
|
"description": "Membuat tariff baru (operator/admin only)",
|
|
|
|
|
"security": [
|
|
|
|
|
{
|
|
|
|
|
"BearerAuth": []
|
|
|
|
|
}
|
|
|
|
|
],
|
|
|
|
|
"requestBody": {
|
|
|
|
|
"required": true,
|
|
|
|
|
"content": {
|
|
|
|
|
"application/json": {
|
|
|
|
|
"schema": {
|
|
|
|
|
"type": "object",
|
|
|
|
|
"required": ["location_code", "gate_code", "category", "price"],
|
|
|
|
|
"properties": {
|
|
|
|
|
"location_code": {
|
|
|
|
|
"type": "string"
|
|
|
|
|
},
|
|
|
|
|
"gate_code": {
|
|
|
|
|
"type": "string"
|
|
|
|
|
},
|
|
|
|
|
"category": {
|
|
|
|
|
"type": "string",
|
|
|
|
|
"enum": ["person_walk", "motor", "car"]
|
|
|
|
|
},
|
|
|
|
|
"price": {
|
|
|
|
|
"type": "integer",
|
|
|
|
|
"minimum": 0
|
|
|
|
|
}
|
|
|
|
|
}
|
|
|
|
|
}
|
|
|
|
|
}
|
|
|
|
|
}
|
|
|
|
|
},
|
|
|
|
|
"responses": {
|
|
|
|
|
"201": {
|
|
|
|
|
"description": "Tariff created",
|
|
|
|
|
"content": {
|
|
|
|
|
"application/json": {
|
|
|
|
|
"schema": {
|
|
|
|
|
"$ref": "#/components/schemas/Success"
|
|
|
|
|
}
|
|
|
|
|
}
|
|
|
|
|
}
|
|
|
|
|
}
|
|
|
|
|
}
|
|
|
|
|
}
|
|
|
|
|
},
|
|
|
|
|
"/retribusi/v1/frontend/tariffs/{location_code}/{gate_code}/{category}": {
|
|
|
|
|
"get": {
|
|
|
|
|
"tags": ["Frontend"],
|
|
|
|
|
"summary": "Get tariff detail",
|
|
|
|
|
"description": "Mendapatkan detail tariff berdasarkan location_code, gate_code, dan category",
|
|
|
|
|
"security": [
|
|
|
|
|
{
|
|
|
|
|
"BearerAuth": []
|
|
|
|
|
}
|
|
|
|
|
],
|
|
|
|
|
"parameters": [
|
|
|
|
|
{
|
|
|
|
|
"name": "location_code",
|
|
|
|
|
"in": "path",
|
|
|
|
|
"required": true,
|
|
|
|
|
"schema": {
|
|
|
|
|
"type": "string"
|
|
|
|
|
}
|
|
|
|
|
},
|
|
|
|
|
{
|
|
|
|
|
"name": "gate_code",
|
|
|
|
|
"in": "path",
|
|
|
|
|
"required": true,
|
|
|
|
|
"schema": {
|
|
|
|
|
"type": "string"
|
|
|
|
|
}
|
|
|
|
|
},
|
|
|
|
|
{
|
|
|
|
|
"name": "category",
|
|
|
|
|
"in": "path",
|
|
|
|
|
"required": true,
|
|
|
|
|
"schema": {
|
|
|
|
|
"type": "string"
|
|
|
|
|
}
|
|
|
|
|
}
|
|
|
|
|
],
|
|
|
|
|
"responses": {
|
|
|
|
|
"200": {
|
|
|
|
|
"description": "Success",
|
|
|
|
|
"content": {
|
|
|
|
|
"application/json": {
|
|
|
|
|
"schema": {
|
|
|
|
|
"$ref": "#/components/schemas/Success"
|
|
|
|
|
}
|
|
|
|
|
}
|
|
|
|
|
}
|
|
|
|
|
},
|
|
|
|
|
"404": {
|
|
|
|
|
"description": "Tariff not found",
|
|
|
|
|
"content": {
|
|
|
|
|
"application/json": {
|
|
|
|
|
"schema": {
|
|
|
|
|
"$ref": "#/components/schemas/Error"
|
|
|
|
|
}
|
|
|
|
|
}
|
|
|
|
|
}
|
|
|
|
|
}
|
|
|
|
|
}
|
|
|
|
|
},
|
|
|
|
|
"put": {
|
|
|
|
|
"tags": ["Frontend"],
|
|
|
|
|
"summary": "Update tariff",
|
|
|
|
|
"description": "Update tariff price (operator/admin only)",
|
|
|
|
|
"security": [
|
|
|
|
|
{
|
|
|
|
|
"BearerAuth": []
|
|
|
|
|
}
|
|
|
|
|
],
|
|
|
|
|
"parameters": [
|
|
|
|
|
{
|
|
|
|
|
"name": "location_code",
|
|
|
|
|
"in": "path",
|
|
|
|
|
"required": true,
|
|
|
|
|
"schema": {
|
|
|
|
|
"type": "string"
|
|
|
|
|
}
|
|
|
|
|
},
|
|
|
|
|
{
|
|
|
|
|
"name": "gate_code",
|
|
|
|
|
"in": "path",
|
|
|
|
|
"required": true,
|
|
|
|
|
"schema": {
|
|
|
|
|
"type": "string"
|
|
|
|
|
}
|
|
|
|
|
},
|
|
|
|
|
{
|
|
|
|
|
"name": "category",
|
|
|
|
|
"in": "path",
|
|
|
|
|
"required": true,
|
|
|
|
|
"schema": {
|
|
|
|
|
"type": "string"
|
|
|
|
|
}
|
|
|
|
|
}
|
|
|
|
|
],
|
|
|
|
|
"requestBody": {
|
|
|
|
|
"required": true,
|
|
|
|
|
"content": {
|
|
|
|
|
"application/json": {
|
|
|
|
|
"schema": {
|
|
|
|
|
"type": "object",
|
|
|
|
|
"required": ["price"],
|
|
|
|
|
"properties": {
|
|
|
|
|
"price": {
|
|
|
|
|
"type": "integer",
|
|
|
|
|
"minimum": 0
|
|
|
|
|
}
|
|
|
|
|
}
|
|
|
|
|
}
|
|
|
|
|
}
|
|
|
|
|
}
|
|
|
|
|
},
|
|
|
|
|
"responses": {
|
|
|
|
|
"200": {
|
|
|
|
|
"description": "Tariff updated",
|
|
|
|
|
"content": {
|
|
|
|
|
"application/json": {
|
|
|
|
|
"schema": {
|
|
|
|
|
"$ref": "#/components/schemas/Success"
|
|
|
|
|
}
|
|
|
|
|
}
|
|
|
|
|
}
|
|
|
|
|
}
|
|
|
|
|
}
|
|
|
|
|
},
|
|
|
|
|
"delete": {
|
|
|
|
|
"tags": ["Frontend"],
|
|
|
|
|
"summary": "Delete tariff",
|
|
|
|
|
"description": "Hard delete tariff (admin only)",
|
|
|
|
|
"security": [
|
|
|
|
|
{
|
|
|
|
|
"BearerAuth": []
|
|
|
|
|
}
|
|
|
|
|
],
|
|
|
|
|
"parameters": [
|
|
|
|
|
{
|
|
|
|
|
"name": "location_code",
|
|
|
|
|
"in": "path",
|
|
|
|
|
"required": true,
|
|
|
|
|
"schema": {
|
|
|
|
|
"type": "string"
|
|
|
|
|
}
|
|
|
|
|
},
|
|
|
|
|
{
|
|
|
|
|
"name": "gate_code",
|
|
|
|
|
"in": "path",
|
|
|
|
|
"required": true,
|
|
|
|
|
"schema": {
|
|
|
|
|
"type": "string"
|
|
|
|
|
}
|
|
|
|
|
},
|
|
|
|
|
{
|
|
|
|
|
"name": "category",
|
|
|
|
|
"in": "path",
|
|
|
|
|
"required": true,
|
|
|
|
|
"schema": {
|
|
|
|
|
"type": "string"
|
|
|
|
|
}
|
|
|
|
|
}
|
|
|
|
|
],
|
|
|
|
|
"responses": {
|
|
|
|
|
"200": {
|
|
|
|
|
"description": "Tariff deleted",
|
|
|
|
|
"content": {
|
|
|
|
|
"application/json": {
|
|
|
|
|
"schema": {
|
|
|
|
|
"$ref": "#/components/schemas/Success"
|
|
|
|
|
}
|
|
|
|
|
}
|
|
|
|
|
}
|
|
|
|
|
}
|
|
|
|
|
}
|
|
|
|
|
}
|
|
|
|
|
},
|
|
|
|
|
"/retribusi/v1/frontend/audit-logs": {
|
|
|
|
|
"get": {
|
|
|
|
|
"tags": ["Frontend"],
|
|
|
|
|
"summary": "Get audit logs",
|
|
|
|
|
"description": "Mendapatkan audit trail history dengan pagination dan filter",
|
|
|
|
|
"security": [
|
|
|
|
|
{
|
|
|
|
|
"BearerAuth": []
|
|
|
|
|
}
|
|
|
|
|
],
|
|
|
|
|
"parameters": [
|
|
|
|
|
{
|
|
|
|
|
"name": "page",
|
|
|
|
|
"in": "query",
|
|
|
|
|
"schema": {
|
|
|
|
|
"type": "integer",
|
|
|
|
|
"default": 1,
|
|
|
|
|
"minimum": 1
|
|
|
|
|
}
|
|
|
|
|
},
|
|
|
|
|
{
|
|
|
|
|
"name": "limit",
|
|
|
|
|
"in": "query",
|
|
|
|
|
"schema": {
|
|
|
|
|
"type": "integer",
|
|
|
|
|
"default": 20,
|
|
|
|
|
"minimum": 1,
|
|
|
|
|
"maximum": 100
|
|
|
|
|
}
|
|
|
|
|
},
|
|
|
|
|
{
|
|
|
|
|
"name": "entity",
|
|
|
|
|
"in": "query",
|
|
|
|
|
"schema": {
|
|
|
|
|
"type": "string",
|
|
|
|
|
"enum": ["locations", "gates", "tariffs"]
|
|
|
|
|
}
|
|
|
|
|
},
|
|
|
|
|
{
|
|
|
|
|
"name": "action",
|
|
|
|
|
"in": "query",
|
|
|
|
|
"schema": {
|
|
|
|
|
"type": "string",
|
|
|
|
|
"enum": ["create", "update", "delete"]
|
|
|
|
|
}
|
|
|
|
|
},
|
|
|
|
|
{
|
|
|
|
|
"name": "entity_key",
|
|
|
|
|
"in": "query",
|
|
|
|
|
"schema": {
|
|
|
|
|
"type": "string"
|
|
|
|
|
}
|
|
|
|
|
},
|
|
|
|
|
{
|
|
|
|
|
"name": "start_date",
|
|
|
|
|
"in": "query",
|
|
|
|
|
"schema": {
|
|
|
|
|
"type": "string",
|
|
|
|
|
"format": "date"
|
|
|
|
|
}
|
|
|
|
|
},
|
|
|
|
|
{
|
|
|
|
|
"name": "end_date",
|
|
|
|
|
"in": "query",
|
|
|
|
|
"schema": {
|
|
|
|
|
"type": "string",
|
|
|
|
|
"format": "date"
|
|
|
|
|
}
|
|
|
|
|
}
|
|
|
|
|
],
|
|
|
|
|
"responses": {
|
|
|
|
|
"200": {
|
|
|
|
|
"description": "Success",
|
|
|
|
|
"content": {
|
|
|
|
|
"application/json": {
|
|
|
|
|
"schema": {
|
|
|
|
|
"$ref": "#/components/schemas/Success"
|
|
|
|
|
}
|
|
|
|
|
}
|
|
|
|
|
}
|
|
|
|
|
}
|
|
|
|
|
}
|
|
|
|
|
}
|
|
|
|
|
},
|
|
|
|
|
"/retribusi/v1/frontend/entry-events": {
|
|
|
|
|
"get": {
|
|
|
|
|
"tags": ["Frontend"],
|
|
|
|
|
"summary": "Get entry events",
|
|
|
|
|
"description": "Mendapatkan daftar raw entry events (data mentah dari mesin)",
|
|
|
|
|
"security": [
|
|
|
|
|
{
|
|
|
|
|
"BearerAuth": []
|
|
|
|
|
}
|
|
|
|
|
],
|
|
|
|
|
"parameters": [
|
|
|
|
|
{
|
|
|
|
|
"name": "page",
|
|
|
|
|
"in": "query",
|
|
|
|
|
"schema": {
|
|
|
|
|
"type": "integer",
|
|
|
|
|
"default": 1,
|
|
|
|
|
"minimum": 1
|
|
|
|
|
}
|
|
|
|
|
},
|
|
|
|
|
{
|
|
|
|
|
"name": "limit",
|
|
|
|
|
"in": "query",
|
|
|
|
|
"schema": {
|
|
|
|
|
"type": "integer",
|
|
|
|
|
"default": 20,
|
|
|
|
|
"minimum": 1,
|
|
|
|
|
"maximum": 100
|
|
|
|
|
}
|
|
|
|
|
},
|
|
|
|
|
{
|
|
|
|
|
"name": "location_code",
|
|
|
|
|
"in": "query",
|
|
|
|
|
"schema": {
|
|
|
|
|
"type": "string"
|
|
|
|
|
}
|
|
|
|
|
},
|
|
|
|
|
{
|
|
|
|
|
"name": "gate_code",
|
|
|
|
|
"in": "query",
|
|
|
|
|
"schema": {
|
|
|
|
|
"type": "string"
|
|
|
|
|
}
|
|
|
|
|
},
|
|
|
|
|
{
|
|
|
|
|
"name": "category",
|
|
|
|
|
"in": "query",
|
|
|
|
|
"schema": {
|
|
|
|
|
"type": "string"
|
|
|
|
|
}
|
|
|
|
|
},
|
|
|
|
|
{
|
|
|
|
|
"name": "start_date",
|
|
|
|
|
"in": "query",
|
|
|
|
|
"schema": {
|
|
|
|
|
"type": "string",
|
|
|
|
|
"format": "date"
|
|
|
|
|
}
|
|
|
|
|
},
|
|
|
|
|
{
|
|
|
|
|
"name": "end_date",
|
|
|
|
|
"in": "query",
|
|
|
|
|
"schema": {
|
|
|
|
|
"type": "string",
|
|
|
|
|
"format": "date"
|
|
|
|
|
}
|
|
|
|
|
}
|
|
|
|
|
],
|
|
|
|
|
"responses": {
|
|
|
|
|
"200": {
|
|
|
|
|
"description": "Success",
|
|
|
|
|
"content": {
|
|
|
|
|
"application/json": {
|
|
|
|
|
"schema": {
|
|
|
|
|
"$ref": "#/components/schemas/Success"
|
|
|
|
|
}
|
|
|
|
|
}
|
|
|
|
|
}
|
|
|
|
|
}
|
|
|
|
|
}
|
|
|
|
|
}
|
|
|
|
|
},
|
|
|
|
|
"/retribusi/v1/frontend/streams": {
|
|
|
|
|
"get": {
|
|
|
|
|
"tags": ["Frontend"],
|
|
|
|
|
"summary": "Get streams list",
|
|
|
|
|
"description": "Get list of streams (alias untuk gates)",
|
|
|
|
|
"security": [
|
|
|
|
|
{
|
|
|
|
|
"BearerAuth": []
|
|
|
|
|
}
|
|
|
|
|
],
|
|
|
|
|
"parameters": [
|
|
|
|
|
{
|
|
|
|
|
"name": "page",
|
|
|
|
|
"in": "query",
|
|
|
|
|
"schema": {
|
|
|
|
|
"type": "integer",
|
|
|
|
|
"default": 1,
|
|
|
|
|
"minimum": 1
|
|
|
|
|
}
|
|
|
|
|
},
|
|
|
|
|
{
|
|
|
|
|
"name": "limit",
|
|
|
|
|
"in": "query",
|
|
|
|
|
"schema": {
|
|
|
|
|
"type": "integer",
|
|
|
|
|
"default": 20,
|
|
|
|
|
"minimum": 1,
|
|
|
|
|
"maximum": 100
|
|
|
|
|
}
|
|
|
|
|
},
|
|
|
|
|
{
|
|
|
|
|
"name": "location_code",
|
|
|
|
|
"in": "query",
|
|
|
|
|
"schema": {
|
|
|
|
|
"type": "string"
|
|
|
|
|
}
|
|
|
|
|
}
|
|
|
|
|
],
|
|
|
|
|
"responses": {
|
|
|
|
|
"200": {
|
|
|
|
|
"description": "Success",
|
|
|
|
|
"content": {
|
|
|
|
|
"application/json": {
|
|
|
|
|
"schema": {
|
|
|
|
|
"$ref": "#/components/schemas/Success"
|
|
|
|
|
}
|
|
|
|
|
}
|
|
|
|
|
}
|
|
|
|
|
}
|
|
|
|
|
}
|
|
|
|
|
}
|
|
|
|
|
},
|
|
|
|
|
"/retribusi/v1/realtime/snapshot": {
|
|
|
|
|
"get": {
|
|
|
|
|
"tags": ["Realtime"],
|
|
|
|
|
"summary": "Get snapshot",
|
|
|
|
|
"description": "Mendapatkan snapshot data untuk dashboard cards",
|
|
|
|
|
"security": [
|
|
|
|
|
{
|
|
|
|
|
"BearerAuth": []
|
|
|
|
|
}
|
|
|
|
|
],
|
|
|
|
|
"parameters": [
|
|
|
|
|
{
|
|
|
|
|
"name": "date",
|
|
|
|
|
"in": "query",
|
|
|
|
|
"schema": {
|
|
|
|
|
"type": "string",
|
|
|
|
|
"format": "date"
|
|
|
|
|
},
|
|
|
|
|
"description": "Date (default: today)"
|
|
|
|
|
},
|
|
|
|
|
{
|
|
|
|
|
"name": "location_code",
|
|
|
|
|
"in": "query",
|
|
|
|
|
"schema": {
|
|
|
|
|
"type": "string"
|
|
|
|
|
}
|
|
|
|
|
}
|
|
|
|
|
],
|
|
|
|
|
"responses": {
|
|
|
|
|
"200": {
|
|
|
|
|
"description": "Success",
|
|
|
|
|
"content": {
|
|
|
|
|
"application/json": {
|
|
|
|
|
"schema": {
|
|
|
|
|
"$ref": "#/components/schemas/Success"
|
|
|
|
|
}
|
|
|
|
|
}
|
|
|
|
|
}
|
|
|
|
|
}
|
|
|
|
|
}
|
|
|
|
|
}
|
|
|
|
|
},
|
|
|
|
|
"/retribusi/v1/realtime/events": {
|
|
|
|
|
"get": {
|
|
|
|
|
"tags": ["Realtime"],
|
|
|
|
|
"summary": "Get realtime events list",
|
|
|
|
|
"description": "Mendapatkan daftar realtime events (history untuk SSE)",
|
|
|
|
|
"security": [
|
|
|
|
|
{
|
|
|
|
|
"BearerAuth": []
|
|
|
|
|
}
|
|
|
|
|
],
|
|
|
|
|
"parameters": [
|
|
|
|
|
{
|
|
|
|
|
"name": "page",
|
|
|
|
|
"in": "query",
|
|
|
|
|
"schema": {
|
|
|
|
|
"type": "integer",
|
|
|
|
|
"default": 1,
|
|
|
|
|
"minimum": 1
|
|
|
|
|
}
|
|
|
|
|
},
|
|
|
|
|
{
|
|
|
|
|
"name": "limit",
|
|
|
|
|
"in": "query",
|
|
|
|
|
"schema": {
|
|
|
|
|
"type": "integer",
|
|
|
|
|
"default": 20,
|
|
|
|
|
"minimum": 1,
|
|
|
|
|
"maximum": 100
|
|
|
|
|
}
|
|
|
|
|
},
|
|
|
|
|
{
|
|
|
|
|
"name": "location_code",
|
|
|
|
|
"in": "query",
|
|
|
|
|
"schema": {
|
|
|
|
|
"type": "string"
|
|
|
|
|
}
|
|
|
|
|
},
|
|
|
|
|
{
|
|
|
|
|
"name": "gate_code",
|
|
|
|
|
"in": "query",
|
|
|
|
|
"schema": {
|
|
|
|
|
"type": "string"
|
|
|
|
|
}
|
|
|
|
|
},
|
|
|
|
|
{
|
|
|
|
|
"name": "category",
|
|
|
|
|
"in": "query",
|
|
|
|
|
"schema": {
|
|
|
|
|
"type": "string"
|
|
|
|
|
}
|
|
|
|
|
},
|
|
|
|
|
{
|
|
|
|
|
"name": "start_date",
|
|
|
|
|
"in": "query",
|
|
|
|
|
"schema": {
|
|
|
|
|
"type": "string",
|
|
|
|
|
"format": "date"
|
|
|
|
|
}
|
|
|
|
|
},
|
|
|
|
|
{
|
|
|
|
|
"name": "end_date",
|
|
|
|
|
"in": "query",
|
|
|
|
|
"schema": {
|
|
|
|
|
"type": "string",
|
|
|
|
|
"format": "date"
|
|
|
|
|
}
|
|
|
|
|
}
|
|
|
|
|
],
|
|
|
|
|
"responses": {
|
|
|
|
|
"200": {
|
|
|
|
|
"description": "Success",
|
|
|
|
|
"content": {
|
|
|
|
|
"application/json": {
|
|
|
|
|
"schema": {
|
|
|
|
|
"$ref": "#/components/schemas/Success"
|
|
|
|
|
}
|
|
|
|
|
}
|
|
|
|
|
}
|
|
|
|
|
}
|
|
|
|
|
}
|
|
|
|
|
}
|
2025-12-17 11:08:04 +07:00
|
|
|
}
|
|
|
|
|
}
|
|
|
|
|
}
|
|
|
|
|
|
