阿里大于 -

请求地址：

环境	HTTP请求地址	HTTPS请求地址
正式环境	http://gw.api.taobao.com/router/rest	https://eco.taobao.com/router/rest

公共请求参数：

名称	类型	是否必须	描述
method	String	是	API接口名称。
app_key	String	是	TOP分配给应用的AppKey。
target_app_key	String	否	被调用的目标AppKey，仅当被调用的API为第三方ISV提供时有效。
sign_method	String	是	签名的摘要算法，可选值为：hmac，md5。
sign	String	是	API输入参数签名结果，签名算法介绍请点击这里。
session	String	否	用户登录授权成功后，TOP颁发给应用的授权信息，详细介绍请点击这里。当此API的标签上注明：“需要授权”，则此参数必传；“不需要授权”，则此参数不需要传；“可选授权”，则此参数为可选。
timestamp	String	是	时间戳，格式为yyyy-MM-dd HH:mm:ss，时区为GMT+8，例如：2015-01-01 12:00:00。淘宝API服务端允许客户端请求最大时间误差为10分钟。
format	String	否	响应格式。默认为xml格式，可选值：xml，json。
v	String	是	API协议版本，可选值：2.0。
partner_id	String	否	合作伙伴身份标识。
simplify	Boolean	否	是否采用精简JSON返回格式，仅当format=json时有效，默认值为：false。

名称	类型	是否必须	示例值	更多限制	描述
command	SafeMedicationReqCommand	可选			入参
└ order_id String 可选 1838983105989823315 关联订单 patient Patient 可选患者，启用特殊人群规则情况下必传 └ gender Number 可选 1 用药人性别（0未知1男2女） └ weight Number 可选 70 用药人体重-单位kg └ user_id String 可选 22287869 淘系用户id └ age Number 可选 55 用药人年龄-单位：天 └ height Number 可选 175 用药人身高-单位cm └ labels String [] 可选 ["PREGNANCY","LACTATION","HYPOHEPATIA","SEVERE_HYPOHEPATIA","SEVERE_RENALINADEQUACY","RENALINADEQUACY"] 人群标签 └ scene_name String 必须 prescription 场景名 prescription_items PrescriptionItem [] 必须处方项，包括药品、用法用量以及购买量 dosage Dosage 可选用法用量，启用用法用量规则的条件下必传 items DosageItem [] 可选用法用量 └ unit String 可选 mg 使用量单位 └ type String 可选 SINGLEDAILYDOSE 用量类型（SINGLEDAILYDOSE("单日剂量"), SINGLEDOSE("单次剂量"), DRUGCOURSE("药品疗程"), FREQUENCYADMINISTRATION("给药频次")） └ value BigDecimal 可选 10.0 使用量 └ way String 可选口服用法 buy_amount BuyAmount 可选购买数量，启用限购的规则条件下必传 └ buy_amount Number 可选 5 本次购买量 └ history_days Number 可选 10 统计周期，不传的话则不做周期限购 └ history_total_amount Number 可选 20 历史购买量。历史购买量需要包含本次购买量，不传的话则不做周期限购 drug Drug 必须购买的药品 └ common_name String 必须茶碱缓释片通用名 └ quantity_per_pack Number 可选 24 装量值(例：24粒) └ tenant_spu_id String 可选 22244 租户的药品唯一标识别 └ producer String 可选锦州本天药业有限公司生产厂家 ingredients Ingredients [] 可选成分 └ unit String 可选 mg 成分单位 └ quantity Number 可选 10 成分数值 └ name String 可选青霉素类广谱β-内酰胺类抗生素成分名 └ spu_id String 可选 511281473 健康标品库的SpuId └ unit_of_per_unit String 可选 mg 最小使用单位数值剂量单位（mg） └ quantity_per_unit Number 可选 10 最小使用单位数值（例：10） └ approval_number String 可选国药准字H21020004 国药准字号 └ type String 可选 WESTERN_PRESCRIPTION_MEDICINE 药品类型（WESTERN_PRESCRIPTION_MEDICINE(1,"处方药-西药"), CHINESE_PRESCRIPTION_MEDICINE(2, "处方药-中成药"), WESTERN_OTC(3, "OTC-西药"), CHINESE_OTC(4, "OTC-中成药"), PIECES(5, "饮片")） └ norm String 可选 0.1g*24片/盒规格详情 diags Diag [] 可选诊断信息，启用适应症和禁忌症规则下必传 └ code String 可选 F42.900 诊断码 └ name String 可选强迫性障碍诊断名 └ tenant_code String 必须 ele 租户名

