能力网公开接口文档

查找平台上可下单的服务、服务商、分类和地区，查公开的招标采购、海外合作商和商机信息；找不到合适服务时可以把需求交给平台。不需要密钥。

适合：做搜索、比价、目录展示或数据分析的开发者和 AI 助手

服务地址: https://zhugejunshi.com
鉴权: 不需要密钥
接口数量: 13 个 · 文档版本 1.2.0
文档文件: capability-web.json（OpenAPI，可导入 Postman、Apifox 等工具）

使用须知

只返回公开资料，不含联系方式；下单和付款需要登录后在网站完成。
提交需求前要先征得用户同意留下联系方式；平台联系服务商后回复，不收费，也不会自动下单。
每个来源地址每分钟最多 60 次，所有匿名调用合计每分钟有总上限；超出返回 429 并带 Retry-After: 60。

查找诸葛军师上可下单的服务能力：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.

Public Capability Web

/api/capability-web/recommend

不需要密钥

最多 3 项推荐，每项带推荐理由、注意事项、价格周期等决策信息和下单方式；都不合适时附带 next_steps（例如把需求交给平台）。

请求参数

推荐最合适的服务的请求参数
参数	位置	类型	必填	说明
`task`	查询	`string`	是	要办的事，中文或英文长度 2–500
`region`	查询	`string \| null`	否	Region 最长 120
`budget`	查询	`number \| null`	否	预算（元）最小 0
`within_days`	查询	`integer \| null`	否	希望多少天内完成范围：1 到 365

200Successful Response

422Validation Error

422 的返回字段
字段	类型	必填	说明
`detail`	`array<ValidationError>`	否	Detail
`detail[].loc`	`array<string \| integer>`	是	Location
`detail[].msg`	`string`	是	Message
`detail[].type`	`string`	是	Error Type
`detail[].input`	`any`	否	Input
`detail[].ctx`	`object`	否	Context

错误返回的格式和重试建议见错误处理。

调用示例

curl -X GET 'https://zhugejunshi.com/api/capability-web/recommend?task='

在线调试

这里会用你填的密钥向正式接口发一次真实请求。密钥只留在本页内存里，不保存、不上传到别处，刷新页面后要重新填写。

task（查询参数，必填）region（查询参数）budget（查询参数）within_days（查询参数）

POST把需求交给平台

/api/capability-web/demands

不需要密钥

没有合适的服务时使用：平台联系合适的服务商并通过留下的联系方式回复用户；不收费，不会自动下单。须先征得用户同意。

请求内容（application/json，必填）

把需求交给平台的请求字段
字段	类型	必填	说明
`need`	`string`	是	要办的事：做什么、交付什么、什么时候要长度 8–2000
`contact`	`string`	是	手机号、邮箱或微信号长度 3–80
`contact_consent`	`boolean`	是	用户已同意留下联系方式（必须为 true）
`region`	`string \| null`	否	Region 最长 60
`budget`	`string \| null`	否	Budget 最长 60
`deadline`	`string \| null`	否	Deadline 最长 60
`contact_name`	`string \| null`	否	Contact Name 最长 40

请求示例

{
  "need": "need",
  "contact": "contact",
  "contact_consent": false
}

201Successful Response

422Validation Error

422 的返回字段
字段	类型	必填	说明
`detail`	`array<ValidationError>`	否	Detail
`detail[].loc`	`array<string \| integer>`	是	Location
`detail[].msg`	`string`	是	Message
`detail[].type`	`string`	是	Error Type
`detail[].input`	`any`	否	Input
`detail[].ctx`	`object`	否	Context

错误返回的格式和重试建议见错误处理。

调用示例

curl -X POST 'https://zhugejunshi.com/api/capability-web/demands' \
  -H 'Content-Type: application/json' \
  -d '{
  "need": "need",
  "contact": "contact",
  "contact_consent": false
}'

GET搜索服务能力

/api/capability-web/capabilities

不需要密钥

按关键词、分类、地区搜索公开的服务能力，按匹配度排序；每项带价格、周期、地区和网页地址。

请求参数

搜索服务能力的请求参数
参数	位置	类型	必填	说明
`q`	查询	`string`	否	要找的服务，中文或英文，例如海报设计、logistics 最长 200
`category`	查询	`string \| null`	否	服务分类，取值见 listFacets(kind=categories) 最长 80
`region`	查询	`string \| null`	否	服务地区，例如杭州、全国最长 120
`after`	查询	`integer`	否	翻页：上一页的 next_cursor 最小 0；默认：0
`limit`	查询	`integer`	否	Limit 范围：1 到 100；默认：24

200Successful Response

