api.mitom.vn — Tài liệu API

Mục lục: Xác thực Giới hạn Tin mới Tìm mã Giá Tin theo mã Báo cáo TC Lịch KT Lỗi 🔑 Quản lý key (admin)

Xác thực

Mọi request tới /v1/* đều cần API key. Key do quản trị cấp (liên hệ admin). Gửi key theo 1 trong 2 cách:

Header (khuyến nghị): X-API-Key: sk_live_xxxxx
Query param: ?api_key=sk_live_xxxxx

Base URL: https://api.mitom.vn. CORS đã bật (*) nên gọi trực tiếp từ trình duyệt được; giữ key ở backend khi có thể.

# curl
curl -H "X-API-Key: sk_live_xxxxx" "https://api.mitom.vn/v1/feed?section=latest"

// JavaScript (fetch)
const r = await fetch("https://api.mitom.vn/v1/feed?section=crypto", {
  headers: { "X-API-Key": "sk_live_xxxxx" }
});
const data = await r.json();

Giới hạn (Rate limit)

Mỗi key có giới hạn riêng (admin tùy chỉnh): rpm = request/phút, rpd = request/ngày. Mỗi response trả các header:

Header	Ý nghĩa
`X-RateLimit-Limit-Minute` / `-Day`	Hạn mức phút/ngày của key
`X-RateLimit-Remaining-Minute` / `-Day`	Số request còn lại
`Retry-After`	Khi bị 429: số giây nên đợi

Lưu ý: mỗi call chưa cache có thể mất ~10–40s vì backend chạy headless browser vượt Cloudflare. Response được cache phía backend (feed/news ~2 phút, quote ~30s, financials ~5 phút) nên gọi lại nhanh.

GET /v1/feed — Tin mới theo chuyên mục GET

Tham số	Mô tả
`section`	Chuyên mục (mặc định `latest`). Xem danh sách qua `/v1/feed/sections`.
`tr`	`1` (mặc định) dịch tiêu đề sang tiếng Việt (`titleVi`); `0` để tắt (nhanh hơn).

Chuyên mục: latest, stock-market, forex, commodities, crypto, economy, indicators, world, most-popular.

curl -H "X-API-Key: KEY" "https://api.mitom.vn/v1/feed?section=crypto"

{
  "section": "crypto",
  "items": [
    { "title": "Bitcoin falls below $60,000...", "titleVi": "Bitcoin giảm xuống dưới 60.000 USD...",
      "link": "/news/cryptocurrency-news/...", "time": "6 hours ago", "provider": "Investing.com" }
  ]
}

GET /v1/search — Tìm mã GET

Tìm cổ phiếu/forex/hàng hóa/crypto theo từ khóa. Trả quotes[] với link dùng cho các endpoint bên dưới.

Tham số	Mô tả
`q`	Từ khóa: `AAPL`, `EUR/USD`, `Bitcoin`, `Gold`…

curl -H "X-API-Key: KEY" "https://api.mitom.vn/v1/search?q=AAPL"

{ "quotes": [ { "symbol":"AAPL", "name":"Apple Inc", "exchange":"NASDAQ", "type":"Equity",
                "link":"/equities/apple-computer-inc" } ] }

GET /v1/quote — Giá & thống kê GET

Tham số	Mô tả
`link`	Đường dẫn lấy từ `/v1/search` (vd `/equities/apple-computer-inc`)

curl -H "X-API-Key: KEY" "https://api.mitom.vn/v1/quote?link=/equities/apple-computer-inc"

GET /v1/news — Tin theo mã GET

Tham số	Mô tả
`link`	Đường dẫn mã (như trên). Trả tin của riêng mã đó, kèm `titleVi`.

curl -H "X-API-Key: KEY" "https://api.mitom.vn/v1/news?link=/equities/apple-computer-inc"

GET /v1/financials — Báo cáo tài chính GET

Tham số	Mô tả
`link`	Đường dẫn mã. Trả `tables[]` (mảng các bảng số liệu).

curl -H "X-API-Key: KEY" "https://api.mitom.vn/v1/financials?link=/equities/apple-computer-inc"

GET /v1/calendar — Lịch kinh tế GET

Lịch sự kiện kinh tế trong ngày: giờ, quốc gia, mức quan trọng (1–3 sao), thực tế / dự báo / kỳ trước.

curl -H "X-API-Key: KEY" "https://api.mitom.vn/v1/calendar"

{ "events": [ { "time":"19:30", "country":"United States", "importance":3,
                "event":"Nonfarm Payrolls", "actual":"...", "forecast":"...", "previous":"..." } ] }

Mã lỗi

HTTP	Ý nghĩa
`200`	OK
`400`	Thiếu tham số (vd thiếu `q`/`link`)
`401`	Thiếu hoặc sai API key
`403`	Key đã bị vô hiệu hóa
`429`	Vượt rate limit (xem `Retry-After`)
`502`	Lỗi backend crawler