Gold multi-source — Mã stable; tổng hợp DOJI official, BTMC official, Bảo Tín Mạnh Hải official, WebGia tổng hợp/SJC/PNJ, 24h, Simplize, BaoMoi/BTMC + XAU/USD từ Simplize/WebGia
Fuel multi-source — Tổng hợp 4 nguồn: WebGia, GiaXangHomNay, MIPEC, Saigon Petro
Lịch sử nội bộ — Giá vàng, xăng dầu, tỉ giá tự lưu snapshot vào DB hàng ngày
Exchange Rate History — Endpoint mới /api/v1/exchange-rate/history
Gold History nội bộ — /api/v1/gold/{code}?days=30 đọc từ DB thay vì upstream
Loại bỏ PVOIL — Xóa hoàn toàn nguồn PVOIL legacy khỏi codebase
API Contract — Response chuẩn {"ok": true, "data": ...}

🔐 Xác thực

Authorization: Bearer <token>

Gold, Fuel, Exchange Rate, Lịch sử giá — không cần token
Flash Sale — cần Bearer token

💬 Liên hệ nhận token →

⚡ Rate Limit

Flash Sale

30 req/min
token required

Gold

120 req/min
cache 5 phút, capture 5 phút

Fuel

120 req/min
cache theo kỳ

Exchange Rate

120 req/min
cache 5 phút, capture 5 phút

Vượt giới hạn → HTTP 429 · Retry-After header

🏥 Health Check

Trạng thái hệ thống, latency từng service

/api/health

📈 Lịch sử giá

Tra cứu lịch sử giá flash sale 30 ngày

/price-history

💻 Ví dụ nhanh

# Giá vàng hiện tại
curl https://keoquy.com/api/v1/gold

# Lịch sử giá vàng SJC 30 ngày
curl https://keoquy.com/api/v1/gold/SJC_SJC_TO_N_QU_C?days=30

# Giá xăng dầu (multi-source)
curl https://keoquy.com/api/v1/fuel

# Lịch sử giá xăng dầu
curl https://keoquy.com/api/v1/fuel/history?limit=10

# Giá dầu thế giới (WTI, Brent)
curl https://keoquy.com/api/v1/fuel/world-oil

# Tỷ giá ngoại tệ
curl https://keoquy.com/api/v1/exchange-rate

# Lịch sử tỷ giá
curl https://keoquy.com/api/v1/exchange-rate/history?limit=10

# Flash Sale (cần token)
curl -H "Authorization: Bearer YOUR_TOKEN" \
     https://keoquy.com/api/v1/promotions