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/parse
Content-Type: application/json

请求：

{
  "query": "我是车主明早从济南到北京，可以带三个人"
}

用途：只解析意图和字段，不返回完整车源列表。

结构化查车

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

请求：

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

page_size preview schema 上限为 20。

单条详情

GET /lypinche/pcdetail?info_id=12345

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

搜索官方拼车群

GET /lypinche/groups?keyword=云南河口拼车群&limit=3

也可传：

departure
destination
group_type
include_detail

用途：搜索已核验官方拼车群，返回 entry_page_url 等中转页字段。

官方拼车群详情

GET /lypinche/group_detail?group_id=2447

用途：查询单个官方拼车群详情。JSON 不返回原始二维码文件路径。

官方拼车群中转页

GET /lypinche/group_page?group_id=2447

返回 HTML 中转页，供用户打开查看群规、安全提示和群入口。AI 平台不应解析或转述二维码内容。

查车无结果后的下一步

GET /lypinche/next_action?departure=邳州&destination=武汉&ride_result_count=0&limit=3

用途：返回可选下一步和相关官方拼车群入口。该接口只读，不执行发布写入。