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

Tác dụng

Lấy thông tin chi tiết các phân lô của TBMT

Tham số có thể truyền vào:

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 "GetDetailLots" Required
id int ID của TBMT bên DauThau.info Required
page int Trang hiện tại Optional 1
limit int Số lượng bản ghi trên một trang (mặc định và tối đa là 50, nếu vượt quá sẽ báo lỗi) Optional 50
  • 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' => 'GetDetailLots', // Tên API được list bên dưới
    'id' => 1, //ID của TBMT bên DauThau.info
    'page' => 1, // Trang hiện tại
    'limit' => 50, // Số lượng bản ghi trên một trang
];

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

{
  "status": "success",
  "code": "0000",
  "message": "",
  "current_page": 1,
  "page_size": 50,
  "total": 100,
  "total_pages": 2,
  "content": [
    {
      "id": "1",
      "lotname": "Tên phân lô",
      "lotestimate_price": "Giá dự toán của lô",
      "lotprice": "Giá gói thầu của lô",
      "lotguarantee_value": "Giá trị bảo đảm dự thầu của lô",
      "cperiod": "Thời gian thực hiện",
      "cperiodunit": "Đơn vị thời gian"
    }
  ]
}

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

  • id: ID của phân lô
  • lotname: Tên phân lô
  • lotestimate_price: Giá dự toán của lô
  • lotprice: Giá gói thầu của lô
  • lotguarantee_value: Giá trị bảo đảm dự thầu của lô
  • cperiod: Thời gian thực hiện
  • cperiodunit: Đơn vị thời gian

Thông tin phân trang

  • current_page: Trang hiện tại
  • page_size: Số lượng bản ghi trên một trang
  • total: Tổng số bản ghi
  • total_pages: Tổng số trang

Các mã lỗi

  • 1002: No data!!! - Không có dữ liệu trả về
  • 1003: No data input!!! - Không có ID TBMT
  • 1004: The number of records per page cannot exceed 50 records!!! - Số lượng bản ghi không được vượt quá 50 bản ghi/trang