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

Tác dụng

Lấy các thông tin danh sách 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 "ListAllKhlcnt" 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 KHLCNT) - 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' => 'ListAllKhlcnt', // 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 KHLCNT) - 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": 5,
    "content": [
        {
            "id": 1182715,
            "name": "Bảo dưỡng, sửa chữa thay thế thiết bị điện",
            "notify_no": "PL2300094441-00",
            "bid_solicitor": "Trường tiểu học Cổ Nhuế 2A",
            "public_time": "2023-06-14T09:49:45"
        },
        {
            "id": 1182716,
            "name": "Sửa chữa cải tạo Trường Mầm non Sen Hồng",
            "notify_no": "PL2300094409-00",
            "bid_solicitor": "Trường Mầm non Sen Hồng",
            "public_time": "2023-06-14T09:38:07"
        },
        {
            "id": 1182717,
            "name": "Chuyển đổi số trong triển khai thực hiện chương trình",
            "notify_no": "PL2300094389-00",
            "bid_solicitor": "PHÒNG VĂN HÓA – THÔNG TIN HUYỆN THUẬN BẮC",
            "public_time": "2023-06-14T09:27:54"
        },
        {
            "id": 1182718,
            "name": "Xây dựng nhà lớp học Trường Tiểu học Đằng Giang ( Giai đoạn 1)",
            "notify_no": "PL2300094379-00",
            "bid_solicitor": "Ban Quản lý dự án đầu tư xây dựng Quận Ngô Quyền",
            "public_time": "2023-06-14T09:27:55"
        },
        {
            "id": 1182719,
            "name": "Trụ sở Công an xã Tân Trung",
            "notify_no": "PL2300094636-00",
            "bid_solicitor": "Ban quản lý dự án và phát triển quỹ đất thị xã Gò Công",
            "public_time": "2023-06-14T11:42:25"
        }
    ],
    "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 KHCLNT bên DauThau.info
  • name: Tên dự án
  • notify_no: Số KHLCNT
  • bid_solicitor: Tên bên mời thầu
  • public_time: Thời điểm công bố

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