API 接入文档
Radix药引开放API,支持政策搜索、详情查询和AI智能问答。 所有接口使用 Bearer Token 认证。
认证方式
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 状态码 | 错误标识 | 说明 |
|---|---|---|
| 401 | UNAUTHORIZED | API Key 缺失、无效或已撤销 |
| 400 | BAD_REQUEST | 缺少必填参数或参数格式错误 |
| 404 | NOT_FOUND | 请求的政策ID不存在 |
| 429 | RATE_LIMITED | 超出频率限制,请等待后重试 |
| 403 | INSUFFICIENT_POINTS | 点数不足,请升级会员或等待下月重置 |
| 500 | INTERNAL_ERROR | 服务端错误,请稍后重试 |
接口列表
https://www.radixin.cn/api/v1/search按关键词搜索政策库,支持分类过滤和分页
请求参数
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
| q | string | 是 | 搜索关键词,如「冠脉支架」「集采」 |
| category | string | 否 | 分类过滤:集中采购/药品批准/医疗器械/医保政策/法律法规/通知通告 |
| page | number | 否 | 页码,默认1 |
| limit | number | 否 | 每页条数,默认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
}https://www.radixin.cn/api/v1/policy/:id获取指定政策的完整内容,包括AI分析和结构化数据
请求参数
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
| id | number | 是 | 政策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
}
}https://www.radixin.cn/api/v1/ask基于政策知识库的AI问答,支持流式和非流式两种模式
请求参数
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
| question | string | 是 | 问题内容,如「冠脉支架集采降价了多少」 |
| stream | boolean | 否 | 是否使用SSE流式输出,默认false |
响应示例
{
"answer": "根据相关政策,冠脉支架第二轮接续带量采购...",
"sources": [
{ "id": 105, "title": "关于召开冠脉支架...", "source": "国家联采办" },
{ "id": 90, "title": "海南省医疗保障局...", "source": "海南省医保局" }
],
"model": "deepseek-chat"
}https://www.radixin.cn/api/v1/export批量导出政策数据,支持CSV和JSON格式,需要Bearer Token认证。
请求参数
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
| q | string | 否 | 搜索关键词过滤 |
| category | string | 否 | 分类过滤 |
| format | string | 否 | 导出格式:csv(默认)或json |
| limit | number | 否 | 最大导出条数,默认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_policy | AI 解读指定政策 | 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」
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 -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"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| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
| url | string | 是 | 回调URL(仅支持HTTPS) |
| events | string[] | 否 | 订阅事件:policy.created / policy.updated / policy.deleted(默认created) |
| secret | string | 否 | HMAC-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)
Radix药引 API · 如有问题请在公众号留言或联系客服
接口如有变更,将提前通知 · 当前版本 v1.0
