Vùng thu mua sắn, kèm toạ độ tâm và ranh giới để vẽ bản đồ.
Thao tác và endpoint
| Thao tác | Endpoint |
|---|---|
| Xem một | GET /raw_regions/{id} |
| Danh sách | GET /raw_regions?updatedSince=…&page=1&size=50 |
| Định nghĩa trường | GET /_schema/raw_regions |
Khoá tra cứu: id — ID bản ghi do QBIS cấp (vd 8812345).
Trường dữ liệu
| Trường | Kiểu | Bắt buộc | Chỉ đọc | Lọc | Mô tả |
|---|---|---|---|---|---|
id | chuỗi | — | có | ID bản ghi do QBIS cấp. Khoá tra cứu (vd 8812345) | |
name | chuỗi | có | có | Tên vùng | |
province | chuỗi | không | có | Tỉnh | |
officer | chuỗi | không | có | Cán bộ phụ trách | |
areaHa | số | không | Diện tích (ha) | ||
expectedYieldKg | số | không | Sản lượng dự kiến | ||
color | chuỗi | không | Màu hiển thị | ||
center | chuỗi | không | Toạ độ tâm | ||
boundary | chuỗi dài | không | Ranh giới (JSON toạ độ) |
Ví dụ tra cứu
curl https://db.qbis.vn/open/api/v1/raw_regions/8812345 \
-H "X-Store-Key: YOUR_STORE_KEY" -H "X-Api-Key: YOUR_API_KEY" -H "X-Secret-Key: YOUR_SECRET_KEY"HTTP 200, data là bản ghi. Không có → 404 NOT_FOUND.
{
"status": 200,
"success": true,
"code": "OK",
"message": "",
"data": {
"id": "8812345",
"name": "Nguyễn Văn An",
"province": "Nội dung tỉnh",
"officer": "Nội dung cán bộ phụ trách",
"areaHa": 1,
"expectedYieldKg": 1,
"color": "Nội dung màu hiển thị",
"center": "Nội dung toạ độ tâm",
"boundary": "Nội dung ranh giới (JSON toạ độ)"
}
}Ví dụ danh sách
curl "https://db.qbis.vn/open/api/v1/raw_regions?updatedSince=05%2F11%2F2026%2008%3A00&page=1&size=50" \
-H "X-Store-Key: YOUR_STORE_KEY" -H "X-Api-Key: YOUR_API_KEY" -H "X-Secret-Key: YOUR_SECRET_KEY"Trả data.records[] (mỗi phần tử như data ở ví dụ tra cứu, không kèm dòng con), page, size, count, hasMore — mục 3.3. Lọc đúng bằng theo: name, province, officer.