帮家师傅

API PORTAL

厂家 API 接口

给厂家和服务商接售后流程用：创建工单、查询工单状态、查师傅、查网点，再通过回调把进度同步回自己的系统。

查看文档 在线调试 获取密钥
工单

创建、查询、接收状态回调。

师傅

按城市和品类查询公开师傅。

网点

查询服务网点、地址和团队信息。

认证

通过 API Key 进行接口访问。

接口列表

常用接口先列在这里，详细字段以文档页为准。

查看 OpenAPI
方法路径说明操作
POST/api/v1/orders创建维修工单，提交用户、地址、品类和故障描述。详情
GET/api/v1/orders/{id}查询工单状态、师傅信息和处理进度。详情
GET/api/v1/engineers按城市、品类、评分等条件查询公开师傅。详情
GET/api/v1/stations按城市、品类和品牌标签查询服务网点。详情
POST/api/v1/callback接收工单状态变化通知，便于同步到厂家系统。详情

API 常见问题

联调前通常会先确认这些信息

厂家 API 适合做什么？

适合厂家或服务商把自有售后系统接到帮家师傅，用来创建工单、查状态、查师傅和查网点。

调用接口需要什么认证？

接口通过 API Key 访问。正式使用前需要先申请合作账号，并确认调用频率、回调地址和业务字段。

工单状态怎么同步？

厂家可以主动查询工单详情，也可以配置回调地址，由平台在状态变化时推送通知。

师傅和网点数据能直接用于派单吗？

公开资料可用于筛选和判断，正式派单还需要结合合作关系、服务范围和工单规则确认。