健康图谱,支持属性查询或者聚类类查询-阿里云帮助中心

本文介绍 MedicalKnow 接口，基于权威的医疗数据，支持医疗类属性查询或者聚类类查询（比如杭州口腔医院哪家好,苹果热量，阿斯匹林），相对其他搜索API而言可以获取更多，更全面的医疗信息

接口定义

请求参数

参数

类型

必填

默认值

描述

示例值

query

string

是

搜索问题。取值范围：1~200个字符。

重要

基于效果考虑，尽可能将query限制在30个字符以内，可以在调用接口前客户侧通过模型做Query改写；

阿莫⻄林胶囊

type

string

是

finding：病症

food：⻝品

medicine：药品

medicine

返回参数

字段			类型	是否可空	字段说明	样例（Query: 上海车展最火爆的是哪个品牌）
requestId			string	不可空	请求RequestId, 排查问题时可以提供此信息	35E5608A-A737-2038-****-D9D34C6BFD9E
messages[]	content		string	不可空	内容	实体：阿莫西林胶囊\n- 属性[精确活性成分]：阿莫西林\n- 属性[生产剂型]：口服用胶囊\n- 属性[适应症]：# 阿莫西林胶囊可以治疗哪些疾病\n阿莫西林属于青霉素类抗生素，有较强的杀菌作用。除了普通青霉素能对抗的革兰阳性菌外，它还对抗大肠埃希菌、流感嗜血杆菌等革兰阴性菌，但对病毒引起的感染性疾病（如病毒性流感）不起作用。阿莫西林的适应证较多，常用来治疗敏感菌（不产β内酰胺酶菌株）所致的感染性疾病：
messages[]	url		string	不可空	url	https://p.quark.cn/0387f345/index?uc_biz_str=OPT%3ABACK_BTN_STYLE%400%7COPT%3AIMMERSIVE%401&uc_param_str=dnntnwvepffrbijbprsvchgputdemennosstodcaaapcgidsdieinipixsnxkp&struct_id=VdB%2BLV7w7lHHEp%2Fo7ZfF0JJSD5VX%2Fhou2cPHhOUO%2Bm6cU%2FnGHYBudAnri5Dw6HhY&struct_type=VdB%2BLV7w7lHHEp%2Fo7ZfF0GaP%2FJb5sTdrBuS6EwD3gWU%3D&token=917796353976&version=v1&skip_cache=0&chid=0uhUNr1UmD
searchInformation	searchTime		int64	不可空	搜索耗时	500
queryContext	originalQuery	query	string	不可空	原始请求：query	阿莫⻄林胶囊

说明

服务端的超时时间为5秒

示例

请求参数(RequestBody)

{
  "query": "阿莫⻄林胶囊",
  "type": "medicine",
}

返回参数

{
    "requestId": "d3c1b3*********cdebe",
    "messages": [
        {
            "url": "https://p.quark.cn/0387f345/index?uc_biz_str=OPT%3ABACK_BTN_STYLE%400%7COPT%3AIMMERSIVE%401&uc_param_str=dnntnwvepffrbijbprsvchgputdemennosstodcaaapcgidsdieinipixsnxkp&struct_id=VdB%2BLV7w7lHHEp%2Fo7ZfF0JJSD5VX%2Fhou2cPHhOUO%2Bm6cU%2FnGHYBudAnri5Dw6HhY&struct_type=VdB%2BLV7w7lHHEp%2Fo7ZfF0GaP%2FJb5sTdrBuS6EwD3gWU%3D&token=917796353976&version=v1&skip_cache=0&chid=0uhUNr1UmD",
            "content": "实体：阿莫西林胶囊\n- 属性[精确活性成分]：阿莫西林\n- 属性[生产剂型]：口服用胶囊\n- 属性[适应症]：# 阿莫西林胶囊可以治疗哪些疾病\n阿莫西林属于青霉素类抗生素，有较强的杀菌作用。除了普通青霉素能对抗的革兰阳性菌外，它还对抗大肠埃希菌、流感嗜血杆菌等革兰阴性菌，但对病毒引起的感染性疾病（如病毒性流感）不起作用。阿莫西林的适应证较多，常用来治疗敏感菌（不产β内酰胺酶菌株）所致的感染性疾病：\n- 属性[药理作用]：阿莫西林为青霉素类抗生素，对肺炎链球菌、溶血性链球菌等链球菌属、不产青霉素酶葡萄球菌、粪肠球菌等需氧革兰阳性球菌，大肠埃希菌、沙门菌属、流感嗜血杆菌、淋病奈瑟菌等需氧革兰阴性菌的不产β内酰胺酶菌株及幽门螺杆菌具有良好的抗菌活性。\n阿莫西林可通过抑制细菌细胞壁合成而发挥杀菌作用，进而使细菌迅速成为球状体而溶解、破裂。"
        }
    ],
    "searchInformation": {
        "searchTime": 308
    },
    "queryContext": {
        "originalQuery": {
            "query": "阿莫⻄林胶囊"
        }
    }
}

错误码

Status	错误码	错误信息	处理方案
404	InvalidAccessKeyId.NotFound	Specified access key is not found.	检查并确保AccessKey/Secret正确。
403	Retrieval.NotActivate	Please activate AI search service	请下单或联系您的客户经理进行开通。
403	Retrieval.Arrears	Please recharge first.	账户金额不足，请充值
403	Retrieval.NotAuthorised	Please authorize the AliyunIQSFullAccess privilege to the sub-account.	子账号没有进行授权，参考创建RAM用户并授权
403	Retrieval.TestUserPeriodExpired	The test period has expired.	测试已到期（自下单后15天有效），可以联系阿里云客户经理转正式
429	Retrieval.Throttling.User	Request was denied due to user flow control.	超出限流规格，可联系阿里云客户经理进行升配
429	Retrieval.TestUserQueryExceeded	The query exceed the limit	测试超出日限额（1000次/天），可以联系阿里云客户经理转正式

接口调用

HTTP调用

使用信息查询服务（IQS）产品的凭证（API-KEY）进行认证，并使用HTTP发起接口调用。创建并查看凭证，获取API-KEY。

curl  -X POST https://cloud-iqs.aliyuncs.com/medical/know \
--header "Authorization: Bearer $API_KEY" \
--header "Content-Type: application/json" \
--data '{
  "query": "阿莫⻄林胶囊",
  "type": "medicine"
}'

重要

$API_KEY 替换为信息查询服务控制台中创建的API-KEY（创建并查看凭证），创建API-KEY需要等待5min生效。

MCP调用

MCP接入请参考：接入IQS MCP Server