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

Tác dụng

Lấy các thông tin chi tiết của Dự án

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 "GetDetailDadtpt" Required
id int ID của Dự án bên DauThau.info Optional*
code string Mã dự án Optional*

(*) Lưu ý: Cần truyền ít nhất một trong hai tham số id hoặc code

  • 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ụ sử dụng:

Cách 1: Truy vấn theo ID

$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' => 'GetDetailDadtpt', // Tên API được list bên dưới
    'id' => 1, // ID của Dự án bên DauThau.info
];

Cách 2: Truy vấn theo mã dự án

$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' => 'GetDetailDadtpt', // Tên API được list bên dưới
    'code' => 'PR2300024013-00', // Mã dự án
];

Mô tả tham số:

  • id: ID của Dự án bên DauThau.info
  • code: Mã dự án (Mã danh mục dự án đầu tư công)

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

{                       
    "status": "success",
    "code": "0000",     
    "message": "",      
    "content": {        
        "id": 2473807,
        "code": "PR2300024013-00",
        "type": "Thông báo thực",
        "name": "Xây dựng đường giao thông từ xã Hương Sơn nối tỉnh lộ 534B đi xã Tiên Kỳ, huyện Tân Kỳ",
        "invest_target": "",
        "invest_scale": "",
        "investor": "Ban Quản lý dự án đầu tư xây dựng huyện Tân Kỳ",
        "investor_code": "vnz000006558",
        "competent_persons": "Chủ tịch UBND huyện Phan Văn Giáp",
        "pperiod": "3 năm",
        "project_type": "Nhóm C",
        "pform": "",
        "oda": "Không",
        "total_investment": "7.835.749.000 VNĐ",
        "book_number": "6308/QĐ-UBND",
        "accept_date": "2022-12-15T23:23:23",
        "decision_agency": "UBND huyện Tân Kỳ",
        "location": "",
        "total_investment_text": "Bảy tỷ tám trăm ba mươi lăm triệu bảy trăm bốn mươi chín nghìn đồng chẵn",
        "update_time": "09:40 2025-09-21",
        "other_plans": {
            "1": {
                "code": "PL2300086224",
                "title": "Xây dựng đường giao thông từ xã Hương Sơn nối tỉnh lộ 534B đi xã Tiên Kỳ, huyện Tân Kỳ",
                "price": "7.835.749.000 VNĐ"
            },
            "total_plan_price": "7.835.749.000 VNĐ"
        }
    },
    "is_pay": 1
}

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

  • id: ID Dự án
  • code: Số Dự án
  • type: Loại thông báo
  • name: Tên dự án
  • invest_target: Mục tiêu đầu tư
  • invest_scale: Quy mô đầu tư
  • investor: Chủ đầu tư
  • investor_code: Mã chủ đầu tư
  • competent_persons: Người có thẩm quyền
  • pperiod: Thời gian thực hiện dự án
  • project_type: Nhóm dự án
  • pform: Hình thức quản lý dự án
  • oda: Sử dụng nguồn vốn ODA
  • total_investment: Tổng mức đầu tư
  • book_number: Số quyết định phê duyệt dự án
  • accept_date: Ngày phê duyệt
  • decision_agency: Cơ quan ban hành quyết định
  • location: Địa điểm
  • total_investment_text: Tổng mức đầu tư (bằng chữ)
  • update_time : Thời gian cập nhật
  • other_plans: Danh sách khlcnt, bao gồm:
  1. code: Số KHLCNT
  2. title: Tên KHLCNT
  3. price: Tổng đầu tư total_plan_price: tổng đầu tư tất cả khlcnt

Lưu ý về tham số truy vấn:

  • Có thể truy vấn theo id (ID số) hoặc code (mã chuỗi)
  • Cần truyền ít nhất một trong hai tham số này
  • Nếu truyền cả hai, hệ thống sẽ ưu tiên sử dụng code

Các mã lỗi

  • 1002: No data!!! - Không có dữ liệu trả về
  • 1003: No data input!!! - Không có tham số id hoặc code
  • 1008: Invalid code format - Định dạng code không hợp lệ
  • 1009: Error, Contact Admin - Lỗi hệ thống chưa xác định