{"openapi":"3.1.0","info":{"title":"诸葛公开能力接口","description":"查找诸葛军师上可下单的服务能力：recommend 一步给出最合适的几项及理由，capabilities 搜索与读取，找不到时用 demands 把需求交给平台（需用户同意留下联系方式）；查全球招标采购公告、海外合作商和民间商机的公开信息（tenders、partners、leads，不含联系方式，每条带来源和署名）。无需密钥；商家确认不代表平台核验。发起需求和付款沿用登录、授权及费用确认。 Find orderable services on 诸葛军师 (China): recommend, search, read, or hand the need to the platform; public tenders, overseas partners and trade leads (facts only). No key needed.","version":"1.2.0"},"paths":{"/api/capability-web/recommend":{"get":{"tags":["Public Capability Web"],"summary":"推荐最合适的服务","description":"最多 3 项推荐，每项带推荐理由、注意事项、价格周期等决策信息和下单方式；都不合适时附带 next_steps（例如把需求交给平台）。","operationId":"recommendServices","parameters":[{"name":"task","in":"query","required":true,"schema":{"type":"string","minLength":2,"maxLength":500,"description":"要办的事，中文或英文","title":"Task"},"description":"要办的事，中文或英文"},{"name":"region","in":"query","required":false,"schema":{"anyOf":[{"type":"string","maxLength":120},{"type":"null"}],"title":"Region"}},{"name":"budget","in":"query","required":false,"schema":{"anyOf":[{"type":"number","minimum":0},{"type":"null"}],"description":"预算（元）","title":"Budget"},"description":"预算（元）"},{"name":"within_days","in":"query","required":false,"schema":{"anyOf":[{"type":"integer","maximum":365,"minimum":1},{"type":"null"}],"description":"希望多少天内完成","title":"Within Days"},"description":"希望多少天内完成"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/capability-web/demands":{"post":{"tags":["Public Capability Web"],"summary":"把需求交给平台","description":"没有合适的服务时使用：平台联系合适的服务商并通过留下的联系方式回复用户；不收费，不会自动下单。须先征得用户同意。","operationId":"postDemand","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/DemandIn"}}},"required":true},"responses":{"201":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/capability-web/capabilities":{"get":{"tags":["Public Capability Web"],"summary":"搜索服务能力","description":"按关键词、分类、地区搜索公开的服务能力，按匹配度排序；每项带价格、周期、地区和网页地址。","operationId":"searchServices","parameters":[{"name":"q","in":"query","required":false,"schema":{"type":"string","maxLength":200,"description":"要找的服务，中文或英文，例如 海报设计、logistics","default":"","title":"Q"},"description":"要找的服务，中文或英文，例如 海报设计、logistics"},{"name":"category","in":"query","required":false,"schema":{"anyOf":[{"type":"string","maxLength":80},{"type":"null"}],"description":"服务分类，取值见 listFacets(kind=categories)","title":"Category"},"description":"服务分类，取值见 listFacets(kind=categories)"},{"name":"region","in":"query","required":false,"schema":{"anyOf":[{"type":"string","maxLength":120},{"type":"null"}],"description":"服务地区，例如 杭州、全国","title":"Region"},"description":"服务地区，例如 杭州、全国"},{"name":"after","in":"query","required":false,"schema":{"type":"integer","minimum":0,"description":"翻页：上一页的 next_cursor","default":0,"title":"After"},"description":"翻页：上一页的 next_cursor"},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":100,"minimum":1,"default":24,"title":"Limit"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/capability-web/capabilities/{public_id}":{"get":{"tags":["Public Capability Web"],"summary":"查看一项服务","description":"一项服务的完整资料：内容、价格、周期、交付物、验收标准、服务商和下单方式。","operationId":"getService","parameters":[{"name":"public_id","in":"path","required":true,"schema":{"type":"string","maxLength":80,"description":"能力编号，来自 searchServices 或 recommendServices 的结果","title":"Public Id"},"description":"能力编号，来自 searchServices 或 recommendServices 的结果"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/capability-web/providers/{provider_id}":{"get":{"tags":["Public Capability Web"],"summary":"查看服务商及其服务","operationId":"getProvider","parameters":[{"name":"provider_id","in":"path","required":true,"schema":{"type":"integer","title":"Provider Id"}},{"name":"after","in":"query","required":false,"schema":{"type":"integer","minimum":0,"default":0,"title":"After"}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":100,"minimum":1,"default":24,"title":"Limit"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/capability-web/facets/{kind}":{"get":{"tags":["Public Capability Web"],"summary":"列出服务分类或地区","operationId":"listFacets","parameters":[{"name":"kind","in":"path","required":true,"schema":{"type":"string","description":"categories（分类）或 regions（地区）","title":"Kind"},"description":"categories（分类）或 regions（地区）"},{"name":"after","in":"query","required":false,"schema":{"type":"string","maxLength":120,"default":"","title":"After"}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":1000,"minimum":1,"default":100,"title":"Limit"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/capability-network/ai/v1/public/tenders":{"get":{"tags":["Open Capability Network","诸葛军师公开数据（免密钥）"],"summary":"搜索招标采购公告（免密钥）","description":"全球公开招标公告的公开信息：每条带来源、许可、署名和网页链接；不含联系方式。每个来源地址每天有次数上限。","operationId":"publicSearchTenders","parameters":[{"name":"q","in":"query","required":false,"schema":{"type":"string","maxLength":120,"description":"关键词，中文或外文；空格表示\"并且\"，逗号表示\"或\"","default":"","title":"Q"},"description":"关键词，中文或外文；空格表示\"并且\"，逗号表示\"或\""},{"name":"country","in":"query","required":false,"schema":{"type":"string","maxLength":80,"default":"","title":"Country"}},{"name":"category","in":"query","required":false,"schema":{"type":"string","pattern":"^(goods|works|services|consulting|other)?$","description":"goods 货物、works 工程、services 服务、consulting 咨询、other 其他","default":"","title":"Category"},"description":"goods 货物、works 工程、services 服务、consulting 咨询、other 其他"},{"name":"sector","in":"query","required":false,"schema":{"type":"string","maxLength":60,"default":"","title":"Sector"}},{"name":"source","in":"query","required":false,"schema":{"type":"string","maxLength":30,"default":"","title":"Source"}},{"name":"route","in":"query","required":false,"schema":{"type":"string","maxLength":20,"pattern":"^[ABCDEXabcdex, ]*$","description":"承接路径，多个用逗号：A 直接投、B 中国货物、C 联合体或分包、D 转介、E 观察","default":"","title":"Route"},"description":"承接路径，多个用逗号：A 直接投、B 中国货物、C 联合体或分包、D 转介、E 观察"},{"name":"amount_min_usd","in":"query","required":false,"schema":{"anyOf":[{"type":"number","minimum":0},{"type":"null"}],"title":"Amount Min Usd"}},{"name":"amount_max_usd","in":"query","required":false,"schema":{"anyOf":[{"type":"number","minimum":0},{"type":"null"}],"title":"Amount Max Usd"}},{"name":"deadline_from","in":"query","required":false,"schema":{"type":"string","pattern":"^(\\d{4}-\\d{2}-\\d{2})?$","description":"日期 YYYY-MM-DD","default":"","title":"Deadline From"},"description":"日期 YYYY-MM-DD"},{"name":"deadline_to","in":"query","required":false,"schema":{"type":"string","pattern":"^(\\d{4}-\\d{2}-\\d{2})?$","description":"日期 YYYY-MM-DD","default":"","title":"Deadline To"},"description":"日期 YYYY-MM-DD"},{"name":"published_from","in":"query","required":false,"schema":{"type":"string","pattern":"^(\\d{4}-\\d{2}-\\d{2})?$","description":"日期 YYYY-MM-DD","default":"","title":"Published From"},"description":"日期 YYYY-MM-DD"},{"name":"published_to","in":"query","required":false,"schema":{"type":"string","pattern":"^(\\d{4}-\\d{2}-\\d{2})?$","description":"日期 YYYY-MM-DD","default":"","title":"Published To"},"description":"日期 YYYY-MM-DD"},{"name":"flags","in":"query","required":false,"schema":{"type":"string","maxLength":120,"pattern":"^((lots|consortium|subcontracting|framework|siteVisit|guarantee)(,|$))*$","description":"要点，逗号分开：lots 标段、consortium 联合投标、subcontracting 分包、framework 框架协议、siteVisit 现场踏勘、guarantee 保证金","default":"","title":"Flags"},"description":"要点，逗号分开：lots 标段、consortium 联合投标、subcontracting 分包、framework 框架协议、siteVisit 现场踏勘、guarantee 保证金"},{"name":"documents","in":"query","required":false,"schema":{"type":"string","pattern":"^(free|restricted|purchase|request|platform)?$","default":"","title":"Documents"}},{"name":"sort","in":"query","required":false,"schema":{"enum":["","relevance","deadline","published","amount"],"type":"string","default":"","title":"Sort"}},{"name":"direction","in":"query","required":false,"schema":{"enum":["asc","desc"],"type":"string","default":"asc","title":"Direction"}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":20,"minimum":1,"default":10,"title":"Limit"}},{"name":"offset","in":"query","required":false,"schema":{"type":"integer","maximum":1000,"minimum":0,"default":0,"title":"Offset"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"400":{"description":"请求未能完成或参数不符合要求，message 说明原因"},"401":{"description":"缺少或无效的接入密钥"},"403":{"description":"密钥没有这项权限，或需要账号本人在网站上操作"},"404":{"description":"没有找到，或不属于密钥所属账号"},"409":{"description":"与当前状态冲突"},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"429":{"description":"今天这项操作已达上限"},"503":{"description":"服务繁忙，请稍后重试"}}}},"/api/capability-network/ai/v1/public/tenders/filters":{"get":{"tags":["Open Capability Network","诸葛军师公开数据（免密钥）"],"summary":"招标搜索的筛选项（免密钥）","operationId":"publicGetTenderFilters","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"400":{"description":"请求未能完成或参数不符合要求，message 说明原因"},"401":{"description":"缺少或无效的接入密钥"},"403":{"description":"密钥没有这项权限，或需要账号本人在网站上操作"},"404":{"description":"没有找到，或不属于密钥所属账号"},"409":{"description":"与当前状态冲突"},"429":{"description":"今天这项操作已达上限"},"503":{"description":"服务繁忙，请稍后重试"}}}},"/api/capability-network/ai/v1/public/tenders/{tender_id}":{"get":{"tags":["Open Capability Network","诸葛军师公开数据（免密钥）"],"summary":"查看招标公告详情（免密钥）","operationId":"publicGetTender","parameters":[{"name":"tender_id","in":"path","required":true,"schema":{"type":"integer","title":"Tender Id"}},{"name":"include_original","in":"query","required":false,"schema":{"type":"boolean","description":"附上许可允许的原文（最多 8000 字）","default":false,"title":"Include Original"},"description":"附上许可允许的原文（最多 8000 字）"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"400":{"description":"请求未能完成或参数不符合要求，message 说明原因"},"401":{"description":"缺少或无效的接入密钥"},"403":{"description":"密钥没有这项权限，或需要账号本人在网站上操作"},"404":{"description":"没有找到，或不属于密钥所属账号"},"409":{"description":"与当前状态冲突"},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"429":{"description":"今天这项操作已达上限"},"503":{"description":"服务繁忙，请稍后重试"}}}},"/api/capability-network/ai/v1/public/partners":{"get":{"tags":["Open Capability Network","诸葛军师公开数据（免密钥）"],"summary":"搜索海外合作商（免密钥）","operationId":"publicSearchPartners","parameters":[{"name":"q","in":"query","required":false,"schema":{"type":"string","maxLength":80,"default":"","title":"Q"}},{"name":"country","in":"query","required":false,"schema":{"type":"string","pattern":"^([A-Za-z]{2})?$","default":"","title":"Country"}},{"name":"industry","in":"query","required":false,"schema":{"type":"string","maxLength":60,"description":"带前缀的行业编码，如 NACE:46、HS:8516、zhuge:food","default":"","title":"Industry"},"description":"带前缀的行业编码，如 NACE:46、HS:8516、zhuge:food"},{"name":"role","in":"query","required":false,"schema":{"enum":["","agent","manufacturer_rep","distributor","wholesaler","importer","reseller","franchisee","franchisor","service_provider","logistics","installer","consultant","trade_body","bid_partner","bid_lead"],"type":"string","default":"","title":"Role"}},{"name":"language","in":"query","required":false,"schema":{"type":"string","maxLength":20,"default":"","title":"Language"}},{"name":"tier_at_least","in":"query","required":false,"schema":{"enum":["A","B","C"],"type":"string","default":"C","title":"Tier At Least"}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":20,"minimum":1,"default":10,"title":"Limit"}},{"name":"offset","in":"query","required":false,"schema":{"type":"integer","maximum":1000,"minimum":0,"default":0,"title":"Offset"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"400":{"description":"请求未能完成或参数不符合要求，message 说明原因"},"401":{"description":"缺少或无效的接入密钥"},"403":{"description":"密钥没有这项权限，或需要账号本人在网站上操作"},"404":{"description":"没有找到，或不属于密钥所属账号"},"409":{"description":"与当前状态冲突"},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"429":{"description":"今天这项操作已达上限"},"503":{"description":"服务繁忙，请稍后重试"}}}},"/api/capability-network/ai/v1/public/partners/{partner_id}":{"get":{"tags":["Open Capability Network","诸葛军师公开数据（免密钥）"],"summary":"查看合作商资料（免密钥）","operationId":"publicGetPartner","parameters":[{"name":"partner_id","in":"path","required":true,"schema":{"type":"string","title":"Partner Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"400":{"description":"请求未能完成或参数不符合要求，message 说明原因"},"401":{"description":"缺少或无效的接入密钥"},"403":{"description":"密钥没有这项权限，或需要账号本人在网站上操作"},"404":{"description":"没有找到，或不属于密钥所属账号"},"409":{"description":"与当前状态冲突"},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"429":{"description":"今天这项操作已达上限"},"503":{"description":"服务繁忙，请稍后重试"}}}},"/api/capability-network/ai/v1/public/leads":{"get":{"tags":["Open Capability Network","诸葛军师公开数据（免密钥）"],"summary":"搜索民间商机（免密钥）","operationId":"publicSearchTradeLeads","parameters":[{"name":"q","in":"query","required":false,"schema":{"type":"string","maxLength":120,"description":"关键词，中文或外文；空格表示\"并且\"，逗号表示\"或\"","default":"","title":"Q"},"description":"关键词，中文或外文；空格表示\"并且\"，逗号表示\"或\""},{"name":"audience","in":"query","required":false,"schema":{"enum":["buyers","partners"],"type":"string","default":"buyers","title":"Audience"}},{"name":"kind","in":"query","required":false,"schema":{"enum":["","purchase","cooperation","sales_agent","skill_learner","franchise_seeker"],"type":"string","default":"","title":"Kind"}},{"name":"region","in":"query","required":false,"schema":{"type":"string","maxLength":80,"default":"","title":"Region"}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":20,"minimum":1,"default":10,"title":"Limit"}},{"name":"offset","in":"query","required":false,"schema":{"type":"integer","maximum":1000,"minimum":0,"default":0,"title":"Offset"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"400":{"description":"请求未能完成或参数不符合要求，message 说明原因"},"401":{"description":"缺少或无效的接入密钥"},"403":{"description":"密钥没有这项权限，或需要账号本人在网站上操作"},"404":{"description":"没有找到，或不属于密钥所属账号"},"409":{"description":"与当前状态冲突"},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"429":{"description":"今天这项操作已达上限"},"503":{"description":"服务繁忙，请稍后重试"}}}},"/api/capability-network/ai/v1/public/leads/{lead_id}":{"get":{"tags":["Open Capability Network","诸葛军师公开数据（免密钥）"],"summary":"查看民间商机（免密钥）","operationId":"publicGetTradeLead","parameters":[{"name":"lead_id","in":"path","required":true,"schema":{"type":"string","title":"Lead Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"400":{"description":"请求未能完成或参数不符合要求，message 说明原因"},"401":{"description":"缺少或无效的接入密钥"},"403":{"description":"密钥没有这项权限，或需要账号本人在网站上操作"},"404":{"description":"没有找到，或不属于密钥所属账号"},"409":{"description":"与当前状态冲突"},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"429":{"description":"今天这项操作已达上限"},"503":{"description":"服务繁忙，请稍后重试"}}}}},"components":{"schemas":{"DemandIn":{"properties":{"need":{"type":"string","maxLength":2000,"minLength":8,"title":"Need","description":"要办的事：做什么、交付什么、什么时候要"},"contact":{"type":"string","maxLength":80,"minLength":3,"title":"Contact","description":"手机号、邮箱或微信号"},"contact_consent":{"type":"boolean","title":"Contact Consent","description":"用户已同意留下联系方式（必须为 true）"},"region":{"anyOf":[{"type":"string","maxLength":60},{"type":"null"}],"title":"Region"},"budget":{"anyOf":[{"type":"string","maxLength":60},{"type":"null"}],"title":"Budget"},"deadline":{"anyOf":[{"type":"string","maxLength":60},{"type":"null"}],"title":"Deadline"},"contact_name":{"anyOf":[{"type":"string","maxLength":40},{"type":"null"}],"title":"Contact Name"}},"additionalProperties":false,"type":"object","required":["need","contact","contact_consent"],"title":"DemandIn"},"HTTPValidationError":{"properties":{"detail":{"items":{"$ref":"#/components/schemas/ValidationError"},"type":"array","title":"Detail"}},"type":"object","title":"HTTPValidationError"},"ValidationError":{"properties":{"loc":{"items":{"anyOf":[{"type":"string"},{"type":"integer"}]},"type":"array","title":"Location"},"msg":{"type":"string","title":"Message"},"type":{"type":"string","title":"Error Type"},"input":{"title":"Input"},"ctx":{"type":"object","title":"Context"}},"type":"object","required":["loc","msg","type"],"title":"ValidationError"}}},"servers":[{"url":"https://zhugejunshi.com"}]}