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

Tác dụng

Lấy các thông tin chi tiết của Nhà thầu

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 "GetDetailBusiness" Required
id int ID của Nhà thầu 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' => '...', // 
    'action' => 'GetDetailBusiness', // Tên API được list bên dưới
    'id' => 1, //ID của Nhà thầu bên DauThau.info
];
  • id: ID của Nhà thầu bên DauThau.info

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

{
    "status": "success",
    "code": "0000",
    "message": "",
    "content": {
        "id": 154021,
        "companyname": "CÔNG TY TNHH DƯỢC MỸ PHẨM AN PHÁT",
        "officialname": "AN PHAT PHARMACEUTICAL COSMETICS COMPANY LIMITED ",
        "code": "0315469620",
        "orgcode": "vn0315469620",
        "address": "156/7A/1 - 156/7A/3 (1 Phần ) Đường Tô Hiến Thành.",
        "website": "",
        "tax_nation": "VN",
        "businesstype": "Công ty trách nhiệm hữu hạn một thành viên",
        "dateestablished": "",
        "chartercapital": 0,
        "ngay_phe_duyet": "",
        "rep_name": "TRẦN THỊ HUYỀN ",
        "rep_position": "Giám đốc",
        "update_time": "09:40 2025-09-21",
        "industry_dkkd": [
            "Xây dựng nhà để ở",
            "Xây dựng nhà không để ở",
            "Bán buôn ô tô và xe có động cơ khác",
            "Bán phụ tùng và các bộ phận phụ trợ của ô tô và xe có động cơ khác",
            "Bán mô tô, xe máy",
            "Bán phụ tùng và các bộ phận phụ trợ của mô tô, xe máy",
            "Đại lý, môi giới, đấu giá hàng hóa",
            "Bán buôn nông, lâm sản nguyên liệu (trừ gỗ, tre, nứa) và động vật sống",
            "Bán buôn gạo, lúa mỳ, hạt ngũ cốc khác, bột mỳ",
            "Bán buôn thực phẩm",
            "Bán buôn đồ uống",
            "Bán buôn vải, hàng may mặc, giày dép",
            "Bán buôn đồ dùng khác cho gia đình",
            "Bán buôn máy vi tính, thiết bị ngoại vi và phần mềm",
            "Bán buôn thiết bị và linh kiện điện tử, viễn thông",
            "Bán buôn máy móc, thiết bị và phụ tùng máy khác",
            "Bán buôn kim loại và quặng kim loại",
            "Bán buôn vật liệu, thiết bị lắp đặt khác trong xây dựng",
            "Bán lẻ lương thực trong các cửa hàng chuyên doanh",
            "Bán lẻ thực phẩm trong các cửa hàng chuyên doanh",
            "Bán lẻ đồ uống trong các cửa hàng chuyên doanh",
            "Bán lẻ hàng may mặc, giày dép, hàng da và giả da trong các cửa hàng chuyên doanh",
            "Bán lẻ thuốc, dụng cụ y tế, mỹ phẩm và vật phẩm vệ sinh trong các cửa hàng chuyên doanh",
            "Bán lẻ hàng hóa khác mới trong các cửa hàng chuyên doanh",
            "Nhà hàng và các dịch vụ ăn uống phục vụ lưu động",
            "Quảng cáo",
            "Tổ chức giới thiệu và xúc tiến thương mại"
        ],
        "thong_tin_nganh_nghe": [
            "Bán buôn máy móc, thiết bị và phụ tùng máy khác",
            "Bán buôn kim loại và quặng kim loại",
            "Bán buôn vật liệu, thiết bị lắp đặt khác trong xây dựng",
            "Tổ chức giới thiệu và xúc tiến thương mại",
            "Quảng cáo",
            "Bán lẻ lương thực trong các cửa hàng chuyên doanh",
            "Bán lẻ thực phẩm trong các cửa hàng chuyên doanh",
            "Bán lẻ đồ uống trong các cửa hàng chuyên doanh",
            "Nhà hàng và các dịch vụ ăn uống phục vụ lưu động",
            "Xây dựng nhà để ở",
            "Xây dựng nhà không để ở",
            "Bán lẻ hàng may mặc, giày dép, hàng da và giả da trong các cửa hàng chuyên doanh",
            "Bán lẻ thuốc, dụng cụ y tế, mỹ phẩm và vật phẩm vệ sinh trong các cửa hàng chuyên doanh",
            "Bán lẻ hàng hóa khác mới trong các cửa hàng chuyên doanh",
            "Bán buôn ô tô và xe có động cơ khác",
            "Bán phụ tùng và các bộ phận phụ trợ của ô tô và xe có động cơ khác",
            "Bán mô tô, xe máy",
            "Bán phụ tùng và các bộ phận phụ trợ của mô tô, xe máy",
            "Đại lý, môi giới, đấu giá hàng hóa",
            "Bán buôn nông, lâm sản nguyên liệu (trừ gỗ, tre, nứa) và động vật sống",
            "Bán buôn gạo, lúa mỳ, hạt ngũ cốc khác, bột mỳ",
            "Bán buôn thực phẩm",
            "Bán buôn đồ uống",
            "Bán buôn vải, hàng may mặc, giày dép",
            "Bán buôn đồ dùng khác cho gia đình",
            "Bán buôn máy vi tính, thiết bị ngoại vi và phần mềm",
            "Bán buôn thiết bị và linh kiện điện tử, viễn thông"
        ],
    },
    "is_pay": 1
}

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

  • id: ID Nhà thầu
  • companyname: Tên công ty
  • officialname: Tên quốc tế
  • code: Mã số
  • orgcode: Mã định danh
  • address: Địa chỉ
  • website: Website công ty
  • tax_nation: Quốc gia cấp MST
  • businesstype: Loại doanh nghiệp
  • dateestablished: Ngày thành lập công ty
  • chartercapital: Vốn điều lệ
  • ngay_phe_duyet: Ngày phê duyệt trên mạng đấu thầu quốc gia
  • rep_name: Người đại diện pháp luật
  • rep_position: Chức vụ
  • industry_dkkd: Ngành nghề theo đkkd
  • thong_tin_nganh_nghe: Ngành nghề trên MSC
  • update_time : Thời gian cập nhật

Các mã lỗi

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