名称	类型	示例值	描述
result	ServiceResult	result	alinkappserver系统返回的通用结果类
datas BaseRule [] data 结果集 └ level Number 1 级别规则 └ detail String 详细数据规则的详细数据 └ desc String 2岁以下谨慎使用他克莫司软膏提示文案 └ type String CycleLimitRule 周期限购：CycleLimitRule，单次限购规则：SingleLimitRule，频次规则：FreqDosageRule，每日剂量规则：DailyDosageRule，单次剂量规则：SingleDosageRule ，用法规则：WayDosageRule ，重复用药规则：RepetitionRule ，特殊年龄规则：AgeSpecialCrowdRule ，人群标签规则：UserLabelSpecialCrowdRule ，性别诊断冲突规则则：GenderSpecialCrowdRule ，适应症规则：IndicationRule ，相互作用规则：InteractionRule ，禁忌症规则：ContraIndicationRule └ spu_id String 511281473 spuid └ threshold String 50.0mg(0.0片) 每次剂量上线（命中每日剂量规则+单次剂量规则） └ suggested_freq String 3 建议的每日使用频次，如2-3（命中频次规则） └ suggested_way String 口服建议的用法，如：口服（命中用法规则） └ common_name String 茶碱缓释片药品通用名 └ other_common_name String 阿莫西林药品通用名（重复用药+相互作用规则） └ forbidden_age String 1000 禁用的年龄区间，单位是天，比如0-1000（命中特殊年龄规则） └ forbidden_user String 妊娠禁用的人群（命中特殊人群规则） └ gender String 男性别（命中性别诊断冲突规则） └ diag_code String F42.900 诊断码（命中性别诊断冲突规则） └ diags String A46.x00:1:丹毒;R12:1:胃灼热诊断（命中适应症规则） └ forbidden_diags String N19.x00 跟该药冲突的诊断码，如N19.x00（（命中禁忌症规则）） └ limit_threshold Number 10 限购上限制（命中周期限购+单次限购规则） └ success Boolean true 成功与否 └ error_code String SYSTEM_ERROR 错误码 └ error_msg String 系统错误错误信息

JAVA
.NET
PHP
CURL
Python
C/C++
NodeJS

TaobaoClient client = new DefaultTaobaoClient(url, appkey, secret);
AlibabaAlihealthDruguseQueryRequest req = new AlibabaAlihealthDruguseQueryRequest();
AlibabaAlihealthDruguseQueryRequest.SafeMedicationReqCommand obj1 = new AlibabaAlihealthDruguseQueryRequest.SafeMedicationReqCommand();
obj1.setOrderId("1838983105989823315");
AlibabaAlihealthDruguseQueryRequest.Patient obj2 = new AlibabaAlihealthDruguseQueryRequest.Patient();
obj2.setGender(1L);
obj2.setWeight(70L);
obj2.setUserId("22287869");
obj2.setAge(55L);
obj2.setHeight(175L);
obj2.setLabels(""PREGNANCY","LACTATION","HYPOHEPATIA","SEVERE_HYPOHEPATIA","SEVERE_RENALINADEQUACY","RENALINADEQUACY"");
obj1.setPatient(obj2);
obj1.setSceneName("prescription");
List<AlibabaAlihealthDruguseQueryRequest.PrescriptionItem> list4 = new ArrayList<AlibabaAlihealthDruguseQueryRequest.PrescriptionItem>();
AlibabaAlihealthDruguseQueryRequest.PrescriptionItem obj5 = new AlibabaAlihealthDruguseQueryRequest.PrescriptionItem();
list4.add(obj5);
AlibabaAlihealthDruguseQueryRequest.Dosage obj7 = new AlibabaAlihealthDruguseQueryRequest.Dosage();
List<AlibabaAlihealthDruguseQueryRequest.DosageItem> list9 = new ArrayList<AlibabaAlihealthDruguseQueryRequest.DosageItem>();
AlibabaAlihealthDruguseQueryRequest.DosageItem obj10 = new AlibabaAlihealthDruguseQueryRequest.DosageItem();
list9.add(obj10);
obj10.setUnit("mg");
obj10.setType("SINGLEDAILYDOSE");
obj10.setValue("10.0");
obj7.setItems(list9);
obj7.setWay("口服");
list6.setDosage(obj7);
AlibabaAlihealthDruguseQueryRequest.BuyAmount obj12 = new AlibabaAlihealthDruguseQueryRequest.BuyAmount();
obj12.setBuyAmount(5L);
obj12.setHistoryDays(10L);
obj12.setHistoryTotalAmount(20L);
list11.setBuyAmount(obj12);
AlibabaAlihealthDruguseQueryRequest.Drug obj14 = new AlibabaAlihealthDruguseQueryRequest.Drug();
obj14.setCommonName("茶碱缓释片");
obj14.setQuantityPerPack(24L);
obj14.setTenantSpuId("22244");
obj14.setProducer("锦州本天药业有限公司");
List<AlibabaAlihealthDruguseQueryRequest.Ingredients> list16 = new ArrayList<AlibabaAlihealthDruguseQueryRequest.Ingredients>();
AlibabaAlihealthDruguseQueryRequest.Ingredients obj17 = new AlibabaAlihealthDruguseQueryRequest.Ingredients();
list16.add(obj17);
obj17.setUnit("mg");
obj17.setQuantity(10L);
obj17.setName("青霉素类广谱β-内酰胺类抗生素");
obj14.setIngredients(list16);
obj14.setSpuId("511281473");
obj14.setUnitOfPerUnit("mg");
obj14.setQuantityPerUnit(10L);
obj14.setApprovalNumber("国药准字H21020004");
obj14.setType("WESTERN_PRESCRIPTION_MEDICINE");
obj14.setNorm("0.1g*24片/盒");
list13.setDrug(obj14);
obj1.setPrescriptionItems(list4);
List<AlibabaAlihealthDruguseQueryRequest.Diag> list19 = new ArrayList<AlibabaAlihealthDruguseQueryRequest.Diag>();
AlibabaAlihealthDruguseQueryRequest.Diag obj20 = new AlibabaAlihealthDruguseQueryRequest.Diag();
list19.add(obj20);
obj20.setCode("F42.900");
obj20.setName("强迫性障碍");
obj1.setDiags(list19);
obj1.setTenantCode("ele");
req.setCommand(obj1);
AlibabaAlihealthDruguseQueryResponse rsp = client.execute(req);
System.out.println(rsp.getBody());

