# ONE SEARCH API（万搜）文档

    # 1. 接口说明

    注意：该接口可以正式使用。如您需要申请使用，请前往产品页面 (opens new window)领取免费额度。

    Tips：

    1. 支持全文检索、结果重排、时效性识别、内容安全分类等高级能力；
    2. 后续将支持对接自建知识库、定制化检索链路等功能；
    3. 当前仅对已授权用户开放，需在控制台开通权限。

    # 2. 请求地址

    # 2.1 搜索 API 地址

    https://search-api-open.cn-huabei-1.xf-yun.com/v2/search

    # 3. 请求说明

    # 3.1 调用示例（cURL）

    curl --request POST \
  --url https://search-api-open.cn-huabei-1.xf-yun.com/v2/search \
  --header 'Authorization: Bearer 123456' \
  --header 'Content-Type: application/json' \
  --data '{
  "search_params": {
    "query": "中日索赔案例谈判的谈判法则有哪些？",
    "limit": 10,
    "enhance":{
      "open_full_text": false,
      "open_rerank":true
    }
  }
}
'

    说明：请将 123456 替换为您在控制台 (opens new window)获取的 APIPassword。

    # 3.2 请求头（Headers）

    Header 名称 必填 说明
    Authorization 是 格式为 Bearer <APIPassword>，其中 <APIPassword> 从控制台获取
    Content-Type 是 固定为 application/json

    # 3.3 请求参数

    # 请求体结构示例

    {
  "search_params": {
    "query": "美国现任总统是谁？",
    "limit": 10
  }
}

    # 参数说明

    参数名称 类型 是否必传 取值范围 描述
    search_params object 是 — 搜索请求的参数对象
    search_params.query string 是 非空字符串，建议 ≤512 字符 用户输入的搜索关键词或问题
    search_params.limit int 否 1 ~ 20，默认为 10 返回结果的最大条数
    search_params.enhance object 否 - 功能开关项
    search_params.enhance.open_rerank bool 否 重排开关项 默认为true
    search_params.enhance.open_full_text bool 否 全文开关项 默认为true

    # 4. 响应参数

    # 4.1 成功响应示例

    {
  "data": {
    "meta": {
      "query": "美国现任总统是谁"
    },
    "search_results": {
      "documents": [
         {
          "summary": " 1. **原则分析**:  - 合法合规是基础,确保索赔依据符合合同及法律; - 实事求是强调以事实为依据,避免夸大或虚构; - 平等协商避免单方面施压,维系合作关系; - 注重证据通过文件资料支撑主张; - 及时性防止时效性问题导致权利丧失。2. **策略推导**:  - 目标明确保证谈判方向不偏离; - 让步需设定底线,换取对方妥协; - 利益交换通过筹码平衡诉求; - 多方案增强灵活性; - 压力策略如停工威胁需谨慎使用。3. **技巧归纳**:  - 沟通节奏掌控主动权; - 倾听提问挖掘对方真实需求; - 情绪稳定避免冲突升级; - 聚焦核心条款提高效率; - 设定期限促使对方决策。",
          "content": "",
          "url": "https://easylearn.baidu.com/edu-page/tiangong/questiondetail?id=1828512528438428075&fr=search",
          "name": "简述索赔谈判的原则、策略与技巧",
          "published_date": "2025年04月05日"
        }
        // ……其他结果
      ]
    }
  },
  "err_code": "0",
  "sid": "ocp5e0146fa@dx19a519b8ef8b8985e0",
  "success": true
}

    # 4.2 响应字段说明

    # 顶层字段

    字段名 类型 描述
    err_code string 错误码，"0" 表示成功
    success boolean 是否成功
    sid string 本次请求的唯一会话 ID
    data object 成功时返回的搜索结果数据

    # data.meta 字段

    字段名 类型 描述
    query string 实际用于搜索的查询语句（可能经过标准化）

    # data.search_results.documents[] 字段（每条结果）

    字段名 类型 描述
    name string 页面标题
    summary string 摘要内容
    url string 原文链接
    content string 完整正文

    # 5. 错误响应

    # 5.1 错误响应格式

    {
  "err_code": "11200",
  "success": false,
  "sid": "ocp5e0146fa@dx19a519b8ef8b8985e0",
  "message": "授权错误：该appId没有相关功能的授权 或者 业务量超过限制"
}

    # 5.2 错误码说明

    错误码 错误信息
    0 成功
    11200 授权错误：该 appId 没有相关功能的授权，或者业务量超过限制
    11201 授权错误：日流控超限。超过当日最大访问量的限制
    11202 授权错误：秒级流控超限。秒级并发超过授权路数限制
    11203 授权错误：并发流控超限。并发路数超过授权路数限制
    21001 缺少参数
    21009 未授权：该 appId 没有相关功能的授权

    # 6. 使用建议

    • 查询优化：建议使用完整问句（如“美国现任总统是谁？”）而非关键词（如“美国总统”），以获得更精准的时效性结果。
    在这篇文章中：
    在线咨询
    体验中心