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

Tác dụng

Lấy danh sách TBMT

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 "ListAllTbmt" Required
is_change int Đánh dấu lấy toàn bộ tbmt hay chỉ lấy những tbmt 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 TBMT) - Tối đa là 2000 Optional 1
public_time_from string Ngày đăng tải từ ... Chú ý: viết đúng theo dạng iso 8601 Required 00:00:00 Ngày hiện tại
public_time_to string Ngày đăng tải đến ... Chú ý: viết đúng theo dạng iso 8601 Required 23:59:59 ngày hiện tại
close_time_from string Ngày đóng thầu từ ... Chú ý: viết đúng theo dạng iso 8601 Optional
close_time_to string Ngày đóng thầu từ ... Chú ý: viết đúng theo dạng iso 8601 Optional
  • 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' => 'ListAllTbmt', // 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ữ
    '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
    'close_time_from' => '2021-03-31T09:32:00', // Mặc định là 00:00:00 Ngày hiện tại
    'close_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 TBMT) - 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: Ngày đăng tải từ ... Chú ý: viết đúng theo dạng iso 8601
  • public_time_to: Ngày đăng tải đến ... Chú ý: viết đúng theo dạng iso 8601
  • close_time_from: Ngày đóng thầu từ ... Chú ý: viết đúng theo dạng iso 8601
  • close_time_to: Ngày đóng thầu đế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": 4,
    "content": [
        {
            "id": 840796,
            "name": "Mua sắm hệ thống tim phổi nhân tạo (ECMO) năm 2021",
            "notify_no": "20210374654-00",
            "bid_solicitor": "Bệnh viện Phạm Ngọc Thạch",
            "public_time": "2021-03-31T17:00:00",
            "close_time": "2021-04-12T11:30:00"
        },
        {
            "id": 841763,
            "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",
            "public_time": "2021-04-02T14:48:00",
            "close_time": "2021-04-12T15:30:00"
        },
        {
            "id": 841869,
            "name": "Mua sắm Hóa chất xét nghiệm định danh, cấy máu, kháng sinh đồ và xét nghiệm đếm tế bào vi khuẩn năm 2021",
            "notify_no": "20210405843-00",
            "bid_solicitor": "Bệnh viện Phạm Ngọc Thạch",
            "public_time": "2021-04-02T16:04:00",
            "close_time": "2021-04-12T16:30:00"
        },
        {
            "id": 841931,
            "name": "Mua sắm vật tư kiểm soát nhiễm khuẩn bệnh viện và kiểm soát nhiễm khuẩn trong phẫu thuật năm 2021",
            "notify_no": "20210406217-00",
            "bid_solicitor": "Bệnh viện Phạm Ngọc Thạch",
            "public_time": "2021-04-02T16:50:00",
            "close_time": "2021-04-13T11: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 TBMT tại DauThau.info
  • name: Tên TBMT
  • bid_solicitor: Bên mời thầu
  • public_time: Thời gian công bố
  • close_time: Thời gian đóng 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