ITopClient client = new DefaultTopClient(url, appkey, secret);
AlibabaAlihealthDruguseQueryRequest req = new AlibabaAlihealthDruguseQueryRequest();
AlibabaAlihealthDruguseQueryRequest.SafeMedicationReqCommandDomain obj1 = new AlibabaAlihealthDruguseQueryRequest.SafeMedicationReqCommandDomain();
obj1.OrderId = "1838983105989823315";
AlibabaAlihealthDruguseQueryRequest.PatientDomain obj2 = new AlibabaAlihealthDruguseQueryRequest.PatientDomain();
obj2.Gender = 1L;
obj2.Weight = 70L;
obj2.UserId = "22287869";
obj2.Age = 55L;
obj2.Height = 175L;
obj2.Labels = ""PREGNANCY","LACTATION","HYPOHEPATIA","SEVERE_HYPOHEPATIA","SEVERE_RENALINADEQUACY","RENALINADEQUACY"";
obj1.Patient= obj2;
obj1.SceneName = "prescription";
List<AlibabaAlihealthDruguseQueryRequest.PrescriptionItemDomain> list4 = new List<AlibabaAlihealthDruguseQueryRequest.PrescriptionItemDomain>();
AlibabaAlihealthDruguseQueryRequest.PrescriptionItemDomain obj5 = new AlibabaAlihealthDruguseQueryRequest.PrescriptionItemDomain();
list4.Add(obj5);
AlibabaAlihealthDruguseQueryRequest.DosageDomain obj6 = new AlibabaAlihealthDruguseQueryRequest.DosageDomain();
List<AlibabaAlihealthDruguseQueryRequest.DosageItemDomain> list8 = new List<AlibabaAlihealthDruguseQueryRequest.DosageItemDomain>();
AlibabaAlihealthDruguseQueryRequest.DosageItemDomain obj9 = new AlibabaAlihealthDruguseQueryRequest.DosageItemDomain();
list8.Add(obj9);
obj9.Unit = "mg";
obj9.Type = "SINGLEDAILYDOSE";
obj9.Value = "10.0";
obj6.Items= list8;
obj6.Way = "口服";
obj5.Dosage= obj6;
AlibabaAlihealthDruguseQueryRequest.BuyAmountDomain obj10 = new AlibabaAlihealthDruguseQueryRequest.BuyAmountDomain();
obj10.BuyAmount = 5L;
obj10.HistoryDays = 10L;
obj10.HistoryTotalAmount = 20L;
obj5.BuyAmount= obj10;
AlibabaAlihealthDruguseQueryRequest.DrugDomain obj11 = new AlibabaAlihealthDruguseQueryRequest.DrugDomain();
obj11.CommonName = "茶碱缓释片";
obj11.QuantityPerPack = 24L;
obj11.TenantSpuId = "22244";
obj11.Producer = "锦州本天药业有限公司";
List<AlibabaAlihealthDruguseQueryRequest.IngredientsDomain> list13 = new List<AlibabaAlihealthDruguseQueryRequest.IngredientsDomain>();
AlibabaAlihealthDruguseQueryRequest.IngredientsDomain obj14 = new AlibabaAlihealthDruguseQueryRequest.IngredientsDomain();
list13.Add(obj14);
obj14.Unit = "mg";
obj14.Quantity = 10L;
obj14.Name = "青霉素类广谱β-内酰胺类抗生素";
obj11.Ingredients= list13;
obj11.SpuId = "511281473";
obj11.UnitOfPerUnit = "mg";
obj11.QuantityPerUnit = 10L;
obj11.ApprovalNumber = "国药准字H21020004";
obj11.Type = "WESTERN_PRESCRIPTION_MEDICINE";
obj11.Norm = "0.1g*24片/盒";
obj5.Drug= obj11;
obj1.PrescriptionItems= list4;
List<AlibabaAlihealthDruguseQueryRequest.DiagDomain> list16 = new List<AlibabaAlihealthDruguseQueryRequest.DiagDomain>();
AlibabaAlihealthDruguseQueryRequest.DiagDomain obj17 = new AlibabaAlihealthDruguseQueryRequest.DiagDomain();
list16.Add(obj17);
obj17.Code = "F42.900";
obj17.Name = "强迫性障碍";
obj1.Diags= list16;
obj1.TenantCode = "ele";
req.Command_ = obj1;
AlibabaAlihealthDruguseQueryResponse rsp = client.Execute(req);
Console.WriteLine(rsp.Body);

