Hướng dẫn sử dụng API ListAllSolicitor - vinades/api.dauthau.info GitHub Wiki
Tác dụng
Lấy các thông tin danh sách Bên mời thầu
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 | "ListAllSolicitor" | 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 Bên mời thầu) - Tối đa là 2000 | Optional | 1 |
| aproval_time_from | string | Thời gian phê duyệt từ ... Chú ý: viết đúng theo dạng iso 8601 | Required | 00:00:00 Ngày hiện tại |
| aproval_time_to | string | Thời gian phê duyệt đế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' => 'ListAllSolicitor', // Tên API được list bên dưới
'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
'page' => 1, //Mặc định là 1
'aproval_time_from' => '2021-03-31T09:32:00', // Mặc định là 00:00:00 Ngày hiện tại
'aproval_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 Bên mời thầu) - 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 8601aproval_time_from: Thời gian phê duyệt từ ... Chú ý: viết đúng theo dạng iso 8601aproval_time_to: Thời gian phê duyệt đế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": 20,
"page_size": 20,
"current_page": 1,
"total_elements": 399,
"content": [
{
"id": 11549,
"solicitor_code": "Z091042",
"org_code": "",
"title": "Công an tỉnh Lâm Đồng",
"address": "Số 04 Trần Bình Trọng, phường 5, thành phố Đà Lạt, t
ỉnh Lâm Đồng",
"phone": "0693449037",
"aproval_time": "2020-04-02T00:00:00"
},
{
"id": 119104,
"solicitor_code": "Z104308",
"org_code": "",
"title": "Trung tâm phát triển quỹ đất quận Hải An",
"address": "UBND quận Hải An- Đường Lê Hồng Phong - p. Đằng Hải-
Q. Hải An-TP. Hải Phòng",
"phone": "0914559266",
"aproval_time": "2021-04-06T00:00:00"
},
{
"id": 119817,
"solicitor_code": "Z105825",
"org_code": "",
"title": "CÔNG TY TNHH TƯ VẤN GIAO THÔNG, HẠ TẦNG, XÂY DỰNG SỐ 7
",
"address": "Số 94 Nguyễn Văn Trỗi, Khu phố 7, P.Hiệp Thành, TP.
Thủ Dầu Một, T. Bình Dương, Việt Nam",
"phone": "0913249487",
"aproval_time": "2021-05-31T00:00:00"
},
{
"id": 121465,
"solicitor_code": "Z109046",
"org_code": "",
"title": "Phòng Tài chính - Kế hoạch huyện Lục Nam",
"address": "Phố Bình Minh, thị trấn Đồi Ngô, huyện Lục nam",
"phone": "0965055498",
"aproval_time": "2021-10-06T00:00:00"
},
{
"id": 122118,
"solicitor_code": "Z110488",
"org_code": "",
"title": "Ban quản lý dự án đầu tư công trình giao thông Thanh H
óa",
"address": "Số 46, đường Bùi Khắc Nhất, phường Đông Hương, thành
phố Thanh Hóa",
"phone": "0912000617",
"aproval_time": "2021-12-02T00:00:00"
},
{
"id": 527,
"solicitor_code": "Z025978",
"org_code": "vn0301514513",
"title": "Bệnh viện Hùng Vương",
"address": "128 Hồng Bàng",
"phone": "02838558532",
"aproval_time": "2022-04-16T00:00:00"
},
{
"id": 1248,
"solicitor_code": "Z030180",
"org_code": "vnz000007443",
"title": "Trường Đại học An ninh nhân dân",
"address": "Km 18, xa lộ Hà Nội, phường Linh Trung, quận Thủ Đức
, thành phố Hồ Chí Minh",
"phone": "02838963883",
"aproval_time": "2022-04-16T00:00:00"
},
{
"id": 1372,
"solicitor_code": "Z021465",
"org_code": "vn0106049358",
"title": "Học viện Quân y",
"address": "Số 160 Đường Phùng Hưng, Quận Hà Đông, Thành phố Hà
Nội",
"phone": "0986626626",
"aproval_time": "2022-04-16T00:00:00"
},
{
"id": 1723,
"solicitor_code": "Z071305",
"org_code": "vnz000008936",
"title": "Phòng quản lý đô thị thành phố Lào Cai",
"address": "Số 591 Đường Hoàng Liên, thành phố Lào Cai, tỉnh Lào
Cai",
"phone": "(0214)3827314",
"aproval_time": "2022-04-16T00:00:00"
},
{
"id": 1850,
"solicitor_code": "Z035400",
"org_code": "vn3300269328",
"title": "Sở Xây dựng tỉnh Thừa Thiên Huế",
"address": "02 đường Nguyễn Trường Tộ, phường Vĩnh Ninh, thành p
hố Huế, tỉnh Thừa Thiên Huế",
"phone": "02343822120",
"aproval_time": "2022-04-16T00:00:00"
},
{
"id": 2233,
"solicitor_code": "Z029817",
"org_code": "vn3701419595",
"title": "Ban Quản lý dự án đầu tư xây dựng thành phố Thủ Dầu Mộ
t",
"address": "161 đường Yersin, phường Phú Cường, thành phố Thủ Dầ
u Một, tỉnh Bình Dương",
"phone": "02743823964",
"aproval_time": "2022-04-16T00:00:00"
},
{
"id": 2333,
"solicitor_code": "Z031933",
"org_code": "vn1900614050",
"title": "Ban Quản lý dự án đầu tư xây dựng các công trình giao
thông tỉnh Bạc Liêu",
"address": "Số 02-08 - Đường Bế Văn Đàn - Phường 7 - Thành phố B
ạc Liêu - Tỉnh Bạc Liêu",
"phone": "0918197798",
"aproval_time": "2022-04-16T00:00:00"
},
{
"id": 3258,
"solicitor_code": "Z038382",
"org_code": "vn0103710298",
"title": "Ban Quản lý dự án đầu tư xây dựng thị xã Sơn Tây",
"address": "Số 14, phố Lê Lợi",
"phone": "02433618176",
"aproval_time": "2022-04-16T00:00:00"
},
{
"id": 3541,
"solicitor_code": "Z035372",
"org_code": "vn3101022453",
"title": "Ban quản lý dự án môi trường và biến đổi khí hậu thành
phố Đồng Hới",
"address": "34 Trần Quang Khải",
"phone": "02326268768",
"aproval_time": "2022-04-16T00:00:00"
},
{
"id": 5723,
"solicitor_code": "Z034625",
"org_code": "vnz000005287",
"title": "Bộ chỉ huy quân sự tỉnh Vĩnh Phúc",
"address": "Đường Lam Sơn - Phường Tích Sơn - TP Vĩnh Yên - Tỉnh
Vĩnh Phúc",
"phone": "02113862491",
"aproval_time": "2022-04-16T00:00:00"
},
{
"id": 6564,
"solicitor_code": "Z023346",
"org_code": "vn0100214132",
"title": "Sở Công thương Hà Nội",
"address": "331 Cầu Giấy, Hà Nội",
"phone": "0422155574",
"aproval_time": "2022-04-16T00:00:00"
},
{
"id": 6913,
"solicitor_code": "Z042496",
"org_code": "vnz000010190",
"title": "Ban Quản lý dự án xây dựng cơ bản huyện Lạc Thủy, tỉnh
Hòa Bình",
"address": "Khu 3, thị trấn Chi Nê, huyện Lạc Thủy, tỉnh Hòa Bìn
h",
"phone": "0989242945",
"aproval_time": "2022-04-16T00:00:00"
},
{
"id": 9331,
"solicitor_code": "Z039300",
"org_code": "vn2900534618",
"title": "Uỷ ban nhân dân xã Nghi Phong",
"address": "xã Nghi Phong, huyện Nghi Lộc, tỉnh Nghệ An",
"phone": "02383616146",
"aproval_time": "2022-04-16T00:00:00"
},
{
"id": 11279,
"solicitor_code": "Z036086",
"org_code": "vn5500155762",
"title": "Sở Xây dựng tỉnh Sơn La",
"org_code": "vn5500155762",
"title": "Sở Xây dựng tỉnh Sơn La",
"address": "Tầng 01,02 tòa nhà 6 tầng T2, trụ sở Trung tâm Hành
chính tỉnh Sơn La",
"phone": "02123852265",
"aproval_time": "2022-04-16T00:00:00"
},
{
"id": 15983,
"solicitor_code": "Z076416",
"org_code": "vn4100290028",
"title": "Sở Xây dựng Bình Định",
"address": "Số 32 đường Lý Thường Kiệt, thành phố Quy Nhơn",
"phone": "02563822882",
"aproval_time": "2022-04-16T00:00:00"
}
],
"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 Bên mời thầu bên DauThau.infosolicitor_code: MÃ CƠ QUANorg_code: MÃ ĐỊNH DANH (MSC MỚI)title: TÊN BÊN MỜI THẦUaddress: ĐỊA CHỈphone: SỐ ĐIỆN THOẠIaproval_time: THỜI GIAN PHÊ DUYỆT
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