Hướng dẫn sử dụng API ListAllKqmt - vinades/api.dauthau.info GitHub Wiki

Tác dụng

Lấy các thông tin danh sách KQMT

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 "ListAllKqmt" 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 KQMT) - 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:
  1. password_hash($apisecret . '_' . $timestamp, PASSWORD_DEFAULT) với phương thức xác thực là password_verify
  2. 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' => 'ListAllKqmt', // 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 KQMT) - Tối đa là 2000
  • is_change: 0: Lấy toàn bộ dữ liệu; 1: lấy các dữ liệu có sự thay đổi
  • change_time_from: Thời điểm cập nhật từ ... Chú ý: viết đúng theo dạng iso 8601
  • change_time_to: Thời điểm cập nhật đến ... Chú ý: viết đúng theo dạng iso 8601
  • public_time_from: Thời điểm công bố từ ... Chú ý: viết đúng theo dạng iso 8601
  • public_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": 1,
    "page_size": 20,
    "current_page": 1,
    "total_elements": 10,
    "content": [
        {
            "id": 10,
            "name": "Gói thầu số 01: Mua sắm thuốc Generic",
            "notify_no": "IB2300199462-00",
            "bid_solicitor": "Bệnh viện Trung ương Quân đội 108",
            "public_time": "2023-09-07T15:00:00",
            "trang_thai": "Hoàn thành mở HSKT",
            "so_luong_nha_thau": 179
        },
        {
            "id": 2,
            "name": "Gói thầu số 09: Bảo hiểm công trình",
            "notify_no": "IB2300203764-02",
            "bid_solicitor": "Ban Quản lý dự án đầu tư xây dựng thành phố Phủ Lý",
            "public_time": "2023-09-07T15:30:00",
            "trang_thai": "Hoàn thành mở thầu",
            "so_luong_nha_thau": 3
        },
        {
            "id": 1,
            "name": "Gói thầu 05/2023/ĐTXD/GT-02: Thi công xây lắp",
            "notify_no": "IB2300205454-02",
            "bid_solicitor": "CÔNG TY ĐIỆN LỰC THẠCH THẤT",
            "public_time": "2023-09-07T15:30:00",
            "trang_thai": "Hoàn thành mở HSKT",
            "so_luong_nha_thau": 2
        },
        {
            "id": 9,
            "name": "Gói thầu số 04: Thi công xây dựng",
            "notify_no": "IB2300211361-00",
            "bid_solicitor": "Ban Quản lý dự án đầu tư xây dựng huyện Lục Ngạn",
            "public_time": "2023-09-07T15:30:00",
            "trang_thai": "Hoàn thành mở thầu",
            "so_luong_nha_thau": 2
        },
        {
            "id": 7,
            "name": "Gói thầu: May đồng phục cho cán bộ Bệnh viện 09 năm 2023",
            "notify_no": "IB2300211894-00",
            "bid_solicitor": "Bệnh viện 09",
            "public_time": "2023-09-07T15:30:00",
            "trang_thai": "Hoàn thành mở thầu",
            "so_luong_nha_thau": 3
        },
        {
            "id": 8,
            "name": "Phần xây dựng",
            "notify_no": "IB2300212391-00",
            "bid_solicitor": "Ủy ban nhân dân xã Phương Trung",
            "public_time": "2023-09-07T15:00:00",
            "trang_thai": "Hoàn thành mở thầu",
            "so_luong_nha_thau": 1
        },
        {
            "id": 6,
            "name": "Gói số 03: Mua sắm thiết bị",
            "notify_no": "IB2300213476-00",
            "bid_solicitor": "PHÒNG VĂN HÓA VÀ THÔNG TIN",
            "public_time": "2023-09-07T15:00:00",
            "trang_thai": "Hoàn thành mở thầu",
            "so_luong_nha_thau": 1
        },
        {
            "id": 3,
            "name": "Trang bị thiết bị ghi âm, ghi hình phục vụ công tác điều tra tại Hạt Kiểm lâm huyện An Lão và Tây Sơn",
            "notify_no": "IB2300213665-00",
            "bid_solicitor": "Chi cục Kiểm lâm tỉnh Bình Định",
            "public_time": "2023-09-07T15:30:00",
            "trang_thai": "Hoàn thành mở thầu",
            "so_luong_nha_thau": 2
        },
        {
            "id": 5,
            "name": "Thực hiện Chương trình Kỹ Năng sống (hoạt động giáo dục STEAM) cho học sinh trường Tiểu học Thái Văn Lung từ 05/09/2023 - 31/05/2025",
            "notify_no": "IB2300213710-00",
            "bid_solicitor": "TRƯỜNG TIỂU HỌC THÁI VĂN LUNG",
            "public_time": "2023-09-07T10:00:00",
            "trang_thai": "Hoàn thành mở thầu",
            "so_luong_nha_thau": 1
        },
        {
            "id": 4,
            "name": "Thuê đơn vị cung cấp dịch vụ: Lắp đặt 80 gian hàng tiêu chuẩn 3m x 3m (bao gồm bàn, ghế, khăn trải bàn, ổ điện kèm 2m dây điện) và 4 bộ dù 1 trụ đường kính 20m để 
tổ chức triển lãm Ngày hội khởi nghiệp đổi mới sáng tạo thành phố Đà Nẵng - SURF 2023.",
            "notify_no": "IB2300213735-00",
            "bid_solicitor": "Trung tâm Hỗ trợ khởi nghiệp đổi mới sáng tạo Đà Nẵng",
            "public_time": "2023-09-07T15:30:00",
            "trang_thai": "Hoàn thành mở thầu",
            "so_luong_nha_thau": 2
        }
    ],
    "is_pay": true
}
  • total_pages: Tổng số trang
  • page_size: Số dữ liệu trên 1 trang (hiện tại để 20)
  • current_page: Trang hiện tại
  • total_elements: Tổng số dữ liệu
  • is_pay: Request có tính phí không

content (mảng dữ liệu cần quan tâm)

  • id: ID kqmt bên DauThau.info
  • name: Tên gói thầu
  • notify_no: Số TBMT
  • bid_solicitor: Tên bên mời thầu
  • public_time: Thời điểm công bố
  • trang_thai: Trạng thái mở thầu
  • so_luong_nha_thau: Số lượng nhà thầu

Các mã lỗi

  • 1001: Maximum number of pages is 2000 - Giá trị page truyền vào tối đa là 2000
  • 1002: No data!!! - Không có dữ liệu trả về
  • 1009: Error, Contact Admin - Lỗi hệ thống chưa xác định