熊洞服务开放接口 - 熊洞科技开放平台

小智回收熊洞服务物流服务

返回首页

业务介绍

熊洞服务是熊洞科技旗下专业家电服务平台，覆盖安装、维修、清洗、拆装等全品类家电服务。通过开放平台，您可以将家电服务能力嵌入自有系统，实现从用户下单到工程师上门履约的完整闭环。服务通知机制确保每次状态变更都能实时触达。

工单智能管理

自动创建、分配、追踪工单全生命周期，支持催单、取消、改约、再次上门

工程师调度系统

自动匹配就近工程师，支持服务通知推送（分配、接单、开始服务、完工等10种通知类型）

全品类服务能力

覆盖安装、维修、检测、保养、拆机、拆装、回收等 8 种服务类型，支持 11 大品类

服务商品管理

可查询服务商品 SKU 列表，支持品牌、品类、型号维度筛选

电子签收单

服务完成后可查询电子签收单 PDF，支持线上化归档与对账

服务通知回调

10种通知类型（分配、接单、改约、开始、完工、审核、取消等），全流程实时推送

800+

服务门店网络

24h

核心城市响应

种服务类型

种通知类型

典型应用场景

电商平台服务嵌入

在电商商品详情页提供安装/维修服务预约，用户下单即安排工程师上门

品牌商售后体系

品牌商通过 API 对接全国售后服务网络，统一管理与调度工程师

物业管理集成

物业公司嵌入家电维修服务能力，为业主提供一站式居家服务

连锁门店管理

连锁零售门店统一管理售后工单，自动派单至就近工程师

接入指南

按照以下步骤完成熊洞服务 API 的接入，全程技术团队提供支持。

认证方式

熊洞服务 API 采用 Header 参数认证方式。每次请求需在 Header 中携带 APPKEY、TIMEMILLIS 和 SIGN 三个参数，SIGN 通过 MD5 签名算法生成。

APPKEY应用 APPKEY，由熊洞提供

TIMEMILLIS当前毫秒级时间戳

SIGN签名 = MD5(APPKEY + TIMEMILLIS + APPSECRET)

签名规则

text

签名规则：SIGN = MD5(APPKEY + TIMEMILLIS + APPSECRET)
示例：APPKEY = "B202206142044504181292148"
      TIMEMILLIS = "1695102019000"
      APPSECRET = "16e8615fa24e36f56490d65b2f2d345d"
      SIGN = MD5("B202206142044504181292148169510201900016e8615fa24e36f56490d65b2f2d345d")

注册成为熊洞商家

前往熊洞商家中心注册账号，提交企业营业执照、法人身份证等资质信息，完成商家认证。

前往商家中心注册 →

联系商务审核

联系熊洞商务团队进行资质审核，确认服务业务接入需求与方案。商务联系电话：400-155-5151。

拨打商务电话 →

获取对接信息

商务审核通过后创建对接群，由小智开发团队提供 APPKEY、APPSECRET 等对接凭证。注意：调用方服务器 IP 需提前报备，否则下单会失败。

text

// 对接凭证
APPKEY = "B202206142044504181292148"      // 由小智开发提供
APPSECRET = "16e8615fa24e36f56490d65b2f2d345d"  // 由小智开发提供

// 签名规则
SIGN = MD5(APPKEY + TIMEMILLIS + APPSECRET)
// 示例
TIMEMILLIS = "1695102019000"
SIGN = MD5("B202206142044504181292148" + "1695102019000" + "16e8615fa24e36f56490d65b2f2d345d")

开始联调测试

在 Header 中携带 APPKEY、TIMEMILLIS、SIGN 三个认证参数，Body 传入 JSON 格式的订单信息进行联调测试。

bash

curl -X POST "https://api.bearhome.cn/api/order/open/v1/preorder" \
  -H "APPKEY: B202206142044504181292148" \
  -H "TIMEMILLIS: 1695102019000" \
  -H "SIGN: xxxxxx" \
  -H "Content-Type: application/json" \
  -d '{"saleOrderNo":"SO001","receiver":"张三","serviceType":1,...}'

验收上线

