海叔 API
开发者文档 · V1.0

API 接入文档

通过简洁的 RESTful API，把海叔的同城生活服务能力接入你的网站、小程序或应用。

基础 URLhttps://api.haishu.com/v1
i

当前页面为前端演示，在线调试返回模拟数据。接入生产环境时请从服务端安全调用 API。

身份认证

海叔 API 使用 Bearer Token 认证。请在每次请求的 Header 中携带你的 API Key。

Authorization: Bearer YOUR_API_KEY
Content-Type: application/json
POST/chat创建对话

发送自然语言消息，获得海叔的回答以及可选的本地服务结果。

请求示例

{
  "message": "帮我找附近的空调维修师傅",
  "location": {
    "city": "杭州",
    "district": "西湖区"
  },
  "stream": false
}

响应示例

{
  "id": "chat_8f2a91",
  "reply": "为你找到 3 位附近的认证师傅。",
  "intent": "repair",
  "services": [
    { "name": "王师傅", "rating": 4.9, "price": 40 }
  ]
}
GET/services获取本地服务商

按城市、服务类型、距离或评分筛选本地服务商。

参数类型说明
citystring城市名称，必填
categorystring服务分类，如 repair、taxi
limitnumber返回数量，默认 10
TRY IT NOW

在线调试

输入一句需求，查看模拟 API 返回结果。

200 OK响应时间 286ms
{
  "status": "ready",
  "message": "点击上方按钮发送模拟请求"
}