API 接入文档

Radix药引开放API,支持政策搜索、详情查询和AI智能问答。 所有接口使用 Bearer Token 认证。

认证方式

Authorization: Bearer rdix_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx

API Key 格式为 rdix_ 前缀 + 32位十六进制字符。 请登录后在个人中心获取和管理您的 API Key。

调用频率限制

  • 搜索/详情接口:30 次/分钟/Key(Nginx 50r/m 全局兜底)
  • AI 问答接口:10 次/分钟/Key(Nginx 10r/m 全局兜底)
  • • AI 问答单次回答不超过 1000 字
  • • 超出配额返回 HTTP 429,响应头含 Retry-After

响应头说明:X-RateLimit-Limit 限额 / X-RateLimit-Remaining 剩余 / X-RateLimit-Reset 重置秒数

点位消耗说明

API 调用按点位计费,点数按月度配额计算。配额与账户会员等级绑定:

会员等级每月点位
免费用户100 点
基础会员300 点
专业会员1,000 点
旗舰会员5,000 点

各接口单次调用消耗:

  • AI 智能问答(/api/v1/ask):1 点/次
  • 政策详情(/api/v1/policy/:id):1 点/次
  • 政策搜索(/api/v1/search):免费
  • MCP 工具调用(8个工具):1 点/次(管理员豁免)
  • 批量导出(/api/v1/export):免费

点数不足时返回 HTTP 403 + { error: "点数不足", code: "INSUFFICIENT_POINTS" },每月1号自动重置。

错误码说明

HTTP 状态码错误标识说明
401UNAUTHORIZEDAPI Key 缺失、无效或已撤销
400BAD_REQUEST缺少必填参数或参数格式错误
404NOT_FOUND请求的政策ID不存在
429RATE_LIMITED超出频率限制,请等待后重试
403INSUFFICIENT_POINTS点数不足,请升级会员或等待下月重置
500INTERNAL_ERROR服务端错误,请稍后重试
{"error": "无效的API Key", "code": "UNAUTHORIZED"}

接口列表

GEThttps://www.radixin.cn/api/v1/search

按关键词搜索政策库,支持分类过滤和分页

请求参数

参数类型必填说明
qstring搜索关键词,如「冠脉支架」「集采」
categorystring分类过滤:集中采购/药品批准/医疗器械/医保政策/法律法规/通知通告
pagenumber页码,默认1
limitnumber每页条数,默认10,最大50

响应示例

{
  "data": [
    {
      "id": 105,
      "title": "关于召开冠脉支架医用耗材第二轮接续带量采购...",
      "summary": "国家组织高值医用耗材联合采购办公室定于...",
      "category": "集中采购",
      "source": "国家组织高值医用耗材联合采购办公室",
      "publishDate": "2026-04-23T00:00:00.000Z",
      "tags": "冠脉支架,医用耗材,带量采购",
      "sourceUrl": "https://...",
      "structuredData": {
        "key_points": ["要点1", "要点2"],
        "policy_type": "通知",
        "region": ["全国"]
      }
    }
  ],
  "total": 12,
  "page": 1,
  "limit": 10
}
GEThttps://www.radixin.cn/api/v1/policy/:id

获取指定政策的完整内容,包括AI分析和结构化数据

请求参数

参数类型必填说明
idnumber政策ID,从搜索结果获取

响应示例

{
  "data": {
    "id": 105,
    "title": "...",
    "summary": "...",
    "content": "完整政策正文...",
    "category": "集中采购",
    "source": "国家组织高值医用耗材联合采购办公室",
    "sourceUrl": "https://...",
    "publishDate": "2026-04-23T00:00:00.000Z",
    "tags": "冠脉支架,医用耗材",
    "structuredData": {
      "key_points": [
        "发布第九批智能监管两库规则和知识点,共601条",
        "规则类型为药品限二线使用,面向社会公开",
        "省级医保部门需动态更新智能监管子系统两库"
      ],
      "policy_type": "公告",
      "region": ["全国"],
      "effective_date": null,
      "target_entities": ["定点医药机构", "省级医保部门"],
      "related_policies": [],
      "key_dates": [
        { "date": "2026-04-21", "event": "公告发布日期" }
      ]
    },
    "aiAnalysis": null
  }
}
POSThttps://www.radixin.cn/api/v1/ask