$c = new TopClient;
$c->appkey = $appkey;
$c->secretKey = $secret;
$req = new AlibabaAlihealthDruguseQueryRequest;
$command = new SafeMedicationReqCommand;
$command->order_id="1838983105989823315";
$patient = new Patient;
$patient->gender="1";
$patient->weight="70";
$patient->user_id="22287869";
$patient->age="55";
$patient->height="175";
$patient->labels="[\"PREGNANCY\",\"LACTATION\",\"HYPOHEPATIA\",\"SEVERE_HYPOHEPATIA\",\"SEVERE_RENALINADEQUACY\",\"RENALINADEQUACY\"]";
$command->patient = $patient;
$command->scene_name="prescription";
$prescription_items = new PrescriptionItem;
$dosage = new Dosage;
$items = new DosageItem;
$items->unit="mg";
$items->type="SINGLEDAILYDOSE";
$items->value="10.0";
$dosage->items = $items;
$dosage->way="口服";
$prescription_items->dosage = $dosage;
$buy_amount = new BuyAmount;
$buy_amount->buy_amount="5";
$buy_amount->history_days="10";
$buy_amount->history_total_amount="20";
$prescription_items->buy_amount = $buy_amount;
$drug = new Drug;
$drug->common_name="茶碱缓释片";
$drug->quantity_per_pack="24";
$drug->tenant_spu_id="22244";
$drug->producer="锦州本天药业有限公司";
$ingredients = new Ingredients;
$ingredients->unit="mg";
$ingredients->quantity="10";
$ingredients->name="青霉素类广谱β-内酰胺类抗生素";
$drug->ingredients = $ingredients;
$drug->spu_id="511281473";
$drug->unit_of_per_unit="mg";
$drug->quantity_per_unit="10";
$drug->approval_number="国药准字H21020004";
$drug->type="WESTERN_PRESCRIPTION_MEDICINE";
$drug->norm="0.1g*24片/盒";
$prescription_items->drug = $drug;
$command->prescription_items = $prescription_items;
$diags = new Diag;
$diags->code="F42.900";
$diags->name="强迫性障碍";
$command->diags = $diags;
$command->tenant_code="ele";
$req->setCommand(json_encode($command));
$resp = $c->execute($req);

curl -X POST 'http://gw.api.taobao.com/router/rest' \
-H 'Content-Type:application/x-www-form-urlencoded;charset=utf-8' \
-d 'app_key=12129701' \
-d 'format=json' \
-d 'method=alibaba.alihealth.druguse.query' \
-d 'partner_id=apidoc' \
-d 'sign=A088633DFC15A9340EF8A4304FF93C3E' \
-d 'sign_method=hmac' \
-d 'timestamp=2025-04-29+16%3A10%3A54' \
-d 'v=2.0' \
-d 'command=null'

