docs: 重查供应商来源并记录逐字段复核候选 (#118)

2026-10-21 05:44:26 +08:00 · 2026-10-03 20:26:42 -07:00
parent 987f286c86
commit a94a751078
78 changed files with 206073 additions and 1 deletions
--- a/docs/source-rechecks/2026-10-04/api-contracts/brave.md
+++ b/docs/source-rechecks/2026-10-04/api-contracts/brave.md
@@ -0,0 +1,32 @@
+# brave：API合同重新检索
+
+检索日期：2026-10-04。原记录：[brave](../../../data-sources/api-providers/brave.md)。原状态 pending 保留；本页为待复核候选。
+
+## 来源
+
+- [brave-reference](https://api-dashboard.search.brave.com/api-reference/web/search/get)：official-docs，readable。GET与鉴权、查询参数和web.results结构已读取。 Brave Web Search GET；不证明账号额度、套餐或本仓变量插值。
+- [brave-main](https://brave.com/search/api/)：official-docs，readable。官网GET示例含Accept和gzip请求头。 官方请求示例。
+
+## 字段对照
+
+| 字段 | 当前值 | 来源支持值 | 对照 | 来源ID |
+| --- | --- | --- | --- | --- |
+| `endpoint` | `"https://api.search.brave.com/res/v1/web/search"` | `"https://api.search.brave.com/res/v1/web/search"` | matches | brave-reference |
+| `method` | `"GET"` | `"GET"` | matches | brave-reference |
+| `auth.type` | `"header"` | `"header"` | matches | brave-reference |
+| `auth.headerName` | `"X-Subscription-Token"` | `"X-Subscription-Token"` | matches | brave-reference |
+| `request.headers.Accept` | `"application/json"` | `"application/json"` | matches | brave-main |
+| `request.headers.Accept-Encoding` | `"gzip"` | `"gzip"` | matches | brave-main |
+| `response.resultsPath` | `"web.results"` | `"web.results"` | matches | brave-reference |
+| `response.item.titlePath` | `"title"` | `"title"` | matches | brave-reference |
+| `response.item.urlPath` | `"url"` | `"url"` | matches | brave-reference |
+| `response.item.snippetPath` | `"description"` | `"description"` | matches | brave-reference |
+| `response.item.pageAgePath` | `"page_age"` | `"page_age"` | matches | brave-reference |
+
+## 仍待证明
+
+- request.queryParams.q:客户端变量插值
+- request.queryParams.count:整数转换和最大20
+- 账号资格及配额
+
+原生官方合同、可信SDK旁证、模板插值与账号验收分别处理。未执行收费调用，未修改API配置或原来源状态。
--- a/docs/source-rechecks/2026-10-04/api-contracts/configured-vision-anthropic.md
+++ b/docs/source-rechecks/2026-10-04/api-contracts/configured-vision-anthropic.md
@@ -0,0 +1,24 @@
+# configured-vision-anthropic：API合同重新检索
+
+检索日期：2026-10-04。原记录：[configured-vision-anthropic](../../../data-sources/api-providers/configured-vision-anthropic.md)。原状态 partial 保留；本页为待复核候选。
+
+## 来源
+
+- [anthropic-vision](https://platform.claude.com/docs/en/build-with-claude/vision)：official-docs，readable。旧docs域名跳转官方platform域名；实际读取image/source/base64/media_type/data示例。 仅原生视觉请求形状；1024不是厂商最大或默认输出限制。
+
+## 字段对照
+
+| 字段 | 当前值 | 来源支持值 | 对照 | 来源ID |
+| --- | --- | --- | --- | --- |
+| `request.bodyTemplate.messages.0.content.0.type` | `"image"` | `"image"` | matches | anthropic-vision |
+| `request.bodyTemplate.messages.0.content.0.source.type` | `"base64"` | `"base64"` | matches | anthropic-vision |
+
+## 仍待证明
+
+- 动态baseUrl和实际型号
+- auth/anthropic-version
+- response.textPath
+- 客户端变量插值
+- max_tokens=1024为产品预算非厂商上限
+
+原生官方合同、可信SDK旁证、模板插值与账号验收分别处理。未执行收费调用，未修改API配置或原来源状态。
--- a/docs/source-rechecks/2026-10-04/api-contracts/configured-vision-openai.md
+++ b/docs/source-rechecks/2026-10-04/api-contracts/configured-vision-openai.md
@@ -0,0 +1,23 @@
+# configured-vision-openai：API合同重新检索
+
+检索日期：2026-10-04。原记录：[configured-vision-openai](../../../data-sources/api-providers/configured-vision-openai.md)。原状态 partial 保留；本页为待复核候选。
+
+## 来源
+
+- [openai-vision](https://developers.openai.com/api/docs/guides/images-vision)：official-docs，readable。原platform域名跳转官方developers域名；Chat Completions示例含image_url和choices[0].message.content。 原生Chat Completions视觉合同，不能覆盖Responses-only型号和任意兼容网关。
+
+## 字段对照
+
+| 字段 | 当前值 | 来源支持值 | 对照 | 来源ID |
+| --- | --- | --- | --- | --- |
+| `request.bodyTemplate.messages.0.content.1.type` | `"image_url"` | `"image_url"` | matches | openai-vision |
+| `response.textPath` | `"choices.0.message.content"` | `"choices.0.message.content"` | matches | openai-vision |
+
+## 仍待证明
+
+- 动态baseUrl和实际型号
+- Responses-only适配
+- Bearer/网关认证
+- 客户端变量插值及输入输出预算
+
+原生官方合同、可信SDK旁证、模板插值与账号验收分别处理。未执行收费调用，未修改API配置或原来源状态。
--- a/docs/source-rechecks/2026-10-04/api-contracts/doubao-search-global.md
+++ b/docs/source-rechecks/2026-10-04/api-contracts/doubao-search-global.md
@@ -0,0 +1,36 @@
+# doubao-search-global：API合同重新检索
+
+检索日期：2026-10-04。原记录：[doubao-search-global](../../../data-sources/api-providers/doubao-search-global.md)。原状态 pending 保留；本页为待复核候选。
+
+## 来源
+
+- [doubao-original](https://www.volcengine.com/docs/85508/1650263)：official-docs，blocked。原入口重定向后工具无法读取正文。 不能拿另一签名或地域的Fusion API替代feedcoopapi合同。
+- [doubao-current](https://docs.volcengine.com/docs/NetworkedQAAgent/FusionInformationSearchAPI?lang=zh)：official-docs，blocked。本轮正文读取Internal Error；也试过.md入口，未取得可读正文。 endpoint/Bearer/Result映射仍待证明。
+- [doubao-global-rendered](https://docs.volcengine.com/docs/Networkedsearch/doubao-search-global-edition?lang=zh)：official-docs，readable。SubAgent实际浏览器渲染读取Global独立页：POST/global_search、Bearer、Query/SearchType/DocCount/MaxSnippetLength及Result.Documents。 仅Global按量后付费；不证明Custom、订阅或TOP网关。
+
+## 字段对照
+
+| 字段 | 当前值 | 来源支持值 | 对照 | 来源ID |
+| --- | --- | --- | --- | --- |
+| `endpoint` | `"https://open.feedcoopapi.com/search_api/global_search"` | `"https://open.feedcoopapi.com/search_api/global_search"` | matches | doubao-global-rendered |
+| `method` | `"POST"` | `"POST"` | matches | doubao-global-rendered |
+| `auth.type` | `"bearer"` | `"bearer"` | matches | doubao-global-rendered |
+| `request.bodyTemplate.SearchType` | `"web"` | `"web"` | matches | doubao-global-rendered |
+| `request.bodyTemplate.MaxSnippetLength` | `500` | `500` | matches | doubao-global-rendered |
+| `response.resultsPath` | `"Result.Documents"` | `"Result.Documents"` | matches | doubao-global-rendered |
+| `response.item.titlePath` | `"Title"` | `"Title"` | matches | doubao-global-rendered |
+| `response.item.urlPath` | `"Url"` | `"Url"` | matches | doubao-global-rendered |
+| `response.item.pageAgePath` | `"DocumentInfo.PublishTime"` | `"DocumentInfo.PublishTime"` | matches | doubao-global-rendered |
+| `response.item.snippetPath` | `"Snippet.0.Text"` | `{"array":"Snippet","discriminator":"Type","textField":"Text"}` | not-comparable | doubao-global-rendered |
+| `response.successCondition.equals` | `0` | `0` | not-comparable | doubao-global-rendered |
+
+## 仍待证明
+
+- Query必填1~100字符与客户端插值
+- DocCount web默认10最多20及整数转换
+- Snippet.0.Text不保证首项为text，需按Type选择
+- ErrorCode=0仅官方成功示例，完整错误规则待核
+- DocumentInfo.PublishTime非必填且样例空值
+- MaxSnippetLength单位tokens默认500/最大3000
+
+原生官方合同、可信SDK旁证、模板插值与账号验收分别处理。未执行收费调用，未修改API配置或原来源状态。
--- a/docs/source-rechecks/2026-10-04/api-contracts/serper.md
+++ b/docs/source-rechecks/2026-10-04/api-contracts/serper.md
@@ -0,0 +1,29 @@
+# serper：API合同重新检索
+
+检索日期：2026-10-04。原记录：[serper](../../../data-sources/api-providers/serper.md)。原状态 pending 保留；本页为待复核候选。
+
+## 来源
+
+- [serper-main](https://serper.dev/)：official-docs，readable。官网Search示例明确organic及title/link/snippet。页面没有证明请求endpoint/header。 公开搜索响应示例，不能证明所有选项或收费调用。
+- [serper-sdk](https://github.com/langchain-ai/langchain-community/blob/main/libs/community/langchain_community/utilities/google_serper.py)：trusted-secondary，readable。维护者SDK以POST调用google.serper.dev，使用X-API-KEY，并用query params发送q/num。 可信实现旁证；非Serper发布者合同；不证明JSON bodyTemplate或当前账号可用性。
+- [serper-reference](https://reference.langchain.com/python/langchain-community/utilities/google_serper/GoogleSerperAPIWrapper)：trusted-secondary，blocked。搜索发现入口，但本轮正文读取Internal Error。 不作为字段证明。
+
+## 字段对照
+
+| 字段 | 当前值 | 来源支持值 | 对照 | 来源ID |
+| --- | --- | --- | --- | --- |
+| `response.resultsPath` | `"organic"` | `"organic"` | matches | serper-main |
+| `response.item.titlePath` | `"title"` | `"title"` | matches | serper-main |
+| `response.item.urlPath` | `"link"` | `"link"` | matches | serper-main |
+| `response.item.snippetPath` | `"snippet"` | `"snippet"` | matches | serper-main |
+| `endpoint` | `"https://google.serper.dev/search"` | `"https://google.serper.dev/search"` | matches | serper-sdk |
+| `method` | `"POST"` | `"POST"` | matches | serper-sdk |
+| `auth.headerName` | `"X-API-KEY"` | `"X-API-KEY"` | matches | serper-sdk |
+
+## 仍待证明
+
+- request.bodyTemplate:官方JSON正文合同未取得，SDK示例使用params
+- request.bodyTemplate.num:类型/上限
+- 账号及额度
+
+原生官方合同、可信SDK旁证、模板插值与账号验收分别处理。未执行收费调用，未修改API配置或原来源状态。
--- a/docs/source-rechecks/2026-10-04/api-contracts/tavily.md
+++ b/docs/source-rechecks/2026-10-04/api-contracts/tavily.md
@@ -0,0 +1,28 @@
+# tavily：API合同重新检索
+
+检索日期：2026-10-04。原记录：[tavily](../../../data-sources/api-providers/tavily.md)。原状态 partial 保留；本页为待复核候选。
+
+## 来源
+
+- [tavily-reference](https://docs.tavily.com/documentation/api-reference/endpoint/search)：official-docs，readable。官方cURL与响应示例已读取，POST/Bearer/query/max_results/basic/results明确。 原生Tavily API，不证明客户端变量转换或账号资格。
+
+## 字段对照
+
+| 字段 | 当前值 | 来源支持值 | 对照 | 来源ID |
+| --- | --- | --- | --- | --- |
+| `endpoint` | `"https://api.tavily.com/search"` | `"https://api.tavily.com/search"` | matches | tavily-reference |
+| `method` | `"POST"` | `"POST"` | matches | tavily-reference |
+| `auth.type` | `"bearer"` | `"bearer"` | matches | tavily-reference |
+| `request.bodyTemplate.search_depth` | `"basic"` | `"basic"` | matches | tavily-reference |
+| `response.resultsPath` | `"results"` | `"results"` | matches | tavily-reference |
+| `response.item.titlePath` | `"title"` | `"title"` | matches | tavily-reference |
+| `response.item.urlPath` | `"url"` | `"url"` | matches | tavily-reference |
+| `response.item.snippetPath` | `"content"` | `"content"` | matches | tavily-reference |
+
+## 仍待证明
+
+- request.bodyTemplate.query:变量插值
+- request.bodyTemplate.max_results:整数转换
+- 账号及额度
+
+原生官方合同、可信SDK旁证、模板插值与账号验收分别处理。未执行收费调用，未修改API配置或原来源状态。