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

Tác dụng

Lấy danh sách KQLCNT mới bóc về

  • Khi khách hàng gọi API ListBusinessReg thì hệ thống sẽ lưu lại các mst hợp lệ
  • Trong quá trình lấy dữ liệu mới, nếu có KQLCNT mà các nhà thầu có mst tương ứng ở trên thì hệ thống sẽ đánh dấu lại KQLCNT đó
  • Khách hàng gọi đến API ListCrawsResult để lấy danh sách đó

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 "ListCrawsResult" Required
last_id int ID cuối cùng mã đã lấy, Chỉ hiển thị 20 cái theo id_craws nhỏ nhất Required
  • 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

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' => 'ListCrawsResult', // Tên API được list bên dưới
    'module' => '',
    'language' => 'vi' // Bắt buộc nếu API của module trên site đa ngôn ngữ
    'last_id' => , //dạng số, nhỏ nhất là 1
];
  • last_id: ID cuối cùng mã đã lấy, Chỉ hiển thị 20 cái theo id_craws nhỏ nhất

Dữ liệu trả về nếu API truy cập thành công

{
    "status": "success",
    "code": "0000",
    "message": "",
    "last_id": 4,
    "content": [
        {
            "id_craws": 3,
            "mst": "0401340331",
            "id_result": 846292,
            "bid_code": "IB2200000754",
            "title": "Sửa chữa Ống nội soi dạ dày của bệnh viện 331"
        },
        {
            "id_craws": 4,
            "mst": "2700225027",
            "id_result": 846255,
            "bid_code": "IB2200000151",
            "title": "In tài liệu bồi dưỡng nghiệp vụ hòa giải ở cơ sở cho đội ngũ hòa giải viên"
        }
    ],
    "is_pay": true
}
  • last_id: ID cuối cùng trong danh sách, cần ghi nhớ để tái sử dụng
  • is_pay: Request có tính phí không

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

  • id_craws: id trong csdl, tương ứng với id đầu vào
  • mst: MST của doanh nghiệp trúng thầu
  • id_result: ID KQLCNT trên hệ thống dauthau.info
  • bid_code: mã TBMT của gói thầu
  • title: Tên gói thầu

Các mã lỗi

  • 1002: No data!!! - Không có dữ liệu trả về
  • 1003: No data input - Không có dữ liệu đầu vào - ở đây là id
  • 1009: Error, Contact Admin - Lỗi hệ thống chưa xác định