# -*- coding: utf-8 -*-
import top.api

req=top.api.AlibabaAlihealthDruguseQueryRequest(url,port)
req.set_app_info(top.appinfo(appkey,secret))

req.command=""
try:
	resp= req.getResponse()
	print(resp)
except Exception,e:
	print(e)

pTopRequest pRequest = alloc_top_request();
pTopResponse pResponse = NULL;
pTaobaoClient pClient = alloc_taobao_client(url, appkey, appsecret);
set_api_name(pRequest,"alibaba.alihealth.druguse.query");
add_param(pRequest,"command","数据结构JSON示例");
pResponse = top_execute(pClient,pRequest,NULL);
printf("ret code:%d\n",pResponse->code);
if(pResponse->code == 0){
	pTopResponseIterator ite = init_response_iterator(pResponse);
	pResultItem pResultItem = alloc_result_item();
	while(parseNext(ite, pResultItem) == 0){
		printf("%s:%s\n",pResultItem->key,pResultItem->value);
	}
	destroy_response_iterator(ite);
	destroy_result_item(pResultItem);
}
destroy_top_request(pRequest);
destroy_top_response(pResponse);
destroy_taobao_client(pClient);

TopClient = require('./topClient').TopClient;
var client = new TopClient({
	'appkey': 'appkey',
	'appsecret': 'secret',
	'REST_URL': 'http://gw.api.taobao.com/router/rest'
});

client.execute('alibaba.alihealth.druguse.query', {
	'command':'数据结构JSON示例'
}, function(error, response) {
	if (!error) console.log(response);
	else console.log(error);
})

XML示例
JSON示例

<alibaba_alihealth_druguse_query_response>
    <result>
        <datas>
            <base_rule>
                <level>1</level>
                <detail>详细数据</detail>
                <desc>2岁以下谨慎使用他克莫司软膏</desc>
                <type>CycleLimitRule</type>
                <spu_id>511281473</spu_id>
                <threshold>50.0mg(0.0片)</threshold>
                <suggested_freq>3</suggested_freq>
                <suggested_way>口服</suggested_way>
                <common_name>茶碱缓释片</common_name>
                <other_common_name>阿莫西林</other_common_name>
                <forbidden_age>1000</forbidden_age>
                <forbidden_user>妊娠</forbidden_user>
                <gender>男</gender>
                <diag_code>F42.900</diag_code>
                <diags>A46.x00:1:丹毒;R12:1:胃灼热</diags>
                <forbidden_diags>N19.x00</forbidden_diags>
                <limit_threshold>10</limit_threshold>
            </base_rule>
        </datas>
        <success>true</success>
        <error_code>SYSTEM_ERROR</error_code>
        <error_msg>系统错误</error_msg>
    </result>
</alibaba_alihealth_druguse_query_response>

{
    "alibaba_alihealth_druguse_query_response":{
        "result":{
            "datas":{
                "base_rule":[
                    {
                        "level":1,
                        "detail":"详细数据",
                        "desc":"2岁以下谨慎使用他克莫司软膏",
                        "type":"CycleLimitRule",
                        "spu_id":"511281473",
                        "threshold":"50.0mg(0.0片)",
                        "suggested_freq":"3",
                        "suggested_way":"口服",
                        "common_name":"茶碱缓释片",
                        "other_common_name":"阿莫西林",
                        "forbidden_age":"1000",
                        "forbidden_user":"妊娠",
                        "gender":"男",
                        "diag_code":"F42.900",
                        "diags":"A46.x00:1:丹毒;R12:1:胃灼热",
                        "forbidden_diags":"N19.x00",
                        "limit_threshold":10
                    }
                ]
            },
            "success":true,
            "error_code":"SYSTEM_ERROR",
            "error_msg":"系统错误"
        }
    }
}

XML示例
JSON示例

<error_response>
    <code>50</code>
    <msg>Remote service error</msg>
    <sub_code>isv.invalid-parameter</sub_code>
    <sub_msg>非法参数</sub_msg>
</error_response>

{
	"error_response":{
		"msg":"Remote service error",
		"code":50,
		"sub_msg":"非法参数",
		"sub_code":"isv.invalid-parameter"
	}
}

错误码	错误描述	解决方案

API测试工具错误码查询工具 SDK下载

阿里健康API

alibaba.alihealth.druguse.query (合理用药规则查询)

公共参数

请求参数

响应参数

请求示例

响应示例

异常示例

错误码解释

API工具

如何获得此API

FAQ