422Validation Error

422 的返回字段
字段	类型	必填	说明
`detail`	`array<ValidationError>`	否	Detail
`detail[].loc`	`array<string \| integer>`	是	Location
`detail[].msg`	`string`	是	Message
`detail[].type`	`string`	是	Error Type
`detail[].input`	`any`	否	Input
`detail[].ctx`	`object`	否	Context

错误返回的格式和重试建议见错误处理。

调用示例

curl -X GET 'https://zhugejunshi.com/api/capability-web/capabilities'

在线调试

这里会用你填的密钥向正式接口发一次真实请求。密钥只留在本页内存里，不保存、不上传到别处，刷新页面后要重新填写。

q（查询参数）category（查询参数）region（查询参数）after（查询参数）limit（查询参数）

GET查看一项服务

/api/capability-web/capabilities/{public_id}

不需要密钥

一项服务的完整资料：内容、价格、周期、交付物、验收标准、服务商和下单方式。

请求参数

查看一项服务的请求参数
参数	位置	类型	必填	说明
`public_id`	路径	`string`	是	能力编号，来自 searchServices 或 recommendServices 的结果最长 80

200Successful Response

422Validation Error

422 的返回字段
字段	类型	必填	说明
`detail`	`array<ValidationError>`	否	Detail
`detail[].loc`	`array<string \| integer>`	是	Location
`detail[].msg`	`string`	是	Message
`detail[].type`	`string`	是	Error Type
`detail[].input`	`any`	否	Input
`detail[].ctx`	`object`	否	Context

错误返回的格式和重试建议见错误处理。

调用示例

curl -X GET 'https://zhugejunshi.com/api/capability-web/capabilities/{public_id}'

在线调试

这里会用你填的密钥向正式接口发一次真实请求。密钥只留在本页内存里，不保存、不上传到别处，刷新页面后要重新填写。

public_id（路径参数，必填）

GET查看服务商及其服务

/api/capability-web/providers/{provider_id}

不需要密钥

请求参数

查看服务商及其服务的请求参数
参数	位置	类型	必填	说明
`provider_id`	路径	`integer`	是	Provider Id
`after`	查询	`integer`	否	After 最小 0；默认：0
`limit`	查询	`integer`	否	Limit 范围：1 到 100；默认：24

200Successful Response

422Validation Error

422 的返回字段
字段	类型	必填	说明
`detail`	`array<ValidationError>`	否	Detail
`detail[].loc`	`array<string \| integer>`	是	Location
`detail[].msg`	`string`	是	Message
`detail[].type`	`string`	是	Error Type
`detail[].input`	`any`	否	Input
`detail[].ctx`	`object`	否	Context

错误返回的格式和重试建议见错误处理。

调用示例

curl -X GET 'https://zhugejunshi.com/api/capability-web/providers/{provider_id}'

在线调试

这里会用你填的密钥向正式接口发一次真实请求。密钥只留在本页内存里，不保存、不上传到别处，刷新页面后要重新填写。

provider_id（路径参数，必填）after（查询参数）limit（查询参数）

GET列出服务分类或地区

/api/capability-web/facets/{kind}

不需要密钥

请求参数

列出服务分类或地区的请求参数
参数	位置	类型	必填	说明
`kind`	路径	`string`	是	categories（分类）或 regions（地区）
`after`	查询	`string`	否	After 最长 120
`limit`	查询	`integer`	否	Limit 范围：1 到 1000；默认：100

200Successful Response

422Validation Error

422 的返回字段
字段	类型	必填	说明
`detail`	`array<ValidationError>`	否	Detail
`detail[].loc`	`array<string \| integer>`	是	Location
`detail[].msg`	`string`	是	Message
`detail[].type`	`string`	是	Error Type
`detail[].input`	`any`	否	Input
`detail[].ctx`	`object`	否	Context

错误返回的格式和重试建议见错误处理。

调用示例

curl -X GET 'https://zhugejunshi.com/api/capability-web/facets/{kind}'

在线调试

这里会用你填的密钥向正式接口发一次真实请求。密钥只留在本页内存里，不保存、不上传到别处，刷新页面后要重新填写。

kind（路径参数，必填）after（查询参数）limit（查询参数）

Open Capability Network

GET搜索招标采购公告（免密钥）

/api/capability-network/ai/v1/public/tenders

不需要密钥

全球公开招标公告的公开信息：每条带来源、许可、署名和网页链接；不含联系方式。每个来源地址每天有次数上限。

请求参数

