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

Tác dụng

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

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 "ListAllKqlcnt" 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 KQLCNT) - Tối đa là 2000 Optional 1
finish_time_from string Thời điểm kết thúc từ ... Chú ý: viết đúng theo dạng iso 8601 Required 00:00:00 Ngày hiện tại
finish_time_to string Thời điểm kết thúc đế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' => 'ListAllKqlcnt', // 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
    'finish_time_from' => '2021-03-31T09:32:00', // Mặc định là 00:00:00 Ngày hiện tại
    'finish_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 KQLCNT) - 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
  • finish_time_from: Thời điểm kết thúc từ ... Chú ý: viết đúng theo dạng iso 8601
  • finish_time_to: Thời điểm kết thúc đế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": 8,
    "content": [
        {
            "id": 647903,
            "name": "Gói thầu: Dịch vụ vệ sinh ngoại cảnh - Chăm sóc cây xanh bệnh viện năm 2021-2022",
            "notify_no": "20210331751-00",
            "bid_solicitor": "Bệnh viện Phạm Ngọc Thạch",
            "finish_time": "2021-03-31T09:32:00"
        },
        {
            "id": 649680,
            "name": "Mua sắm vật tư y tế nhựa dùng trong lấy mẫu năm 2020-2021",
            "notify_no": "20210233385-00",
            "bid_solicitor": "Bệnh viện Phạm Ngọc Thạch",
            "finish_time": "2021-03-31T13:50:00"
        },
        {
            "id": 656367,
            "name": "Gói thầu thuốc biệt dược gốc hoặc tương đương điều trị",
            "notify_no": "20210458031-00",
            "bid_solicitor": "Bệnh viện Phạm Ngọc Thạch",
            "finish_time": "2021-04-23T15:25:28"
        },
        {
            "id": 656532,
            "name": "Gói thầu thuốc Generic",
            "notify_no": "20210458488-00",
            "bid_solicitor": "Bệnh viện Phạm Ngọc Thạch",
            "finish_time": "2021-04-23T00:00:00"
        },
        {
            "id": 657701,
            "name": "Mua sắm phụ kiện sửa chữa, thay thế bóng phát tia cho hệ thống chụp cắt lớp CT Somatom Emotion Duo của Bệnh viện Phạm Ngọc Thạch",
            "notify_no": "20210323809-00",
            "bid_solicitor": "Bệnh viện Phạm Ngọc Thạch",
            "finish_time": "2021-04-16T10:25:00"
        },
        {
            "id": 661487,
            "name": "Cải tạo sửa chữa Phòng chụp X-quang Khoa Chẩn đoán Hình ảnh",
            "notify_no": "20210328927-01",
            "bid_solicitor": "Bệnh viện Phạm Ngọc Thạch",
            "finish_time": "2021-04-16T10:33:00"
        },
        {
            "id": 666565,
            "name": "Mua thiết bị San, San Switch cho Bệnh viện năm 2020",
            "notify_no": "20210101160-00",
            "bid_solicitor": "Bệnh viện Phạm Ngọc Thạch",
            "finish_time": "2021-04-15T09:08:00"
        },
        {
            "id": 682059,
            "name": "Mua sắm vật tư dùng cho máy hấp nhiệt độ thấp năm 2021",
            "notify_no": "20210405061-00",
            "bid_solicitor": "Bệnh viện Phạm Ngọc Thạch",
            "finish_time": "2021-04-12T15:30:00"
        }
    ],
    "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 KQLCNT bên DauThau.info
  • name: Tên gói thầu
  • notify_no: Mã TBMT
  • bid_solicitor: Tên bên mời thầu
  • finish_time: Thời điểm kết thúc gói 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