Hướng dẫn sử dụng API GetDetailKhlcnt - vinades/api.dauthau.info GitHub Wiki
Tác dụng
Lấy các thông tin chi tiết của Khlcnt
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 | "GetDetailKhlcnt" | Required | |
| id | int | ID của KHLCNT bên DauThau.info | Optional* | |
| code | string | Mã KHLCNT | Optional* |
(*) Lưu ý: Cần truyền ít nhất một trong hai tham số id hoặc code
- 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
Ví dụ sử dụng:
Cách 1: Truy vấn theo ID
$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' => 'GetDetailKhlcnt', // Tên API được list bên dưới
'id' => 1, // ID của KHLCNT bên DauThau.info
];
Cách 2: Truy vấn theo mã KHLCNT
$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' => 'GetDetailKhlcnt', // Tên API được list bên dưới
'code' => 'PL2300094690-00', // Mã KHLCNT
];
Mô tả tham số:
id: ID của KHLCNT bên DauThau.infocode: Mã KHLCNT (Mã kế hoạch lựa chọn nhà thầu)
Dữ liệu trả về nếu API truy cập thành công
{
"status": "success",
"code": "0000",
"message": "",
"content": {
"id": 1182814,
"code": "PL2300094690-00",
"addtime": "2023-06-14T14:03:54",
"project_name": "Bảo dưỡng, sửa chữa trụ sở Ủy ban MTTQ Việt Nam tỉnh Thái Bình",
"investor": "UỶ BAN MẶT TRẬN TỔ QUỐC TỈNH THÁI BÌNH",
"title": "Bảo dưỡng, sửa chữa trụ sở Ủy ban MTTQ Việt Nam tỉnh Thái Bình",
"isoda": "Không",
"investform": "Không sử dụng vốn ODA",
"total_investment": "253,463,000 VND",
"classify": "Chi thường xuyên",
"approval_org": "Ủy ban MTTQ Việt Nam tỉnh Thái Bình",
"approval_date": "2023-05-12T23:59:59",
"no_approval": "Số 608/QĐ-MTTQ-BTT",
"update_time": "09:40 2025-09-21",
"arr_contract": [
{
"code": "BP2300272883",
"time_todo": "5 ngày",
"name_domestic": "Trong nước",
"linh_vuc": "Tư vấn",
"process_apply": "Luật đấu thầu",
"price_format": "2.200.000 VNĐ",
"owner_equity": "Vốn bảo dưỡng, sửa chữa tài sản công năm 2023",
"type_choose": "Chỉ định thầu rút gọn",
"method_choose": "Một giai đoạn một túi hồ sơ",
"time_choose": "Quý II, 2023",
"type_contract": "Trọn gói",
"is_prequalification": "Không",
"bid_location": "Thành phố Thái Bình, Tỉnh Thái Bình",
"is_internet": "Trực tiếp",
"price_words": "Hai triệu hai trăm nghìn",
"est_price_format": null,
"est_price_words": null
},
{
"code": "BP2300272875",
"time_todo": "8 ngày",
"name_domestic": "Trong nước",
"linh_vuc": "Tư vấn",
"process_apply": "Luật đấu thầu",
"price_format": "2.200.000 VNĐ",
"owner_equity": "Vốn bảo dưỡng, sửa chữa tài sản công năm 2023",
"type_choose": "Chỉ định thầu rút gọn",
"method_choose": "Một giai đoạn một túi hồ sơ",
"time_choose": "Quý II, 2023",
"type_contract": "Trọn gói",
"is_prequalification": "Không",
"bid_location": "Thành phố Thái Bình, Tỉnh Thái Bình",
"is_internet": "Trực tiếp",
"price_words": "Hai triệu hai trăm nghìn",
"est_price_format": null,
"est_price_words": null
},
{
"code": "BP2300272884",
"time_todo": "45 ngày",
"name_domestic": "Trong nước",
"linh_vuc": "Tư vấn",
"process_apply": "Luật đấu thầu",
"price_format": "7.242.457 VNĐ",
"owner_equity": "Vốn bảo dưỡng, sửa chữa tài sản công năm 2023",
"type_choose": "Chỉ định thầu rút gọn",
"method_choose": "Một giai đoạn một túi hồ sơ",
"time_choose": "Quý II, 2023",
"type_contract": "Trọn gói",
"is_prequalification": "Không",
"bid_location": "Thành phố Thái Bình, Tỉnh Thái Bình",
"is_internet": "Trực tiếp",
"price_words": "Bảy triệu hai trăm bốn mươi hai nghìn bốn trăm năm mươi bảy",
"est_price_format": null,
"est_price_words": null
},
{
"code": "BP2300272892",
"time_todo": "45 ngày",
"name_domestic": "Trong nước",
"linh_vuc": "Xây lắp",
"process_apply": "Luật đấu thầu",
"price_format": "220.470.524 VNĐ",
"owner_equity": "Vốn bảo dưỡng, sửa chữa tài sản công năm 2023",
"type_choose": "Chào hàng cạnh tranh",
"method_choose": "Một giai đoạn một túi hồ sơ",
"time_choose": "Quý II, 2023",
"type_contract": "Trọn gói",
"is_prequalification": "Không",
"bid_location": "Thành phố Thái Bình, Tỉnh Thái Bình",
"is_internet": "Qua mạng",
"price_words": "Hai trăm hai mươi triệu bốn trăm bảy mươi nghìn năm trăm hai mươi bốn",
"est_price_format": null,
"est_price_words": null
}
]
},
"is_pay": 1
}
content (mảng dữ liệu cần quan tâm)
id: ID KHCLNTcode: Số KHLCNTaddtime: Thời điểm công bốproject_name: Tên dự áninvestor: Bên mời thầutitle: Tên KHCLNTisoda: Có sử dụng vốn ODA không?investform: Nguồn vốn đầu tưtotal_investment: Tổng mức đầu tưclassify: Phân loạiapproval_org: Cơ quan phê duyệtdocument_approval: Hồ sơapproval_date: Ngày phê duyệtno_approval: Số QĐ phê duyệtupdate_time: Thời gian cập nhậtarr_contract: Danh sách gói thầu, bao gồm:
- code: Số TBMT/TBMST
- time_todo: Thời gian thực hiện
- name_domestic: Trong nước/Quốc tế
- linh_vuc: Lĩnh vực
- process_apply: Quy trình áp dụng
- price_format: Giá gói thầu
- owner_equity: Nguồn vốn
- type_choose: Hình thức LCNT
- method_choose: Phương thức LCNT
- time_choose: Thời gian LCNT
- type_contract: Hình thức HĐ
- is_prequalification: Có sơ tuyển không
- bid_location: Địa điểm thực hiện
- is_internet: Đấu thầu qua mạng
- price_words: Giá gói thầu (bằng chữ)
- est_price_format: Dự toán gói thầu được duyệt sau khi phê duyệt KHLCNT
- est_price_words: Dự toán gói thầu được duyệt sau khi phê duyệt KHLCNT (bằng chữ)
Lưu ý về tham số truy vấn:
- Có thể truy vấn theo
id(ID số) hoặccode(mã chuỗi) - Cần truyền ít nhất một trong hai tham số này
- Nếu truyền cả hai, hệ thống sẽ ưu tiên sử dụng
code
Các mã lỗi
1002: No data!!! - Không có dữ liệu trả về1003: No data input!!! - Không có tham sốidhoặccode1008: Invalid code format - Định dạngcodekhông hợp lệ1009: Error, Contact Admin - Lỗi hệ thống chưa xác định