基于政策知识库的AI问答,支持流式和非流式两种模式

请求参数

参数类型必填说明
questionstring问题内容,如「冠脉支架集采降价了多少」
streamboolean是否使用SSE流式输出,默认false

响应示例

{
  "answer": "根据相关政策,冠脉支架第二轮接续带量采购...",
  "sources": [
    { "id": 105, "title": "关于召开冠脉支架...", "source": "国家联采办" },
    { "id": 90, "title": "海南省医疗保障局...", "source": "海南省医保局" }
  ],
  "model": "deepseek-chat"
}
GEThttps://www.radixin.cn/api/v1/export

批量导出政策数据,支持CSV和JSON格式,需要Bearer Token认证。

请求参数

参数类型必填说明
qstring搜索关键词过滤
categorystring分类过滤
formatstring导出格式:csv(默认)或json
limitnumber最大导出条数,默认100,最大500

cURL 示例

curl -H "Authorization: Bearer rdix_xxx"   "https://www.radixin.cn/api/v1/export?category=集中采购&limit=50"   -o policies.csv

第三方平台集成

Dify

在 Dify 工作流中添加 MCP Tool 节点,配置以下信息即可调用 Radix药引 的政策数据:

  • MCP Server URL: https://www.radixin.cn/mcp/sse
  • 传输方式: SSE(Server-Sent Events)
  • 认证方式: Bearer Token(需在 Headers 中填入 API Key)
  • 可用工具: search_policy / get_policy / list_categories / list_latest_policies / search_drug / search_enterprise / find_drug_policies / ai_analyze_policy

Coze(扣子)

在 Coze 中添加 MCP 插件,填入 Server URL 和 Authorization Header 即可。支持搜索政策、查询品种和 AI 解读。

MCP Server(AI 原生调用)

Radix药引提供标准 MCP (Model Context Protocol) Server。 配好后,AI 自动发现工具、自动判断调用哪个——你只需要用自然语言提问。

🔑

需要 API Key

请先在 账户中心 → API Keys 生成 Key。 Key 格式:rdix_ + 32位字符

💡

点位消耗:每次工具调用扣 1 点

MCP 每次调用任意工具(search_policy / search_drug / ai_analyze_policy 等)消耗 1 点位,管理员不扣点。 点位不足时返回 HTTP 403 INSUFFICIENT_POINTS,每月 1 号自动重置。

可用工具(8个)

工具名功能关键参数
search_policy全文搜索医药政策keyword, category, limit
get_policy获取政策完整详情policy_id
list_categories列出所有政策分类及数量
list_latest_policies获取最近N天最新政策days(默认7), limit(默认10)
search_drug搜药品品种(挂网价/医保/过评)drug_name, limit
search_enterprise查企业品种列表+统计maker, limit
find_drug_policies查找品种关联的政策drug_name, limit
ai_analyze_policyAI 解读指定政策policy_id

通用配置(适用所有 MCP 客户端)

rdix_xxxx 替换为你的真实 API Key:

{
  "mcpServers": {
    "radix-pharmakb": {
      "url": "https://www.radixin.cn/mcp/sse",
      "headers": {
        "Authorization": "Bearer rdix_xxxx你的key"
      }
    }
  }
}

各客户端配置方式

Claude Desktop

编辑 ~/Library/Application Support/Claude/claude_desktop_config.json(macOS),粘贴上方通用配置,重启即可。

Cursor / Windsurf

设置 → MCP → Add new MCP Server,类型选 SSE,填入 URL 和 Header。

VS Code(GitHub Copilot)

