API Reference

Base URL

https://www.pcsfc.com

通用响应

JSON 接口通常返回：

{
  "code": 0,
  "message": "success",
  "data": {},
  "meta": {
    "source": "里鱼拼车官方数据",
    "request_id": "req_xxx"
  }
}

code=0 表示业务成功。调用方应优先根据 data 中的结构化字段回答，不补充接口未返回的车源、价格、联系方式或群入口。

能力清单

GET /lypinche/capabilities

用于读取当前只读能力、调用边界和服务说明。

自然语言查车

POST /lypinche/smart
Content-Type: application/json

请求：

{
  "query": "明天济南到北京有没有顺风车"
}

用途：让接口识别拼车意图、抽取路线和时间，并返回真实查询结果或下一步建议。

结构化查车

POST /lypinche/search
Content-Type: application/json

请求：

{
  "departure": "济南",
  "destination": "北京",
  "page": 1,
  "page_size": 10
}

page_size 当前公开候选上限为 5。

单条详情

GET /lypinche/pcdetail?info_id=12345

用途：按拼车信息 ID 查询公开详情。联系方式必须保持脱敏。

搜索官方拼车群

GET /lypinche?action=groups&version=v1&keyword=云南河口拼车群&limit=3&include_detail=0

路线群请求尽量同时传 departure 和 destination。用途：搜索已核验官方城市群、县区群和线路群入口，返回 entry_page_url 等受控中转页字段。

AI 平台只使用 searchGroups 一个群入口工具；不调用历史群详情、群页面或下一步推荐拆分工具。