Doanh nghiệp & Thuế opengov/construction/publications

Danh mục văn bản công bố về chi phí xây dựng do cơ quan quản lý nhà nước về

Xây dựng và các Sở Xây dựng địa phương ban hành — khoảng 12.000 bản ghi trên tám mảng dữ liệu, nhiều nhất là công bố giá vật liệu (7.237) và chỉ số giá xây dựng (2.175). ĐIỀU PHẢI BIẾT TRƯỚC KHI DÙNG: đây là danh mục VĂN BẢN CÔNG BỐ, KHÔNG phải bảng giá chi tiết. Mỗi bản ghi cho biết số hiệu quyết định, cơ quan ban hành, địa phương áp dụng, ngày ban hành và ngày hiệu lực — tức là trả lời câu hỏi "văn bản nào đang có hiệu lực cho tỉnh X, năm Y", câu hỏi mà người lập dự toán phải trả lời trước khi mở bất kỳ bảng giá nào. Từng dòng đơn giá nằm trong tệp đính kèm của văn bản và dịch vụ này KHÔNG phục vụ tệp đó. `con_hieu_luc` trả về null khi nguồn ghi không rõ ràng — null nghĩa là CHƯA XÁC ĐỊNH, không phải là hết hiệu lực; nói sai một văn bản đã hết hiệu lực thành còn hiệu lực gây hậu quả trực tiếp lên dự toán. Phân trang cố định 30 bản ghi mỗi trang do nguồn quy định, nên endpoint này không có tham số `per_page`. Dịch vụ KHÔNG phục vụ họ tên người ký hay cán bộ soạn thảo/công bố văn bản.

GET https://api-tools.hitechcloud.vn/api/opengov/construction/publications Đã chép

Cần khoá API

Tham số

dataset enum · truy vấn bắt buộc

Mảng dữ liệu cần tra. BẮT BUỘC. Giá trị hợp lệ: dinh-muc, dinh-muc-chi-phi, don-gia, gia-vat-lieu, gia-nhan-cong, gia-ca-may, chi-so-gia, suat-von-dau-tu. Lấy danh sách kèm mô tả tại GET api/opengov/construction/datasets. Giá trị khác trả 422.

q string · truy vấn

Lọc theo tên văn bản công bố. Phép khớp do nguồn thực hiện.

year integer · truy vấn

Lọc theo năm ban hành, bốn chữ số. Giá trị khác trả 422.

page integer · truy vấn

Số trang, đếm từ 1. Mặc định 1. Mỗi trang 30 bản ghi — kích thước trang do nguồn quy định và không đổi được.

Mã trả về

200 Thành công.

401 Thiếu hoặc sai khoá API. Gửi kèm header X-API-Key.

404 Không tìm thấy dữ liệu tương ứng.

429 Vượt hạn mức của khoá. Xem header Retry-After.

curl --location 'https://api-tools.hitechcloud.vn/api/opengov/construction/publications?dataset=GIA_TRI&q=GIA_TRI&year=GIA_TRI&page=GIA_TRI' \ --header 'X-API-Key: $HITECH_API_KEY' \ --header 'Accept: application/json'

$response = Http::withHeaders([ 'X-API-Key' => env('HITECH_API_KEY'), ])->get('https://api-tools.hitechcloud.vn/api/opengov/construction/publications', [ 'dataset' => 'GIA_TRI', 'q' => 'GIA_TRI', 'year' => 'GIA_TRI', 'page' => 'GIA_TRI', ]); $data = $response->json();

import os, requests res = requests.get( "https://api-tools.hitechcloud.vn/api/opengov/construction/publications", headers={"X-API-Key": os.environ["HITECH_API_KEY"]}, params={ "dataset": "GIA_TRI", "q": "GIA_TRI", "year": "GIA_TRI", "page": "GIA_TRI", }, ) data = res.json()