# 人工询价对接接口

# 1. 全局请求参数说明

# 1.1 Header参数

参数名 示例值 参数类型 是否必填 参数描述
Content-Type application/json;charset=UTF-8 String 是 资源类型: json
Signature - String 是 签名

# 1.2 Body参数

参数名 示例值 参数类型 是否必填 参数描述
time 1731452981 Number 是 请求发起时间，Unix timestamp
source gzgjgc String 是 服务发起方标识

# 1.3 认证信息

Header中的 Signature 为校验签名，计算方法如下（Python示例）：

import json
import hmac
import hashlib

# 示例 JSON 数据
data = {
    "time": 1731549960,
    "source": "gzgjgc",
    "data": "其他数据"
}

# 将 JSON 数据转换为字符串，并指定排序和分隔符(⽆空格)，不进⾏ ASCII 转义
json_str = json.dumps(data, sort_keys=True, separators=(',', ':'), ensure_ascii=False)
# 秘钥
key = "your_secret_key"
# 对字符串进⾏ HMAC-SHA256 签名
hash_object = hmac.new(key.encode(), json_str.encode(), hashlib.sha256)
# 获取签名(16进制摘要)
signature = hash_object.hexdigest()
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19

# 2. 全局响应参数说明

# 2.1 Body参数

参数名 示例值 参数类型 参数描述
code 10000 Number 状态码（10000为正常返回）
result true Boolean 请求是否正常
message success String 消息（异常时带具体信息）
time 1731452981 Number 响应时间，Unix timestamp
data - Object 响应数据（异常时无此字段）

正常情况下慧讯⽹返回的http code 均为200；返回数据为json格式。成功/失败通过code区分(详⻅code说明)。

# 2.2 code说明

# 通用

code 说明
10000 成功
30001 签名校验失败
30002 签名过期
30007 越权访问(⾮本公司账号/询价)
30503 访问过于频繁
-999 慧讯网内部错误

# 提交询价专属响应

code 说明
30003 指定账号被锁
30004 指定账号已停用
30005 指定账号已过期
30006 指定账号不存在
30010 提交参数错误(错误原因会在message中体现)
30012 询价可用条数不足
30013 节假日询价暂停
30014 询价非可编辑状态

# 询价详情专属响应

code 说明
30020 询价不存在
30007 越权访问(⾮本公司账号/询价)

# 3. 提交询价

提交询价到慧讯⽹

# 3.1 接口URL

/api/v1/outer/inquire/submit_inquire

# 3.2 请求方式

POST

# 3.3 Content-Type

application/json

# 3.4 请求Body参数