项目根目录新建 .vscode/mcp.json,粘贴上方通用配置。

Cline(VS Code 插件)

Cline 设置 → MCP Servers → Configure → 粘贴通用配置,保存后点刷新。

Reasonix Code

设置 → MCP 服务器 → 添加,粘贴通用配置。重启后生效。

使用方式

配置完成后,直接在 AI 对话框用自然语言提问,Agent 自动选择工具。例如:

  • • 「查一下阿莫西林的挂网价格」
  • • 「最近一周有什么集采政策」
  • • 「帮我搜辉瑞在江苏医保目录里的品种」
  • • 「解读一下政策 ID 42」
🐍 Python
import requests

API_KEY = "rdix_your_api_key_here"
BASE = "https://www.radixin.cn"
headers = {"Authorization": f"Bearer {API_KEY}"}

# 1. 搜索政策
resp = requests.get(f"{BASE}/api/v1/search",
    params={"q": "冠脉支架", "limit": 5},
    headers=headers)
policies = resp.json()["data"]
print(f"找到 {resp.json()['total']} 条政策")

# 2. AI问答
resp = requests.post(f"{BASE}/api/v1/ask",
    json={"question": "冠脉支架集采最新进展"},
    headers=headers)
answer = resp.json()["answer"]
sources = resp.json()["sources"]
print(answer)
for s in sources:
    print(f"  来源: {s['title']}")
cURL
# 搜索政策
curl -H "Authorization: Bearer rdix_your_key" \
  "https://www.radixin.cn/api/v1/search?q=冠脉支架&limit=5"

# 获取政策详情
curl -H "Authorization: Bearer rdix_your_key" \
  "https://www.radixin.cn/api/v1/policy/105"

# AI问答
curl -X POST \
  -H "Authorization: Bearer rdix_your_key" \
  -H "Content-Type: application/json" \
  -d '{"question":"冠脉支架集采降价了多少"}' \
  "https://www.radixin.cn/api/v1/ask"
🟨 JavaScript
const API_KEY = "rdix_your_api_key_here";
const BASE = "https://www.radixin.cn";

// 搜索政策
const search = await fetch(
  `${BASE}/api/v1/search?q=冠脉支架&limit=5`,
  { headers: { Authorization: `Bearer ${API_KEY}` } }
).then(r => r.json());

// AI问答(流式)
const resp = await fetch(`${BASE}/api/v1/ask`, {
  method: "POST",
  headers: {
    Authorization: `Bearer ${API_KEY}`,
    "Content-Type": "application/json"
  },
  body: JSON.stringify({
    question: "冠脉支架集采最新进展",
    stream: true
  })
});
const reader = resp.body.getReader();
// 解析SSE数据流...

🔔 Webhook 事件订阅

订阅政策变更事件,当新政策发布或政策更新时,系统将自动向您的URL推送通知。

注册 Webhook

POST https://www.radixin.cn/api/v1/webhooks
参数类型必填说明
urlstring回调URL(仅支持HTTPS)
eventsstring[]订阅事件:policy.created / policy.updated / policy.deleted(默认created)
secretstringHMAC-SHA256签名密钥,用于验证推送来源

管理 Webhook

GET /api/v1/webhooks — 查看我的Webhook列表

DELETE /api/v1/webhooks/:id — 删除指定Webhook

推送 Payload 示例

{
  "event": "policy.created",
  "timestamp": "2026-04-24T12:00:00.000Z",
  "data": {
    "id": 119,
    "title": "关于xxx的通知",
    "category": "通知通告",
    "publishDate": "2026-04-24",
    "source": "国家医保局"
  }
}

Headers: X-Webhook-Event + X-Webhook-Delivery + X-Webhook-Signature(如设置了secret)

注意:每个用户最多5个Webhook。推送超时10秒,失败后自动重试不做保证。响应状态码需返回2xx视为成功。

Radix药引 API · 如有问题请在公众号留言或联系客服

接口如有变更,将提前通知 · 当前版本 v1.0