Doanh nghiệp & Thuế opengov/statistics/tables/{database}/{table}/data

Ô số liệu thống kê của một bảng

Trả về từng dòng gồm mảng `chieu` (nhãn của từng chiều, đúng thứ tự công bố ở trường `chieu` cấp trên) và mảng `gia_tri`. Dịch vụ nhận và trả NHÃN chứ không phải mã nội bộ: gửi `"Năm":["2024"]` và `"Địa phương":["Hà Nội"]`, nhận lại đúng những nhãn đó kèm con số. Ô KHÔNG CÓ SỐ LIỆU trả về null, KHÔNG phải 0 — trong thống kê "chưa thu thập được" và "bằng không" là hai điều khác hẳn nhau, và gộp chúng lại là làm sai lệch mọi phép tính trung bình. Không truyền `select` thì lấy trọn bảng; bảng quá lớn (trên 60.000 ô) bị từ chối bằng 422 kèm hướng dẫn thu hẹp, thay vì để lượt gọi chạy tới lúc hết thời gian chờ.

GET https://api-tools.hitechcloud.vn/api/opengov/statistics/tables/{database}/{table}/data Đã chép

Cần khoá API

Tham số

database string · đường dẫn bắt buộc

Giá trị truyền trên đường dẫn.

table string · đường dẫn bắt buộc

Giá trị truyền trên đường dẫn.

select string · truy vấn

Bộ chọn theo NHÃN, dạng đối tượng JSON: mã chiều → danh sách nhãn giá trị. Ví dụ select={"Năm":["2024"],"Địa phương":["Hà Nội","CẢ NƯỚC"]}. Lấy tên chiều và nhãn hợp lệ tại GET api/opengov/statistics/tables/{database}/{table}. Chiều không nêu trong select được lấy toàn bộ giá trị. Bỏ trống tham số này thì lấy trọn bảng, và bảng trên 60.000 ô sẽ bị từ chối bằng 422. Nhãn sai hoặc chiều không tồn tại trả 422 kèm tên chiều hợp lệ — KHÔNG lặng lẽ bỏ qua bộ lọc, vì trả về toàn bảng trong khi người gọi tin rằng đã lọc là kiểu sai không có triệu chứng.

page integer · truy vấn

Số trang, đếm từ 1. Mặc định 1. Phân trang áp trên KẾT QUẢ đã lọc.

per_page integer · truy vấn

Số dòng số liệu mỗi trang, 1–1000. Mặc định 200.

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/statistics/tables/gia-tri/gia-tri/data?select=GIA_TRI&page=GIA_TRI&per_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/statistics/tables/gia-tri/gia-tri/data', [ 'select' => 'GIA_TRI', 'page' => 'GIA_TRI', 'per_page' => 'GIA_TRI', ]); $data = $response->json();

import os, requests res = requests.get( "https://api-tools.hitechcloud.vn/api/opengov/statistics/tables/gia-tri/gia-tri/data", headers={"X-API-Key": os.environ["HITECH_API_KEY"]}, params={ "select": "GIA_TRI", "page": "GIA_TRI", "per_page": "GIA_TRI", }, ) data = res.json()