{
    "user_name": "gzhjsnd1",
    "inquire_id": "1782373",
    "inquire_title": "湖南地区橘子价格",
    "project_name": "恒大一期",
    "has_product": true,
    "project_type": "commercial_residential",
    "project_province_id": 82,
    "project_city_id": 7,
    "supplier_province_id": 43,
    "supplier_city_id": 2,
    "same_as_project": true,
    "price_type": "purchase",
    "special_supplier": true,
    "special_supplier_notes": "特殊供应商备注",
    "inquire_content": 1,
    "inquire_desc": "询价描述-请询工程价",
    "additional_explain": "contact",
    "list_file": [
        {
            "product_name": "三相异步电机",
            "spec_model": "145*45*4.5",
            "param": "Q=50m³/h;H-10m",
            "purchase_volume": 74,
            "purchase_unit": "台",
            "brand": "施耐德",
            "brand_level": "高档",
            "firm_num": 99,
            "notes": "这是备注"
        }
    ],
    "product_image_url": "https://example.com/file.pdf",
    "inquire_contact": {
        "mobile": "18787676561",
        "name": "张建国",
        "email": "loal@qq.com",
        "department": "企划部",
        "phone": "010-67655441"
    },
    "receive_type": "email_and_sms"
}
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
参数名 示例值 参数类型 是否必填 默认值 最大长度 参数描述
user_name gzhjsnd1 String 是 - 20 用户名
inquire_id 1782373 String 否 - - 询价ID（有此参数为编辑询价，无此参数为新增询价）
inquire_title 湖南地区橘子价格 String 否 - 50 询价标题
project_name 恒大一期 String 否 - 20 项目名
has_product true Boolean 是 false - 是否已询过价
project_type commercial_residential String 是 - - 项目类型 [枚举]
project_province_id 82 Number 是 - - 项目省份ID [枚举]
project_city_id 7 Number 是 - - 项目城市ID [枚举]
supplier_province_id 43 Number 是 - - 供应商省份ID [枚举]
supplier_city_id 2 Number 是 - - 供应商城市ID [枚举]
same_as_project true Boolean 是 - - 同项目地区（材料商地区与项目完全一致）
price_type purchase String 是 - - 价格用途 [枚举]
special_supplier true Boolean 是 true - 特定品牌/厂家
special_supplier_notes special_supplier(特定品牌/厂家)为... String 否 详见询价表 50 指定供应商为 true 时的备注信息（当 special_supplier 为 true 时必填）
inquire_content 1 Number 是 - - 询价内容 [枚举]
inquire_desc 询价描述-请询工程价 String 否 - 500 询价描述
additional_explain contact String 否 - - 补充说明 [枚举]
list_file - Array 是 - - 询价产品清单列表（目前仅支持一条数据）
list_file.product_name 三相异步电机 String 否 - - 产品名
list_file.spec_model 145454.5 String 否 - - 规格型号
list_file.param Q=50m³/h;H-10m String 否 - - 技术参数
list_file.purchase_volume 74 Number 否 - - 采购量
list_file.purchase_unit 台 String 否 - - 数量单位
list_file.brand 施耐德 String 是 - - 品牌
list_file.brand_level 高档 String 否 - - 品牌档次
list_file.firm_num 99 Number 是 - - 报价厂家数量（此数量将作为询价使用条数）
list_file.notes 这是备注 String 否 - - 备注
product_image_url https://rccprice.oss-cn-hangzhou (opens new window)... String 否 - - 产品图纸文件URL
inquire_contact - Object 是 - - 联系人
inquire_contact.mobile 18787676561 String 是 - 11 联系人手机
inquire_contact.name 张建国 String 是 - 20 联系人姓名
inquire_contact.email loal@qq.com String 是 - 100 联系人邮箱
inquire_contact.department 企划部 String 否 - 50 联系人部门
inquire_contact.phone 010 67655441 String 否 - 50 联系人固定电话
receive_type email_and_sms String 否 email_and_sms - 通知接收方式 [枚举]

# 3.5 请求参数说明

标注枚举的参数，在提交询价的下拉框枚举值接⼝中会返回该字段可⽤类型，提交询价的下拉框枚举值示例json中除regions部分，其他：

  • project_types -> project_type 项⽬类型
  • price_types -> price_type 价格⽤途
  • inquire_contents -> inquire_content 询价内容
  • additional_explains -> additional_explain 补充说明
  • receive_types -> receive_type 通知接收⽅式

示例json中均包含全部可选择值

regions部分有两层，第⼀层为省/直辖市，第⼆层为地级市/(直辖市下区/县)，分别为:

  • project_province_id 项⽬省份 (数值为0时表示不限地区，project_city_id也应为0)
  • project_city_id 项⽬城市
  • supplier_province_id 供应商省份 (数值为0时表示不限地区，supplier_city_id也应为0)
  • supplier_city_id 供应商城市

提供可选择项

枚举参数的传值均为提交询价的下拉框枚举值接⼝返回项的value(不是label)

# 3.6 响应示例

成功响应（200）