联调测试通过后，配置线上 APPSECRET 信息，切换至生产环境地址正式上线。同时实现服务情况通知回调接口（servicenotify），接收工程师分配、开始服务、完工等 10 种状态通知。

text

# 生产环境
https://api.bearhome.cn/api/order/open/v1/

环境地址

生产环境https://api.bearhome.cn/api/order/open/v1/

开发环境联系商务获取开发环境地址

API 文档

熊洞服务提供以下 API 接口，点击展开查看详细参数与示例。

POST

/api/order/open/{version}/preorder

服务下单

展开

参数名	类型	必填	说明
saleOrderNo	string	是	三方销售单号
receiver	string	是	收件人姓名
receiverMobile	string	是	收件人手机号
provinceName	string	是	省份
cityName	string	是	城市
areaName	string	是	区域
receiverAddress	string	是	详细地址
serviceType	int	是	服务类型：1安装/2维修/3检测/4保养/5拆机/6其他/7拆装/8回收
paymentWay	int	是	支付方式：1钱包/2支付链接
inGuaranteePeriod	int	是	保修期：0保外/1保内/2其他
details	array	是	商品明细（skuId/skuNum/productBrand/productName 等）
reservationTime	string	否	预约时间

POST

/api/order/open/{version}/skulist

服务商品列表

展开

GET

/api/order/open/{version}/orderinfo

查询订单信息

展开

参数名	类型	必填	说明
orderCode	string	否	熊洞订单号（与 saleOrderNo 二选一）
saleOrderNo	string	否	三方销售单号

POST

/api/order/open/{version}/orderpage

查询订单分页列表

展开

参数名	类型	必填	说明
beginDateTime	string	否	开始时间
endDateTime	string	否	结束时间
customerMobile	string	否	客户手机号
orderCode	string	否	熊洞订单号
saleOrderNo	string	否	三方销售单号
serviceType	int	否	服务类型
pageNo	int	是	页码
pageSize	int	是	每页条数

POST

/api/order/open/{version}/cancelorder

取消订单

展开

参数名	类型	必填	说明
orderCode	string	是	熊洞订单号
cancelReason	string	是	取消原因

POST

/api/order/open/{version}/changereservationtime

更改预约时间

展开

参数名	类型	必填	说明
saleOrderNo	string	是	三方销售单号
reservationTime	string	是	新的预约时间

POST

/api/order/open/{version}/urgentorder

催单

展开

参数名	类型	必填	说明
saleOrderNo	string	是	三方销售单号
urgentContent	string	是	催单内容

GET

/api/order/open/{version}/selSignReceipt

查询电子签收单

展开

参数名	类型	必填	说明
saleOrderNo	string	是	三方销售单号

常见问题

整理了接入熊洞服务 API 过程中最常见的问题与解答。

−接入熊洞服务 API 需要什么条件？

需要提供企业资质信息并申请 APPKEY 和 APPSECRET。特别注意的是，调用方服务器 IP 需要提前报备，IP 变化时需及时联系或后台更改，否则下单会失败。

+签名算法是怎样的？

+服务类型有哪些？

+服务通知有哪些类型？

+工程师隐私信息如何处理？

+支付方式有哪些？

没有找到答案？

如果以上内容未能解决您的问题，请随时联系我们的技术支持团队，我们将为您提供一对一接入指导。

联系技术支持 →

业务介绍

工单智能管理

工程师调度系统

全品类服务能力

服务商品管理

电子签收单

服务通知回调

典型应用场景

电商平台服务嵌入

品牌商售后体系

物业管理集成

连锁门店管理

接入指南

认证方式

注册成为熊洞商家

联系商务审核

获取对接信息

开始联调测试

验收上线

环境地址

API 文档

请求 Body 参数

请求示例

返回示例

请求示例

返回示例

请求 Query 参数

请求示例

返回示例

请求 Body 参数

请求示例

返回示例

请求 Body 参数

请求示例

返回示例

请求 Body 参数

请求示例

返回示例

请求 Body 参数

请求示例

返回示例

请求 Query 参数

请求示例

返回示例

常见问题

没有找到答案？