🔌 API dữ liệu pháp luật & Chính phủ

Dữ liệu mở, có cấu trúc — văn bản từ ~490 trang Chính phủ, hỏi-đáp chính thức từ các cơ quan, và tín hiệu thay đổi hằng ngày. API REST, JSON, CORS bật sẵn. Dữ liệu hành chính/pháp lý của Nhà nước không thuộc đối tượng bảo hộ quyền tác giả (Luật SHTT Đ.15); chúng tôi trích dẫn và dẫn nguồn gốc.

1. Lấy API key (miễn phí)

Key chỉ hiển thị một lần — hãy lưu lại.

2. Hạn mức theo tier

TierHạn mứcGiới hạn mỗi lần
free500 req/ngày100 dòng/lần
pro50.000 req/ngày1.000 dòng/lần
enterprise5.000.000 req/ngày5.000 dòng/lần

Hạn mức tính theo ngày (UTC), gộp tất cả endpoint. Header phản hồi: X-RateLimit-Limit, X-RateLimit-Used, X-RateLimit-Tier. Nâng tier: liên hệ qua email đã đăng ký.

3. Xác thực

curl -H "Authorization: Bearer <API_KEY>" \
  "https://vandap.com/api/v1/dataset/gov-items?limit=20"

Hoặc dùng query: ?api_key=<API_KEY>.

4. Endpoints

GET /api/v1/dataset/gov-items
Văn bản/tin từ trang Chính phủ. Tham số: ?domain= ?since=YYYY-MM-DD ?page= ?limit=.
GET /api/v1/dataset/agency-qa
Hỏi-đáp chính thức (cơ quan + ngày + văn bản dẫn chiếu). Tham số: ?domain= ?page= ?limit=.
GET /api/v1/dataset/changes
Tín hiệu thay đổi (mới/đã sửa) từ crawl delta hằng ngày. Tham số: ?days= ?domain= ?limit=.
GET /api/v1/dataset/usage
Mức sử dụng + hạn mức còn lại của key.
POST /api/v1/dataset/keys
Tạo key miễn phí. Body JSON: { "email": "...", "label": "..." } (đều tuỳ chọn).

Tìm kiếm tương tác: /tim-kiem · Văn bản: /van-ban