Hướng dẫn sử dụng API ListAllDadtpt - vinades/api.dauthau.info GitHub Wiki
Tác dụng
Lấy các thông tin danh sách Dự án đầu tư phát triển
Tham số có thể truyền vào:
Request Parameters
| Parameter | Type | Description | Required | Default |
|---|---|---|---|---|
| apikey | string | Khóa truy cập | Required | |
| timestamp | int | Thời gian hiện tại dạng 11 số | Required | |
| hashsecret | string | Mã bí mật đã được băm | Required | |
| language | varchar(02) | Ngôn ngữ trả về (Chấp nhận giá trị 'vi' hoặc 'en') | Required | |
| action | string | "ListAllDadtpt" | Required | |
| is_change | int | Đánh dấu lấy toàn bộ dữ liệu hay chỉ lấy những dữ liệu có sự thay đổi | Optional | 0 |
| change_time_from | string | Thời điểm cập nhật từ ... Chú ý: viết đúng theo dạng iso 8601 | Optional | 00:00:00 Ngày hiện tại |
| change_time_to | string | Thời điểm cập nhật đến ... Chú ý: viết đúng theo dạng iso 8601 | Optional | 23:59:59 ngày hiện tại |
| page | string | Lấy dữ liệu của trang số mấy (Mỗi trang 20 Dự án đầu tư phát triển) - Tối đa là 2000 | Optional | 1 |
| public_time_from | string | Thời điểm công bố từ ... Chú ý: viết đúng theo dạng iso 8601 | Required | 00:00:00 Ngày hiện tại |
| public_time_to | string | Thời điểm công bố đến ... Chú ý: viết đúng theo dạng iso 8601 | Required | 23:59:59 ngày hiện tại |
- hashsecret: Mã bí mật mỗi lần resquest, thường có 2 cách băm:
- password_hash($apisecret . '_' . $timestamp, PASSWORD_DEFAULT) với phương thức xác thực là password_verify
- md5($apisecret . '_' . $timestamp) với phương thức xác thực là md5_verify
- Tìm hiểu về dạng iso 8601 tại đây: ISO_8601
- Hệ thống chấp nhận 1 số kiểu viết ngày giờ như sau:
- 2023-02-16T06:05:40+07:00
- 2023-02-16T06:05:40
- 2023-02-16
Ví dụ viết bằng PHP:
$request = [
'apikey' => '...', // Khóa được cung cấp
'timestamp' => '...', // Thời gian resquest sai lệch với giờ máy chủ không quá 5 giây
'hashsecret' => '...', // Mã bí mật mỗi lần resquest = password_hash($apisecret . '_' . $timestamp, PASSWORD_DEFAULT);
'action' => 'ListAllDadtpt', // Tên API được list bên dưới
'page' => 1, //Mặc định là 1
'is_change' => 0, //Mặc định là 0
'change_time_from' => '2021-03-31T09:32:00', // Mặc định là 00:00:00 Ngày hiện tại
'change_time_to' => '2021-04-23T15:25:28', //Mặc định là 23:59:59 Ngày hiện tại
'public_time_from' => '2021-03-31T09:32:00', // Mặc định là 00:00:00 Ngày hiện tại
'public_time_to' => '2021-04-23T15:25:28' //Mặc định là 23:59:59 Ngày hiện tại
];
page: Lấy dữ liệu của trang số mấy (Mỗi trang 20 Dự án đầu tư phát triển) - Tối đa là 2000is_change: 0: Lấy toàn bộ dữ liệu; 1: lấy các dữ liệu có sự thay đổichange_time_from: Thời điểm cập nhật từ ... Chú ý: viết đúng theo dạng iso 8601change_time_to: Thời điểm cập nhật đến ... Chú ý: viết đúng theo dạng iso 8601public_time_from: Thời điểm công bố từ ... Chú ý: viết đúng theo dạng iso 8601public_time_to: Thời điểm công bố đến ... Chú ý: viết đúng theo dạng iso 8601
Dữ liệu trả về nếu API truy cập thành công
{
"status": "success",
"code": "0000",
"message": "",
"total_pages": 837,
"page_size": 20,
"current_page": 1,
"total_elements": 16725,
"content": [
{
"id": 2463636,
"name": "Sửa chữa phòng học và bếp ăn trường Mầm non Khe Mo – Điểm trường Ao Rôm",
"code": "PR2300014031-01",
"investor": "Ủy ban nhân dân xã Khe Mo",
"public_time": "2023-04-08T16:16:16",
"num_khlcnt": 1
},
{
"id": 2463637,
"name": "Trường PTDT nội trú THCS&THPT Yên Minh, huyện Yên Minh; Hạng mục: Sửa chữa 02 nhà lưu trú học sinh 3 tầng, nhà lưu trú học sinh 2 tầng và nhà ăn, bếp nấu ăn học si
nh",
"code": "PR2300014033-00",
"investor": "Sở Giáo dục và Đào tạo Hà Giang",
"public_time": "2023-04-08T16:16:16",
"num_khlcnt": 1
},
{
"id": 2463638,
"name": "Sửa chữa, cải tạo đường Cốc Lùng - Kéo Lầm, xã Hoa Thám, huyện Bình Gia",
"code": "PR2300014034-00",
"investor": "Ban Quản lý dự án đầu tư xây dựng huyện Bình Gia",
"public_time": "2023-04-08T16:16:16",
"num_khlcnt": 0
},
{
"id": 2463639,
"name": "Trường THPT Việt Lâm, huyện Vị Xuyên; Hạng mục: Sửa chữa nhà lớp học 3 tầng 12 phòng và nhà lớp học 2 tầng 8 phòng",
"code": "PR2300014035-00",
"investor": "Sở Giáo dục và Đào tạo Hà Giang",
"public_time": "2023-04-08T16:16:16",
"num_khlcnt": 1
},
{
"id": 2463640,
"name": "Trường THPT Chuyên Hà Giang; Hạng mục: Sửa chữa nhà hiệu bộ, 02 nhà lớp học",
"code": "PR2300014036-00",
"investor": "Sở Giáo dục và Đào tạo Hà Giang",
"public_time": "2023-04-08T16:16:16",
"num_khlcnt": 1
},
{
"id": 2463641,
"name": "Trường THPT Xín Mần, huyện Xín Mần; Hạng mục: Sửa chữa nhà lớp học 2 tầng, nhà công vụ giáo viên (2 nhà), nhà bếp nấu ăn, sân bê tông khu nhà công vụ và cổng, tườn
g rào khu nhà lưu trú học sinh",
"code": "PR2300014037-00",
"investor": "Sở Giáo dục và Đào tạo Hà Giang",
"public_time": "2023-04-08T16:16:16",
"num_khlcnt": 1
},
{
"id": 2463642,
"name": "Trường THPT Kim Ngọc, huyện Bắc Quang; Hạng mục: Sửa chữa sân bê tông, rãnh thoát nước và bồn cây",
"code": "PR2300014039-00",
"investor": "Sở Giáo dục và Đào tạo Hà Giang",
"public_time": "2023-04-08T17:17:17",
"num_khlcnt": 1
},
{
"id": 2463643,
"name": "Trường THPT Vị Xuyên, huyện Vị Xuyên; Hạng mục: Sửa chữa nhà lớp học 3 tầng và nhà lớp học 2 tầng (nhà B)",
"code": "PR2300014040-00",
"investor": "Sở Giáo dục và Đào tạo Hà Giang",
"public_time": "2023-04-08T17:17:17",
"num_khlcnt": 1
},
{
"id": 2463644,
"name": "Cải tạo, sửa chữa nhà làm việc 2 tầng, sân, cổng, hàng rào, nhà để xe UBND xã Khe Mo",
"code": "PR2300014038-00",
"investor": "Ủy ban nhân dân xã Khe Mo",
"public_time": "2023-04-08T17:17:17",
"num_khlcnt": 1
},
{
"id": 2463645,
"name": "Trường THPT Hoàng Su Phì, huyện Hoàng Su Phì; Hạng mục: Sửa chữa nhà lớp học 3 tầng, nhà lớp học 2 tầng, nhà công vụ giáo viên (2 nhà), nhà lưu trú học sinh và nhà
vệ sinh học sinh",
"code": "PR2300014041-00",
"investor": "Sở Giáo dục và Đào tạo Hà Giang",
"public_time": "2023-04-08T17:17:17",
"num_khlcnt": 1
},
{
"id": 2463646,
"name": "Xây dựng bãi tập kết rác thải rắn thôn Thụy Lôi, xã Thụy Lâm",
"code": "PR2300014042-00",
"investor": "Ủy ban nhân dân xã Thụy Lâm",
"public_time": "2023-04-08T17:17:17",
"num_khlcnt": 0
},
{
"id": 2463647,
"name": "Xây dựng và lắp đặt CSHT trạm di động Vinaphone Sín Câu – VNPT Lai Châu năm 2023",
"code": "PR2300014043-00",
"investor": "Viễn thông Lai Châu",
"public_time": "2023-04-08T17:17:17",
"num_khlcnt": 0
},
{
"id": 2463648,
"name": "Xây dựng và lắp đặt CSHT trạm di động Vinaphone Chi Sáng - VNPT Lai Châu năm 2023",
"code": "PR2300014044-00",
"investor": "Viễn thông Lai Châu",
"public_time": "2023-04-08T17:17:17",
"num_khlcnt": 0
},
{
"id": 2463649,
"name": "Xây dựng và lắp đặt CSHT trạm Remote Sector Vinaphone Trung Xung A, Cấp 2 Hồng Thu - VNPT Lai Châu năm 2023",
"code": "PR2300014045-00",
"investor": "Viễn thông Lai Châu",
"public_time": "2023-04-08T18:18:18",
"num_khlcnt": 0
},
{
"id": 2463650,
"name": "Xây dựng và lắp đặt CSHT trạm Remote Sector Vinaphone Y Tế Làng Mô, Tả San, Hồ Suối Tủng – VNPT Lai Châu năm 2023",
"code": "PR2300014046-00",
"investor": "Viễn thông Lai Châu",
"public_time": "2023-04-08T18:18:18",
"num_khlcnt": 0
},
{
"id": 2463651,
"name": "Quang hóa tuyến truyền dẫn cho các trạm di động Chi Sáng, Tả San, Trung Xung A - VNPT Lai Châu năm 2023",
"code": "PR2300014047-00",
"investor": "Viễn thông Lai Châu",
"public_time": "2023-04-08T18:18:18",
"num_khlcnt": 0
},
{
"id": 2463652,
"name": "Xây dựng tuyến cáp quang cung cấp dịch vụ cho thủy điện Nậm Nghẹ 1A; Pắc Ma thuộc TTVT Mường Tè - VNPT Lai Châu năm 2023",
"code": "PR2300014048-00",
"investor": "Viễn thông Lai Châu",
"public_time": "2023-04-08T18:18:18",
"num_khlcnt": 0
},
{
"id": 2463653,
"name": "Kiểm định chất lượng các công trình cột Anten trên địa bàn tỉnh Lai Châu - VNPT Lai Châu năm 2023",
"code": "PR2300014050-00",
"investor": "Trường Đại học Cần Thơ",
"public_time": "2023-04-08T19:19:19",
"num_khlcnt": 0
},
{
"id": 2463655,
"name": "Sửa chữa vỉa hè và hệ thống thoát nước đường 30/4 khóm 2 thị trấn Châu Thành",
"code": "PR2300014052-00",
"investor": "Ủy ban nhân dân thị trấn Châu Thành",
"public_time": "2023-04-08T19:19:19",
"num_khlcnt": 1
}
],
"is_pay": true
}
total_pages: Tổng số trangpage_size: Số dữ liệu trên 1 trang (hiện tại để 20)current_page: Trang hiện tạitotal_elements: Tổng số dữ liệuis_pay: Request có tính phí không
content (mảng dữ liệu cần quan tâm)
id: ID Dự án đầu tư phát triển bên DauThau.infoname: Tên dự áncode: Số Dự án đầu tư phát triểninvestor: Tên bên mời thầupublic_time: Thời điểm công bốnum_khlcnt: Số khlcnt
Các mã lỗi
1001: Maximum number of pages is 2000 - Giá trị page truyền vào tối đa là 20001002: No data!!! - Không có dữ liệu trả về1009: Error, Contact Admin - Lỗi hệ thống chưa xác định