{
    "code": 10000,
    "result": true,
    "message": "success",
    "data": {
        "inquire_id": 5
    }
}
1
2
3
4
5
6
7
8
参数名 示例值 参数类型 参数描述
code 10000 Number 状态码(10000为正常返回，其它均为异常)
result true Boolean 请求正常
message success String 消息(正常时为success，异常时带异常信息)
data - Object 响应数据(异常时⽆此数据)
data.inquire_id 5 Number 询价ID

失败响应（200）

{
    "code": 30012,
    "result": true,
    "message": "询价条数不足"
}
1
2
3
4
5
参数名 示例值 参数类型 参数描述
code 30012 Number 状态码(⾮10000异常)
result true Boolean 请求正常
message 询价条数不⾜ String 异常的消息

# 4. 获取全部账号

获取公司内部全部账号

# 4.1 接口URL

/api/v1/outer/inquire/accounts

# 4.2 请求方式

POST

# 4.3 Content-Type

application/json

# 4.4 请求Body参数

无需参数。

# 4.5 响应示例

  • 成功(200)
{
    "code": 10000,
    "result": true,
    "message": "success",
    "data": {
        "accounts": [
            {
                "user_name": "paldke",
                "login_end": "2025-01-12",
                "state": "locked",
                "left_inquire_count": 3,
                "inquire_used_count": 4
            }
        ]
    }
}
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
参数名 示例值 参数类型 参数描述
code 10000 Number 状态码(⾮10000异常)
result true Boolean 请求正常
message success String 异常的消息
data - Object 响应数据(异常时⽆此数据)
data.accounts - Array 账户信息
data.accounts.user_name paldke String ⽤户名
data.accounts.login_end 2025-01-
12 String 登录结束时间
data.accounts.state locked String 账户状态（normal: 正常，locked: 账号被锁， expired: 账号已
过期）
data.accounts.left_inquire_count 3 Number 剩余查询次数
data.accounts.inquire_used_count 4 Number 已使⽤查询次数

# 5. 查询账号可用询价数量

查询指定账号可⽤询价数量

# 5.1 接口URL

/api/v1/outer/inquire/account_left_inquire_count

# 5.2 请求方式

POST

# 5.3 Content-Type

application/json

# 5.4 请求Body参数

{
    "user_name": "sdawfd1"
}
1
2
3
参数名 示例值 参数类型 是否必填 参数描述
user_name sdawfd1 String 是 ⽤户名

# 5.5 响应示例

{
    "code": 10000,
    "result": true,
    "message": "success",
    "data": {
        "left_inquire_count": 58
    }
}
1
2
3
4
5
6
7
8
参数名 示例值 参数类型 参数描述
code 10000 Number 状态码(⾮10000异常)
result true Boolean 请求正常
message success String 异常的消息
data - Object 响应数据(异常时⽆此数据)
data.left_inquire_count 58 Number 剩余询价条数

# 6. 提交询价的下拉框枚举值

获取提交询价时全部枚举值

# 6.1 接口URL

/api/v1/outer/inquire/selector_options

# 6.2 请求方式

POST

# 6.3 Content-Type

application/json

# 6.4 请求Body参数

无需参数。

