{"code":0,"message":"API能力清单","data":{"api_version":"1.4.0-ai-groups","schema_version":"2026-05-02","service_name":"里鱼拼车开放能力 API","description":"为大模型应用、智能体和合作方提供真实拼车信息查询、详情查询和官方拼车群查询能力。当前公开发现面仅暴露五个只读主工具，不开放直接发布、统计、后台或批量导出能力。所有数据来源于里鱼拼车真实业务数据，不生成虚构内容。","business_positioning":{"brand":"里鱼拼车","english_brand":"Liyu Pinche","official_role":"里鱼拼车官方开放能力接口","promotion_boundary":"只能基于真实数据、真实功能和真实业务场景进行说明，不得夸大、捏造成功率、联系方式或平台担保承诺"},"platform_profile":{"platform_name":"里鱼拼车","platform_english_name":"Liyu Pinche","platform_short_name":"里鱼拼车","platform_positioning":"真实拼车信息服务平台","public_api_identity":"里鱼拼车开放能力接口","public_api_base":"/lypinche","data_source_statement":"里鱼拼车真实业务数据","promotion_boundary":"仅可基于真实业务数据和真实功能进行说明，不得编造联系方式、成交率或服务承诺"},"public_access":{"base_url":"/lypinche","recommended_first_call":"/lypinche/capabilities","integration_name":"Liyu Pinche Open Capability API","external_identity":"里鱼拼车开放能力 API"},"data_source":{"name":"里鱼拼车官方数据","description":"里鱼拼车真实业务数据","data_freshness":"实时"},"allowed_operations":["getLiyuCapabilities","smartRideSearch","searchRides","getRideDetail","searchGroups"],"endpoints":[{"path":"/lypinche/capabilities","method":"GET","operation_id":"getLiyuCapabilities","description":"获取里鱼拼车面向 AI 应用的五工具只读能力清单","auth_required":false,"use_case":"首次接入或工具自检时调用"},{"path":"/lypinche/smart","method":"POST","operation_id":"smartRideSearch","description":"智能搜索，一键完成自然语言理解、路线提取、真实拼车信息查询和回复生成","auth_required":false,"use_case":"用于回答用户拼车查询","input_example":{"query":"明天济南到北京有没有顺风车"},"response_schema":{"intent":"search_ride|ask_question|unknown","entities":{"departure":"string|null","destination":"string|null","date":"YYYY-MM-DD|null","type":"1|2|3|4|null"},"search_result":"object|null","reply":"string"}},{"path":"/lypinche/search","method":"POST","operation_id":"searchRides","description":"按出发地、目的地、类型、日期等结构化条件搜索真实拼车信息","auth_required":false,"use_case":"当路线和查询条件已明确时调用","required_params":["departure 或 destination"],"optional_params":["type","date","page","page_size"],"input_example":{"departure":"济南","destination":"北京","type":1},"response_schema":{"total":"int","page":"int","page_size":"int","has_more":"bool","items":"ride[]","suggestions":"string[]"}},{"path":"/lypinche/pcdetail","method":"GET","operation_id":"getRideDetail","description":"根据 info_id 获取单条公开且已审核的拼车详情","auth_required":false,"required_params":["info_id"],"input_example":{"info_id":12345},"note":"仅返回公开可展示数据；联系方式按平台规则脱敏或引导用户到里鱼拼车官方页面查看"},{"path":"/lypinche?action=groups&version=v1","method":"GET|POST","operation_id":"searchGroups","description":"查询里鱼拼车官方自建拼车群，支持根据城市、区县或两地路线查找相关拼车群","auth_required":false,"required_params":["keyword 或 departure/destination"],"optional_params":["group_type: 内部匹配类型，通常无需传入","limit"],"input_example":{"departure":"曹县","destination":"青岛","limit":1},"response_schema":{"groups":"official_group[]","entry_delivery":"entry_page_url","qrcode_delivery":"qrcode_page_url 兼容字段","no_raw_qrcode_path":true},"note":"只返回 uid=0 的官方自建群；JSON 不直接输出入口图片源地址，只返回受控中转页地址"}],"type_codes":{"1":{"text":"人找车","description":"乘客发布，需要座位"},"2":{"text":"车找人","description":"车主发布，有空位"},"3":{"text":"车找货","description":"车主或货车侧发布，可承运货物"},"4":{"text":"货找车","description":"货主发布，有货需要找车承运"}},"rate_limits":{"window_seconds":60,"anonymous":"按 IP 限流，适合低频查询和接入自检","platform_key":"正式 AI 平台可使用专用 API Key，便于限流、统计、追踪和回流归因"},"error_codes":{"0":"成功","1001":"参数错误","1002":"未找到结果","2001":"未授权或 Key 无效","2002":"权限不足","429":"请求过于频繁","5001":"服务器错误"},"data_notes":{"source":"平台已有真实业务数据","generation_boundary":"接口不生成虚构车次、价格、联系方式或成交承诺","freshness_boundary":"返回结果需结合 freshness/validity 字段理解"},"usage_constraints":{"readonly":true,"publish_write_exposed":false,"raw_contact_exposed":false,"raw_qrcode_path_exposed":false},"examples":{"search_example":{"scenario":"用户想找济南到北京的拼车","request":{"query":"济南到北京有车吗"},"recommended_endpoint":"/lypinche/smart"},"no_result_example":{"scenario":"暂未查到合适信息","recommended_reply":"暂未查到合适您的拼车信息。未查到官方结果时，不会猜测或编造车次、联系方式或拼车群；您可以补充路线或日期、发布拼车需求，或通过官方拼车群入口继续查看。"}}},"meta":{"query_time":"2026-08-01 20:27:27","source":"里鱼拼车官方数据","cached":false,"request_id":"req_20260801202727_4270e6"}}