API dữ liệu Việt Nam
457 endpoint tra cứu dữ liệu doanh nghiệp, thuế, hạ tầng mạng, tên miền, địa giới hành chính và đấu thầu. Mỗi phản hồi đều kèm nguồn dữ liệu và thời điểm lấy, để bạn biết dữ liệu mới hay đã đệm.
Bắt đầu
1
Lấy khoá API
Đăng nhập portal, vào Khoá API và tạo khoá. Chọn đúng nhóm dịch vụ bạn cần — khoá chỉ gọi được những nhóm đã bật.
2
Gửi kèm mỗi yêu cầu
Đặt khoá vào header X-API-Key. Thiếu khoá thì máy chủ trả 401 kèm JSON giải thích, không trả trang HTML.
3
Thử ngay tại đây
Mở bất kỳ endpoint nào, dán khoá vào ô Thử ngay ở cột phải và bấm gửi. Khoá chỉ lưu trong trình duyệt của bạn.
Nhóm dịch vụ
Mạng & Hạ tầng
46 endpoint
IP lookup, ASN, lịch sử IP tên miền
Quét cổng, nhận diện CDN, traceroute
Tính subnet, chuyển đổi IP, tra MAC
Tên miền & SSL
51 endpoint
WHOIS, kiểm tra tên miền trống
Kiểm tra SSL, tạo và giải mã CSR
Dữ liệu VNNIC, tên miền nhạy cảm
Email & DNS
17 endpoint
Kiểm tra SPF, DKIM, DMARC, MX
Blacklist, phân tích header thư
DNS propagation, kiểm thử SMTP
Công cụ lập trình
25 endpoint
Kiểm tra JSON, cron, chmod, HTTP header
Nhận dạng định dạng tệp, đọc metadata ảnh
Vòng đời hỗ trợ phần mềm, định dạng theo vùng
SEO & Web
13 endpoint
Kiểm tra thẻ meta, Open Graph
robots.txt, trích xuất sitemap
Nhận diện công nghệ, chụp màn hình
Dữ liệu Việt Nam
66 endpoint
Tỉnh · phường xã sau sáp nhập
Đấu thầu, văn bản pháp luật
Âm dương lịch, tra vi phạm giao thông
Xuất nhập khẩu & Logistics
15 endpoint
Mã HS, tra biểu thuế theo chương và nhóm
Mã cảng biển và cửa khẩu UN/LOCODE
Mã sân bay IATA · ICAO, tra theo thành phố
Dược phẩm & Y tế
5 endpoint
Thuốc được cấp số đăng ký lưu hành
Giá thuốc kê khai và kết quả trúng thầu
Tra dải giá một mặt hàng qua các gói thầu
Mã hoá & Kiểm tra
39 endpoint
Băm, HMAC, JWT, sinh khoá và mật khẩu
Chuyển đổi base16 · 32 · 58 · 62 · 64, UUID v1–v7
Kiểm số Luhn, IBAN, ISBN, mã công-ten-nơ ISO 6346
Chuyển đổi & Định dạng
45 endpoint
Bỏ dấu, slug, Telex · VNI, chuẩn hoá Unicode
Đơn vị đo, màu sắc, tương phản WCAG
Mã vạch GS1 · GTIN, toạ độ và geohash
Thời gian & Lịch
18 endpoint
Âm lịch, ngày nghỉ lễ Việt Nam đủ 12 ngày
Múi giờ IANA, mốc chuyển giờ
Đếm ngày làm việc, cộng trừ theo lịch
Tài chính & Tỷ giá
16 endpoint
Tỷ giá ngân hàng và tỷ giá tham chiếu ECB
Giá vàng theo chỉ và theo lượng
Lãi kép, trả góp, NPV · IRR, khấu hao
Pháp lý & Thủ tục
28 endpoint
Văn bản quy phạm pháp luật đã đăng công báo
Đấu thầu, mua sắm công
Thuế thu nhập cá nhân, bảo hiểm, lệ phí môn bài
QR & Thanh toán
5 endpoint
Sinh mã VietQR theo chuẩn NAPAS
QR danh thiếp vCard, QR tuỳ biến
Đối soát PayOS, ZaloPay, MoMo
Doanh nghiệp & Thuế
68 endpoint
Tra mã số thuế cá nhân · doanh nghiệp
Đăng ký kinh doanh, ngành nghề
Hoá đơn điện tử, đối chiếu MISA
Quy ước chung
Xác thực
Mọi endpoint đều cần khoá gửi qua header
X-API-Key. Có thể dùng Authorization: Bearer <khoá> thay thế.
Định dạng
Phản hồi luôn là JSON, mã hoá UTF-8. Lỗi cũng là JSON, không bao giờ là HTML.
Bộ đệm
Dữ liệu lấy từ nguồn ngoài được đệm lại; trường
cached_at cho biết thời điểm lấy thật.
Giới hạn tốc độ
Tính theo từng khoá, đặt trong portal. Vượt ngưỡng trả
429 kèm header Retry-After.
Giới hạn IP
Khoá có thể khoá theo IP hoặc dải CIDR. Gọi từ IP ngoài danh sách trả
403 ip_not_allowed.
Phạm vi
Khoá chỉ gọi được nhóm dịch vụ đã bật. Sai nhóm trả
403 scope_not_allowed.
Mã lỗi
401
missing_api_key
Không gửi header X-API-Key.
401
invalid_api_key
Khoá không tồn tại, đã bị thu hồi hoặc đã hết hạn.
403
scope_not_allowed
Khoá không được cấp quyền cho nhóm dịch vụ của endpoint này.
403
ip_not_allowed
Yêu cầu đến từ IP không nằm trong danh sách của khoá.
429
rate_limit_exceeded
Vượt giới hạn lượt gọi mỗi phút. Xem header Retry-After.
404
not_found
Đường dẫn không tồn tại, hoặc không có dữ liệu tương ứng.
503
source_unavailable
Nguồn dữ liệu bên ngoài không phản hồi. Dữ liệu đệm vẫn dùng được.