向导管理 API

网约向导技术团队发布于 2026-02-01更新于 2026-04-10

接口概览

向导管理模块提供向导信息的完整 CRUD 操作接口,支持按区域、服务类型、评分等多维度查询。

获取向导列表

请求

GET /open/v1/guide/list
参数:
  page     - 页码,默认 1
  size     - 每页数量,默认 10
  area     - 服务区域(可选)
  status   - 状态筛选(可选)

响应

{
  "code": 200,
  "data": {
    "total": 128,
    "list": [
      {
        "guideId": "G10001",
        "name": "张导",
        "area": "北京",
        "rating": 4.8,
        "status": "active"
      }
    ]
  }
}

获取向导详情

GET /open/v1/guide/detail/{guideId}

返回向导的完整信息,包括个人资料、服务区域、评价统计和可用时间段。

错误码

  • 40001 — 参数缺失或格式错误
  • 40003 — 无权限访问该向导信息
  • 40004 — 向导不存在