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

Tác dụng

Lấy dữ liệu hàng hoá của Kết quả lựa chọn nhà thầu

LƯU Ý

Cần gọi 1 lần MST cần tìm với API ListBusinessReg để hệ thống đánh dấu lại

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	"ListResultGoods"	Required
mst	string	Mã số thuế của nhà thầu	Required
id	int	ID của KQLCNT bên DauThau.info	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' => 'ListResultGoods', // Tên API
    'module' => '',
    'language' => 'vi' // Bắt buộc nếu API của module trên site đa ngôn ngữ
    'mst' => '0101216710',
    'id' => 3736, //dạng số
];

• mst: Mã số thuế của nhà thầu
• id: ID của KQLCNT trên hệ thống dauthau.info

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

{
    "status": "success",
    "code": "0000",
    "message": "",
    "total_elements": 3,
    "content": [
        {
            "goods_name": "Sổ nghiệp vụ 120 trang (khổ 19x23cm)",
            "sign_product": null,
            "number_bid": "78000",
            "unit_cal": "Cuốn",
            "description": "Theo quy định tại Chương V",
            "origin": "Việt Nam",
            "capacity": null,
            "bid_price": "7663",
            "note": null
        },
        {
            "goods_name": "Sổ nghiệp vụ 120 trang (khổ 13x19cm)",
            "sign_product": null,
            "number_bid": "30000",
            "unit_cal": "Cuốn",
            "description": "Theo quy định tại Chương V",
            "origin": "Việt Nam",
            "capacity": null,
            "bid_price": "5440",
            "note": null
        },
        {
            "goods_name": "Sách 300 trang (khổ 16x24cm)",
            "sign_product": null,
            "number_bid": "10000",
            "unit_cal": "Cuốn",
            "description": "Theo quy định tại Chương V",
            "origin": "Việt Nam",
            "capacity": null,
            "bid_price": "18190",
            "note": null
        }
    ],
    "is_pay": true
}

• total_elements: (Tổng số dữ liệu sẽ trả về)
• is_pay: Request có tính phí không

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

• goods_name: Tên hàng hoá
• sign_product: Ký hiệu nhãn mác sản phẩm
• number_bid: Khối lượng mời thầu
• unit_cal: Đơn vị tính
• description: Mô tả sản phẩm
• origin: Xuất xứ
• capacity: Công suất
• bid_price:Giá dự thầu
• note: Ghi chú

Các mã lỗi

• 1002: No data!!!: Không có dữ liệu trả về
• 1003: No data input - Không có MST hoặc ID KQLCNT
• 1004: Error mst not regulations: Mã số thuế không đúng định dạng
• 1005: Error mst not register: chưa đăng ký MST
• 1006: Error not bidding result: Không có kết quả lựa chọn nhà thầu
• 1009: Error, Contact Admin: Lỗi chưa xác định