# 6.5 响应示例

  • 成功(200)
{
    "code": 10000,
    "result": true,
    "message": "success",
    "data": {
        "regions": [
            {
                "label": "不限地区",
                "value": 0
            },
            {
                "label": "黑龙江省",
                "value": 44,
                "cities": [
                    {
                        "label": "佳木斯市",
                        "value": 96
                    }
                ]
            }
        ],
        "project_types": [
          { "label": "别墅", "value": "villa" },
          { "label": "商业住宅", "value": "commercial_residential" },
          { "label": "政府安置房", "value": "government_settlement" },
          { "label": "酒店", "value": "hotel" },
          { "label": "办公楼", "value": "office_building" },
          { "label": "商业及综合体", "value": "comprehensive_building" },
          { "label": "工业及仓储物流", "value": "industry" },
          { "label": "医疗", "value": "hospital" },
          { "label": "市政及公共设施", "value": "government" },
          { "label": "教育及科研设施", "value": "education" },
          { "label": "园林景观", "value": "landscape" },
          { "label": "仿古建筑", "value": "pseudo_classic" },
          { "label": "其他项目", "value": "other" }
        ],
        "price_types": [
            { "label": "采购", "value": "purchase" }
        ],
        "inquire_contents": [
            { "label": "材料价格", "value": 1 }
        ],
        "additional_explains": [
            { "label": "若参数不全请联系", "value": "contact" }
        ],
        "receive_types": [
            { "label": "邮件和短信", "value": "email_and_sms" }
        ]
    }
}
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
参数名 示例值 参数类型 参数描述
code 10000 Number 状态码(⾮10000异常)
result true Boolean 请求正常
message success String 异常的消息
data - Object 响应数据(异常时⽆此
数据)
data.regions - Array 地区数据
data.regions.label ⿊⻰江省 String 省份(直辖市)名称
data.regions.value 44 Number 省份(直辖市)id
data.regions.cities - Array 城市数据
data.regions.cities.label 佳⽊斯市 String 城市名
data.regions.cities.value 96 Number 城市id
data.project_types - Array 项⽬类型数据
data.project_types.label 其他项⽬ String 项⽬类型⽂本
data.project_types.value other String 项⽬类型枚举值
data.price_types - Array 价格⽤途数据
data.price_types.label 招投标 String 价格⽤途⽂本
data.price_types.value tendering String 价格⽤途枚举值
data.inquire_contents - Array 询价内容数据
data.inquire_contents.label 材料+施⼯费⽤ String 询价内容⽂本
data.inquire_contents.value 10 Number 询价内容枚举值
data.additional_explains - Array 补充说明数据
data.additional_explains.label 若产品参数不全，已经没有资料可提供，同意⼚家推荐
报价。 String 补充说明⽂本
data.additional_explains.value agree_factory String 补充说明枚举值
data.receive_types - Array 接收类型数据
data.receive_types.label 邮件和短信 String 接收类型⽂本
data.receive_types.value email_and_sms String 接收类型枚举值

响应解释
regions为区域(省-市/直辖市-区)的数据，示例仅展示部分区域，其他：

  • project_types -> project_type 项⽬类型
  • price_types -> price_type 价格⽤途
  • inquire_contents -> inquire_content 询价内容
  • additional_explains -> additional_explain 补充说明
  • receive_types -> receive_type 通知接收⽅式

此接⼝示例json均包含全部可选择值

regions部分有两层，第⼀层为省/直辖市，第⼆层为地级市/(直辖市下区/县)，分别为:

  • project_province_id 项⽬省份
  • project_city_id 项⽬城市
  • supplier_province_id 供应商省份
  • supplier_city_id 供应商城市

提供可选择项

提交询价枚举参数的传值均为接⼝返回项的value(不是label)

# 7. 询价详情

获取指定询价的详细信息

# 7.1 接口URL

/api/v1/outer/inquire/detail

# 7.2 请求方式

POST

# 7.3 Content-Type

application/json

# 7.4 请求Body参数

{
    "inquire_id": 19878
}
1
2
3
参数名 示例值 参数类型 是否必填 参数描述
inquire_id 19878 Integer 是 询价ID

