REST · OpenAPI 3.x · JWT

🧪 API Reference

API gateway dùng REST + OpenAPI 3.x, xác thực JWT (Bearer). Mọi endpoint nằm dưới https://api.lotuscloud.vnso.vn/api/v1/ (hoặc http://localhost:8080/api/v1/ ở local). Đặc tả đầy đủ tại openapi.yaml.

Auth

POST /api/v1/auth/register          # Đăng ký
POST /api/v1/auth/login             # Lấy access + refresh token
POST /api/v1/auth/refresh           # Refresh-token rotation
POST /api/v1/auth/mfa/enroll        # Bật MFA TOTP
POST /api/v1/auth/workload-token    # Workload identity (service-to-service)

Databases (DBaaS)

GET    /api/v1/databases
POST   /api/v1/databases
GET    /api/v1/databases/:id
DELETE /api/v1/databases/:id

PUT    /api/v1/databases/:id/pool        # ConnectionPoolConfig
GET    /api/v1/databases/:id/pool

POST   /api/v1/databases/:id/replicas    # Read replica
GET    /api/v1/databases/:id/replicas

POST   /api/v1/databases/:id/failover    # Manual failover

POST   /api/v1/backups
POST   /api/v1/backups/policies
PUT    /api/v1/backups/policies/:id      # destination_region/zone

POST   /api/v1/snapshots

Networking

GET/POST /api/v1/vpcs
GET/POST /api/v1/vpcs/:id/subnets
GET/POST /api/v1/vpcs/:id/route-tables

GET/POST /api/v1/transit-hubs
GET/POST /api/v1/transit-hub-attachments
GET/POST /api/v1/vpc-peerings

POST     /api/v1/vpn-gateways
POST     /api/v1/vpn-gateways/:id/bgp
POST     /api/v1/vpn-gateways/:id/bgp/activate

GET/POST /api/v1/load-balancers
POST     /api/v1/load-balancers/:id/health-probes
GET/POST /api/v1/global-load-balancers

GET/POST /api/v1/bandwidth-policies
PUT      /api/v1/bandwidth-policies/:id

GET/POST /api/v1/private-endpoints
GET/POST /api/v1/ddos/plans

IAM

GET/POST /api/v1/iam/users
GET/POST /api/v1/iam/roles
POST     /api/v1/iam/keys
POST     /api/v1/iam/authorize-bucket

GET/POST /api/v1/projects
POST     /api/v1/projects/:id/members/delegate

DR

GET/POST /api/v1/dr/plans
POST     /api/v1/dr/plans/:id/steps
POST     /api/v1/dr/plans/:id/drills
POST     /api/v1/dr/plans/:id/execute

Billing & Cost

GET  /api/v1/billing/cost
POST /api/v1/billing/budgets
GET  /api/v1/quotas
GET  /api/v1/subscriptions

Observability

GET /api/v1/service-status
GET /api/v1/audit/logs
GET /api/v1/metrics
GET /api/v1/logs/query

Provisioning Metric

POST /api/v1/provisioning-metrics                  # Bắt đầu đo
PUT  /api/v1/provisioning-metrics/:metricId/complete

Xem full spec: openapi.yaml · OpenAPI editor: paste vào editor.swagger.io.