搜索招标采购公告（免密钥）的请求参数
参数	位置	类型	必填	说明
`q`	查询	`string`	否	关键词，中文或外文；空格表示"并且"，逗号表示"或" 最长 120
`country`	查询	`string`	否	Country 最长 80
`category`	查询	`string`	否	goods 货物、works 工程、services 服务、consulting 咨询、other 其他格式：^(goods\|works\|services\|consulting\|other)?$
`sector`	查询	`string`	否	Sector 最长 60
`source`	查询	`string`	否	Source 最长 30
`route`	查询	`string`	否	承接路径，多个用逗号：A 直接投、B 中国货物、C 联合体或分包、D 转介、E 观察最长 20；格式：^[ABCDEXabcdex, ]*$
`amount_min_usd`	查询	`number \| null`	否	Amount Min Usd 最小 0
`amount_max_usd`	查询	`number \| null`	否	Amount Max Usd 最小 0
`deadline_from`	查询	`string`	否	日期 YYYY-MM-DD 格式：^(\d{4}-\d{2}-\d{2})?$
`deadline_to`	查询	`string`	否	日期 YYYY-MM-DD 格式：^(\d{4}-\d{2}-\d{2})?$
`published_from`	查询	`string`	否	日期 YYYY-MM-DD 格式：^(\d{4}-\d{2}-\d{2})?$
`published_to`	查询	`string`	否	日期 YYYY-MM-DD 格式：^(\d{4}-\d{2}-\d{2})?$
`flags`	查询	`string`	否	要点，逗号分开：lots 标段、consortium 联合投标、subcontracting 分包、framework 框架协议、siteVisit 现场踏勘、guarantee 保证金最长 120；格式：^((lots\|consortium\|subcontracting\|framework\|s…
`documents`	查询	`string`	否	Documents 格式：^(free\|restricted\|purchase\|request\|platform)?$
`sort`	查询	`string`	否	Sort 可选值： / relevance / deadline / published / amount
`direction`	查询	`string`	否	Direction 可选值：asc / desc；默认：asc
`limit`	查询	`integer`	否	Limit 范围：1 到 20；默认：10
`offset`	查询	`integer`	否	Offset 范围：0 到 1000；默认：0

200Successful Response

400请求未能完成或参数不符合要求，message 说明原因

没有返回内容。

401缺少或无效的接入密钥

没有返回内容。

403密钥没有这项权限，或需要账号本人在网站上操作

没有返回内容。

404没有找到，或不属于密钥所属账号

没有返回内容。

409与当前状态冲突

没有返回内容。

422Validation Error

422 的返回字段
字段	类型	必填	说明
`detail`	`array<ValidationError>`	否	Detail
`detail[].loc`	`array<string \| integer>`	是	Location
`detail[].msg`	`string`	是	Message
`detail[].type`	`string`	是	Error Type
`detail[].input`	`any`	否	Input
`detail[].ctx`	`object`	否	Context

429今天这项操作已达上限

没有返回内容。

503服务繁忙，请稍后重试

没有返回内容。

错误返回的格式和重试建议见错误处理。

调用示例

curl -X GET 'https://zhugejunshi.com/api/capability-network/ai/v1/public/tenders'

在线调试

这里会用你填的密钥向正式接口发一次真实请求。密钥只留在本页内存里，不保存、不上传到别处，刷新页面后要重新填写。

q（查询参数）country（查询参数）category（查询参数）sector（查询参数）source（查询参数）route（查询参数）amount_min_usd（查询参数）amount_max_usd（查询参数）deadline_from（查询参数）deadline_to（查询参数）published_from（查询参数）published_to（查询参数）flags（查询参数）documents（查询参数）sort（查询参数）direction（查询参数）limit（查询参数）offset（查询参数）

GET招标搜索的筛选项（免密钥）

/api/capability-network/ai/v1/public/tenders/filters

不需要密钥

200Successful Response

400请求未能完成或参数不符合要求，message 说明原因

没有返回内容。

401缺少或无效的接入密钥

没有返回内容。

403密钥没有这项权限，或需要账号本人在网站上操作

没有返回内容。

404没有找到，或不属于密钥所属账号

没有返回内容。

409与当前状态冲突

没有返回内容。

429今天这项操作已达上限

没有返回内容。

503服务繁忙，请稍后重试

没有返回内容。

错误返回的格式和重试建议见错误处理。

调用示例

curl -X GET 'https://zhugejunshi.com/api/capability-network/ai/v1/public/tenders/filters'

在线调试

这里会用你填的密钥向正式接口发一次真实请求。密钥只留在本页内存里，不保存、不上传到别处，刷新页面后要重新填写。

GET查看招标公告详情（免密钥）

/api/capability-network/ai/v1/public/tenders/{tender_id}

不需要密钥

请求参数

查看招标公告详情（免密钥）的请求参数
参数	位置	类型	必填	说明
`tender_id`	路径	`integer`	是	Tender Id
`include_original`	查询	`boolean`	否	附上许可允许的原文（最多 8000 字）默认：false

200Successful Response

400请求未能完成或参数不符合要求，message 说明原因

没有返回内容。

401缺少或无效的接入密钥

没有返回内容。

403密钥没有这项权限，或需要账号本人在网站上操作

没有返回内容。

404没有找到，或不属于密钥所属账号

没有返回内容。

409与当前状态冲突

没有返回内容。

422Validation Error

422 的返回字段
字段	类型	必填	说明
`detail`	`array<ValidationError>`	否	Detail
`detail[].loc`	`array<string \| integer>`	是	Location
`detail[].msg`	`string`	是	Message
`detail[].type`	`string`	是	Error Type
`detail[].input`	`any`	否	Input
`detail[].ctx`	`object`	否	Context

429今天这项操作已达上限

没有返回内容。

503服务繁忙，请稍后重试

没有返回内容。

错误返回的格式和重试建议见错误处理。

调用示例

curl -X GET 'https://zhugejunshi.com/api/capability-network/ai/v1/public/tenders/{tender_id}'

在线调试

这里会用你填的密钥向正式接口发一次真实请求。密钥只留在本页内存里，不保存、不上传到别处，刷新页面后要重新填写。

tender_id（路径参数，必填）include_original（查询参数）

GET搜索海外合作商（免密钥）

/api/capability-network/ai/v1/public/partners

不需要密钥

请求参数

搜索海外合作商（免密钥）的请求参数
参数	位置	类型	必填	说明
`q`	查询	`string`	否	Q 最长 80
`country`	查询	`string`	否	Country 格式：^([A-Za-z]{2})?$
`industry`	查询	`string`	否	带前缀的行业编码，如 NACE:46、HS:8516、zhuge:food 最长 60
`role`	查询	`string`	否	Role 可选值： / agent / manufacturer_rep / distributor / wholesaler / importer / reseller / franchisee / franchisor / service_provider / logistics / installer …
`language`	查询	`string`	否	Language 最长 20
`tier_at_least`	查询	`string`	否	Tier At Least 可选值：A / B / C；默认：C
`limit`	查询	`integer`	否	Limit 范围：1 到 20；默认：10
`offset`	查询	`integer`	否	Offset 范围：0 到 1000；默认：0

200Successful Response

400请求未能完成或参数不符合要求，message 说明原因

没有返回内容。

401缺少或无效的接入密钥

没有返回内容。

403密钥没有这项权限，或需要账号本人在网站上操作

没有返回内容。

404没有找到，或不属于密钥所属账号

没有返回内容。

409与当前状态冲突

没有返回内容。

422Validation Error

422 的返回字段
字段	类型	必填	说明
`detail`	`array<ValidationError>`	否	Detail
`detail[].loc`	`array<string \| integer>`	是	Location
`detail[].msg`	`string`	是	Message
`detail[].type`	`string`	是	Error Type
`detail[].input`	`any`	否	Input
`detail[].ctx`	`object`	否	Context

429今天这项操作已达上限

没有返回内容。

503服务繁忙，请稍后重试

没有返回内容。

错误返回的格式和重试建议见错误处理。

调用示例

curl -X GET 'https://zhugejunshi.com/api/capability-network/ai/v1/public/partners'

在线调试

这里会用你填的密钥向正式接口发一次真实请求。密钥只留在本页内存里，不保存、不上传到别处，刷新页面后要重新填写。

q（查询参数）country（查询参数）industry（查询参数）role（查询参数）language（查询参数）tier_at_least（查询参数）limit（查询参数）offset（查询参数）

GET查看合作商资料（免密钥）

/api/capability-network/ai/v1/public/partners/{partner_id}

不需要密钥

请求参数

查看合作商资料（免密钥）的请求参数
参数	位置	类型	必填	说明
`partner_id`	路径	`string`	是	Partner Id

200Successful Response

400请求未能完成或参数不符合要求，message 说明原因

没有返回内容。

401缺少或无效的接入密钥

没有返回内容。

403密钥没有这项权限，或需要账号本人在网站上操作

没有返回内容。

404没有找到，或不属于密钥所属账号

没有返回内容。

409与当前状态冲突

没有返回内容。

422Validation Error

422 的返回字段
字段	类型	必填	说明
`detail`	`array<ValidationError>`	否	Detail
`detail[].loc`	`array<string \| integer>`	是	Location
`detail[].msg`	`string`	是	Message
`detail[].type`	`string`	是	Error Type
`detail[].input`	`any`	否	Input
`detail[].ctx`	`object`	否	Context

429今天这项操作已达上限

没有返回内容。

503服务繁忙，请稍后重试

没有返回内容。

错误返回的格式和重试建议见错误处理。

调用示例

curl -X GET 'https://zhugejunshi.com/api/capability-network/ai/v1/public/partners/{partner_id}'

在线调试

这里会用你填的密钥向正式接口发一次真实请求。密钥只留在本页内存里，不保存、不上传到别处，刷新页面后要重新填写。

partner_id（路径参数，必填）

GET搜索民间商机（免密钥）

/api/capability-network/ai/v1/public/leads

不需要密钥

请求参数

搜索民间商机（免密钥）的请求参数
参数	位置	类型	必填	说明
`q`	查询	`string`	否	关键词，中文或外文；空格表示"并且"，逗号表示"或" 最长 120
`audience`	查询	`string`	否	Audience 可选值：buyers / partners；默认：buyers
`kind`	查询	`string`	否	Kind 可选值： / purchase / cooperation / sales_agent / skill_learner / franchise_seeker
`region`	查询	`string`	否	Region 最长 80
`limit`	查询	`integer`	否	Limit 范围：1 到 20；默认：10
`offset`	查询	`integer`	否	Offset 范围：0 到 1000；默认：0

200Successful Response

400请求未能完成或参数不符合要求，message 说明原因

没有返回内容。

401缺少或无效的接入密钥

没有返回内容。

403密钥没有这项权限，或需要账号本人在网站上操作

没有返回内容。

404没有找到，或不属于密钥所属账号

没有返回内容。

409与当前状态冲突

没有返回内容。

422Validation Error

422 的返回字段
字段	类型	必填	说明
`detail`	`array<ValidationError>`	否	Detail
`detail[].loc`	`array<string \| integer>`	是	Location
`detail[].msg`	`string`	是	Message
`detail[].type`	`string`	是	Error Type
`detail[].input`	`any`	否	Input
`detail[].ctx`	`object`	否	Context

429今天这项操作已达上限

没有返回内容。

503服务繁忙，请稍后重试

没有返回内容。

错误返回的格式和重试建议见错误处理。

调用示例

curl -X GET 'https://zhugejunshi.com/api/capability-network/ai/v1/public/leads'

在线调试

这里会用你填的密钥向正式接口发一次真实请求。密钥只留在本页内存里，不保存、不上传到别处，刷新页面后要重新填写。

q（查询参数）audience（查询参数）kind（查询参数）region（查询参数）limit（查询参数）offset（查询参数）

GET查看民间商机（免密钥）

/api/capability-network/ai/v1/public/leads/{lead_id}

不需要密钥

请求参数

查看民间商机（免密钥）的请求参数
参数	位置	类型	必填	说明
`lead_id`	路径	`string`	是	Lead Id

200Successful Response

400请求未能完成或参数不符合要求，message 说明原因

没有返回内容。

401缺少或无效的接入密钥

没有返回内容。

403密钥没有这项权限，或需要账号本人在网站上操作

没有返回内容。

404没有找到，或不属于密钥所属账号

没有返回内容。

409与当前状态冲突

没有返回内容。

422Validation Error

422 的返回字段
字段	类型	必填	说明
`detail`	`array<ValidationError>`	否	Detail
`detail[].loc`	`array<string \| integer>`	是	Location
`detail[].msg`	`string`	是	Message
`detail[].type`	`string`	是	Error Type
`detail[].input`	`any`	否	Input
`detail[].ctx`	`object`	否	Context

429今天这项操作已达上限

没有返回内容。

503服务繁忙，请稍后重试

没有返回内容。

错误返回的格式和重试建议见错误处理。

调用示例

curl -X GET 'https://zhugejunshi.com/api/capability-network/ai/v1/public/leads/{lead_id}'

在线调试

这里会用你填的密钥向正式接口发一次真实请求。密钥只留在本页内存里，不保存、不上传到别处，刷新页面后要重新填写。

lead_id（路径参数，必填）

使用须知

Public Capability Web

请求参数

返回

调用示例

请求内容 （application/json，必填）

返回

调用示例

请求参数

返回

调用示例

请求参数

返回

调用示例

请求参数

返回

调用示例

请求参数

返回

调用示例

Open Capability Network

请求参数

返回

调用示例

返回

调用示例

请求参数

返回

调用示例

请求参数

返回

调用示例

请求参数

返回

调用示例

请求参数

返回

调用示例

请求参数

返回

调用示例

请求内容（application/json，必填）