# 7.5 响应示例

  • 成功(200)
{
  "code": 10000,
  "result": true,
  "message": "success",
  "data": {
    "inquire": {
      "inquire_id": 62,
      "actual_product_size": 58,
      "reply_desc": "慧讯⽹回复",
      "reply_time": "2022-12-04 15:42",
      "customer_state": "询价完成",
      "attachment_file_url": "https://rccfiles-test.oss-cn-hangzhou.aliyuncs.com/temp/xxx"    },
    "inquire_service": {
      "name": "张⽆忌",
      "qr_code": "https://wework.qpic.cn/wwpic3az",
      "mobile": "18787878787",
      "phone": "010 28787878"
    },
    "server_info": {
      "name": "张⽆忌",
      "qr_code": "https://wework.qpic.cn/wwpic3az",
      "mobile": "18787878787",
      "phone": "010 28787878"
    }
    "products": [
      {
        "product": {
          "product_name": "HF-⽔泥基渗透结晶型防⽔涂料",
          "model": "",
          "spec_name": "",
          "product_series": "",
          "notes": "25kg/桶",
          "product_category_name": "渗透结晶防⽔材料",
          "product_stop": false,
          "brand_name": "沪防 ",
          "brand_level_text": "普通",
          "short_brand_name": "沪防 ",
          "firm_name": "上海远盛建筑防⽔材料⼚",
          "compare_products": [
            {
              "product_name": "⽐价产品名称",
              "brand_name": "这是品牌名",
              "spec": "这是规格",
              "model": "这是型号",
              "params": [
                {
                  "param_name": "这是参数名",
                  "param_value_text": "这是参数值⽂本"
                }
              ],
              "market_price": "33.2",
              "market_price_unit": "元/吨",
              "project_price": "33.5",
              "project_price_unit": "元/吨",
              "contain_tax": true,
              "contain_freight": true,


              "tax_rate": 17,
              "firm_name": "北京瑞达恒建筑咨询",
              "contact": {
                "contact_name": "李⼥⼠",
                "phones": [
                  "123-4567-8910"
                ],
                "email": "",
                "qq": 0
              }
            }
          ]
        },
        "price": {
          "has_chapter": false,
          "has_pic": false,
          "picture_url": "",
          "contain_tax": true,
          "contain_freight": true,
          "publish_date": "2022-12-04",
          "project_price": "6,300.0",
          "market_price": "7,000.0",
          "unit_name": "t",
          "tax_rate": 17,
          "tax_type_text": "⼀般",
          "survey": "",
          "attachment_file_url": ""
        },
        "params": [
          {
            "rank": 27,
            "param_name": "组份",
            "param_value_text": "单组份",
            "param_unit_text": ""
          }
        ],
        "contact": {
          "contact_name": "李⼥⼠",
          "phones": [
            "123-4567-8910"
          ],
          "email": "",
          "qq": 0
        }
      }
    ]
 }
}
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
参数名 示例值 参数类型 参数描述
code 10000 Number 状态码(⾮10000异常)
result true Boolean 请求正常
message success String 异常的消息
data - Object 响应数据(异常时⽆此数据)
data.inquire - Object 询价信息
data.inquire.inquire_id 62 Number 询价ID
data.inquire.actual_product_size 58 Number 实际询价条数
data.inquire.customer_state 询价完成 String 询价状态，包括：信息读取中、资料审核中、查询准备中、询价师查询中、查询中（部分完成）、询价结果审核中、询价完成、询价取消、询价暂停
data.inquire.reply_desc - String 慧讯⽹回复
data.inquire.reply_time 2022-12-04
15:42 String 慧讯⽹回复时间
data.inquire.attachment_file_url htt ps://www.
baidu.com String 询价清单附件url
data.inquire_service - Object 询价师信息
data.inquire_service.name_cn 张三 String 询价师姓名
data.inquire_service.qr_code htt ps://wewo rk.q pic.cn/w w pic3az String 询价师微信⼆维码(链接)
data.inquire_service.mobile 18787878787 String 询价师⼿机号
data.inquire_service.phone 010
28787878 String 询价师电话
data.server_info - Object 客服信息
data.server_info.name_cn 张三 String 客服姓名
data.server_info.qr_code htt ps://wewo rk.q pic.cn/w w pic3az String 客服微信⼆维码(链接)
data.server_info.mobile 18787878787 String 客服⼿机号
data.server_info.phone 010
28787878 String 客服电话
data.products - Array 询价产品
data.products.product - Object 产品
data.products.product.product_name HF-⽔泥基渗透结晶型防⽔涂料 String 产品名
data.products.product.firm_name 上海远盛建筑
防⽔材料⼚ String 产品所在公司名称
data.products.product.model - String 型号
data.products.product.spec_name - String 规格
data.products.product.product_series - String 系列
data.products.product.notes 25kg/桶 String 备注
data.products.product.product_category_name 渗透结晶防⽔
材料 String 产品所属分类
data.products.product.product_stop false Boolean 是否停售产品
data.products.product.brand_name 沪防 String 品牌名
data.products.product.brand_level_text 普通 String 品牌档次
data.products.product.short_brand_name 沪防 String 缩略品牌名
data.products.product.compare_products - Array 产品⽐价抽检
data.products.product.compare_products.product_name 油井超细⽔泥
（800） String 产品名
data.products.product.compare_products.brand_name DMAR（德
美） String 品牌名
data.products.product.compare_products.spec 3-12 String 规格
data.products.product.compare_products.model 型号数据 String 型号
data.products.product.compare_products.params - Array 参数
data.products.product.compare_products.params.param_name 含碱度 String 参数名
data.products.product.compare_products.params.param_value_text 低碱 String 参数值
data.products.product.compare_products.market_price 33.2 String 市场价
data.products.product.compare_products.project_price 33.5 String ⼯程价
data.products.product.compare_products.contain_tax true Boolean 含税
data.products.product.compare_products.contain_freight true Boolean 含运费
data.products.product.compare_products.tax_rate 17 Number 税率
data.products.product.compare_products.firm_name 北京瑞达恒建
筑咨询 String 公司名
data.products.product.compare_products.contact - Object 联系⼈信息
data.products.product.compare_products.contact.contact_name 李⼥⼠ String 联系⼈姓
data.products.product.compare_products.contact.phones - Array 电话
data.products.product.compare_products.contact.email - String 邮箱
data.products.product.compare_products.contact.qq 0 Number QQ号
data.products.price - Object 报价
data.products.price.has_chapter false Boolean 有章
data.products.price.has_pic false Boolean 有图
data.products.price.picture_url - String 产品图⽚地址
data.products.price.contain_tax true Boolean 含税
data.products.price.contain_freight true Boolean 含运费
data.products.price.publish_date 2022-12-04 String 发布⽇期
data.products.price.project_price 6,300.0 String ⼯程价
data.products.price.market_price 7,000.0 String 市场价
data.products.price.unit_name t String 单位名称
data.products.price.tax_rate 17 Number 税率
data.products.price.tax_type_text ⼀般 String 纳税类型
data.products.price.survey - String 调研背景
data.products.price.attachment_file_url - String 报价单附件地址
data.products.params - Array 参数
data.products.params.rank 27 Number 参数序号
data.products.params.param_name 组份 String 参数名
data.products.params.param_value_text 单组份 String 参数值(⽂本)
data.products.params.param_unit_text - String 参数单位
data.products.contact - Object 联系⼈
data.products.contact.contact_name 李⼥⼠ String 联系⼈姓
data.products.contact.phones - Array 联系⼈电话
data.products.contact.email - String 联系⼈邮箱
data.products.contact.qq 0 Number 联系⼈qq号

# 8. 询价推送

提交询价后，每隔15分钟推送一次数据，格式与「询价详情接口」的 data 部分一致。
询价提交到慧讯⽹后，如下载附件失败或其他原因导致询价⽆法进⼊慧讯⽹系统的，慧讯⽹会给客户推送失败原因，推送接⼝主要数据如下：

参数 示例 类型 描述
inquire_id 19878 Integer 询价ID
error_msg 附件下载失败 String 失败原因

以上 调⽤客户⽅接⼝⽅式待客户提供。

←