阿里安全开放平台-阿里聚安全

请求地址：

环境	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。

名称	类型	是否必须	示例值	描述
ref_ent_id	String	必须	cf846d0b3e6445d6b6538c7637c4ebf6	添加企业唯一标识
license_token	String	必须	服务时间	服务时间
add_ent_req	AddEntReqDTO	必须		新增企业信息
└ dict_region_detail String 必须 xx镇xx乡xx门牌号企业详细注册地址 └ ent_org_type Number 必须 311 用类型code值，并且需要与userRoleType值相映射：比如userRoleType传的3，只能取枚举值中第三个参数是3的类型；如果没有映射的细分类型，则填0.企业/机构细分类型枚举结构：(类型code，类型名称，对应企业/机构类型code)；枚举值：PRODUCE_CHINA(13, "境内生产企业", 1), PRODUCE_FOREIGN(14, "境外生产企业", 1), DISEASE_CENTER(31, "疾控中心", 3), INOCULATION_ENT(32, "接种单位", 3), OTHER_MEDICAL_ENT(33, "其他", 3), MEDICAL_34(34, "综合医院", 3), MEDICAL_35(35, "中医医院", 3), MEDICAL_36(36, "中西医结合医院", 3), MEDICAL_37(37, "民族医院", 3), MEDICAL_38(38, "专科医院，不含中医专科医院", 3), MEDICAL_39(39, "疗养院", 3), MEDICAL_310(310, "护理院(站)", 3), MEDICAL_311(311, "社区卫生服务中心", 3), MEDICAL_312(312, "社区卫生服务站", 3), MEDICAL_313(313, "街道卫生院", 3), MEDICAL_314(314, "乡镇卫生院", 3), MEDICAL_315(315, "门诊部", 3), MEDICAL_316(316, "诊所", 3), MEDICAL_317(317, "卫生所(室)", 3), MEDICAL_318(318, "医务室", 3), MEDICAL_319(319, "中小学卫生保健所", 3), MEDICAL_320(320, "村卫生室", 3), MEDICAL_321(321, "急救中心", 3), MEDICAL_322(322, "急救中心站", 3), MEDICAL_323(323, "急救站", 3), MEDICAL_324(324, "血站", 3), MEDICAL_325(325, "单采血浆站", 3), MEDICAL_326(326, "妇幼保健院", 3), MEDICAL_327(327, "妇幼保健所包括妇女、儿童保健所", 3), MEDICAL_328(328, "妇幼保健站包括妇幼保健中心", 3), MEDICAL_329(329, "生殖保健中心", 3), MEDICAL_330(330, "专科疾病防治院", 3), MEDICAL_331(331, "专科疾病防治所(站、中心)", 3), MEDICAL_333(333, "卫生防疫站", 3), MEDICAL_334(334, "卫生防病中心", 3), MEDICAL_335(335, "预防保健中心", 3), MEDICAL_336(336, "卫生监督所(局)", 3), MEDICAL_337(337, "卫生(综合)监督检验(监测、检测)所(站)", 3), MEDICAL_338(338, "环境卫生监督检验(监测、检测)所(站)", 3), MEDICAL_339(339, "放射卫生监督检验(监测、检测)所(站)", 3), MEDICAL_340(340, "劳动(职业、工业)卫生监督检验(监测、检测)所(站)", 3), MEDICAL_341(341, "食品卫生监督检验(监测、检测)所(站)", 3), MEDICAL_342(342, "学校卫生监督检验(监测、检测)所(站)", 3), MEDICAL_343(343, "其他卫生监督检验(监测、检测)所(站)", 3), MEDICAL_344(344, "医学科学(研究)院（所）", 3), MEDICAL_345(345, "预防医学研究院（所）", 3), MEDICAL_346(346, "中医(药)研究院(所)", 3), MEDICAL_347(347, "中西医结合研究所", 3), MEDICAL_348(348, "民族医(药)学研究所", 3), MEDICAL_349(349, "医学专科研究所", 3), MEDICAL_350(350, "药学研究所（包括药用植物研究所）", 3), MEDICAL_351(351, "医学普通高中等学校", 3), MEDICAL_352(352, "医学成人学校", 3), MEDICAL_353(353, "医学在职培训机构包括各类卫生技术人员、管理人员培训中心等", 3), MEDICAL_354(354, "健康教育所包括健康教育研究所", 3), MEDICAL_355(355, "健康教育站(中心)包括卫生宣教馆", 3), MEDICAL_356(356, "临床检验中心（所、站）", 3), MEDICAL_357(357, "卫生新闻出版社", 3), MEDICAL_358(358, "其他卫生事业机构", 3), MEDICAL_359(359, "红十字会", 3), MEDICAL_360(360, "医学会包括预防医学会、护理学会、医院管理学会等各类卫生专业学会", 3), MEDICAL_361(361, "协会", 3), MEDICAL_362(362, "其他卫生社会团体", 3), CHAIN_DRUG_STORE(41, "连锁药店总部", 4), DIRECT_CHAIN_DRUGS_STORE(42, "直营连锁药店", 4), JOIN_CHAIN_DRUG_STORE(43, "加盟连锁药店", 4), SINGLE_DRUG_STORE(44, "单体药店", 4), OTHER_DRUG_STORE(45, "其他", 4), MARKET_AUTH_HOLD_CHAINA(71, "境内持证商", 7), MARKET_AUTH_HOLD_FOREIGN(72, "境外持证商", 7) ; store_addrs Address [] 可选企业其他地址省市区信息企业其他地址省市区信息 └ area_name String 可选朝阳区境内填写区县名称/境外则填写境外国家中文名称 └ city_name String 可选北京市城市名称/境外不用填，境内必填 └ prov_name String 可选北京省份名称/境外不用填，境内必填 └ ent_name String 必须测试企业新增企业名称 └ user_role_type Number 必须 3 用类型code值：比如是医疗机构则传3.企业/机构类型枚举结构：(类型code，类型名称)；枚举值：PROD_ENT(1,"生产企业"), WHOLESALE_ENT(2,"批发企业"), MEDICAL_ENT(3,"医疗机构"), RESALE_ENT(4,"零售企业"), LOGISTICS_ENT(5,"物流企业"), MAH_ENT(7,"上市许可持有人"), CENTRAL_RANDOMIZATION_SYSTEM_PROVIDER(8,"中央随机化系统提供商"); reg_addr Address 必须企业注册地址省市区信息 └ prov_name String 可选境外不用不填，境内必填省份名称/境外不用填，境内必填 └ city_name String 可选境外不用不填，境内必填城市名称/境外不用填，境内必填 └ area_name String 必须韩国境内填写区县名称/境外则填写境外国家中文名称 └ license_type Number 必须 8 用类型code值：比如营业执照资质则传8.资质证照类型枚举结构：(类型code，类型值)；枚举值：DRUG_BUSINESS_LICENSE(1, "药品经营许可证"), GSP(2, "GSP"), PRACTICE_LICENSE_OF_MEDICAL_INSTITUTION(3, "医疗机构执业许可证"), GMP(4, "GMP"), PHARMACEUTICAL_PRODUCTION_LICENSE(5, "药品生产许可证"), GUP(6, "GUP"), REGISTRATION_CERTIFICATE_OF_FOREIGN_ENTERPRISES(7, "外国企业常驻中国代表机构登记证"), BUSINESS_LICENSE(8, "营业执照"), OTHER(9, "其他"), ORG_CODE_LICENSE(10, "组织机构代码证"), PUBLIC_INSTITUTIONS_LICENSE(11, "事业单位法人证书"), PRIVATE_NON_ENTERPRISE_ORGANIZATION_LICENSE(12, "民办非企业单位登记证书"), AGENCY_BUSINESS_LICENSE(13, "代理公司营业执照"), IMPORT_DRUG_REGISTRATION_LICENSE(14, "进口药品注册证"), DRUG_REGISTRATION_APPROVAL_LICENSE(15, "药品注册批件"), AUTHORIZATION_LICENSE(16, "授权书") ; └ mobile_phone String 必须 15812548651 追溯业务负责人联系电话 └ org_code String 必须有按实际填写，没有则填写：无唯一认证代码：唯一认证代码是证件的编号，是国家对您的唯一认证编码。如：证件是营业执照，唯一认证编码就是营业执照上的社会信用代码或组织机构代码。证件是身份证，唯一认证编码就是身份证号。证件是护照，唯一认证编码就是护照编号。证件是医疗职业许可证，唯一认证编码就是许可证上的卫生机构组织代码或登记号。以药品注册证为证件入驻的境外企业，唯一认证代码可填“无”。 └ tel String 可选 0731-4567894 固定电话 └ contact_psn_nm String 可选张三追溯业务负责人名称 └ email String 可选 123@qq.com 追溯负责人联系邮箱
lic_picture_byte	byte[]	必须	图片数据流	图片数据流。图片大小务必控制在2M以内

名称	类型	示例值	描述
result	ResultModel		往来单位新增接口返回
└ success Boolean true true：接口调用成功 model Model 具体返回值 └ check_msg String "" 新增失败的时候错误原因 └ par_ref_ent_id String c14212121212 新增成功后分配的往来单位refEntId └ add_sucess Boolean true 新增成功还是失败，true：新增成功 └ msg_info String "" 接口调用失败具体信息 └ msg_code String "" 接口调用失败具体code

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

TaobaoClient client = new DefaultTaobaoClient(url, appkey, secret);
AlibabaAlihealthDrugKytWesSaveentRequest req = new AlibabaAlihealthDrugKytWesSaveentRequest();
req.setRefEntId("cf846d0b3e6445d6b6538c7637c4ebf6");
req.setLicenseToken("服务时间");
AlibabaAlihealthDrugKytWesSaveentRequest.AddEntReqDTO obj1 = new AlibabaAlihealthDrugKytWesSaveentRequest.AddEntReqDTO();
obj1.setDictRegionDetail("xx镇xx乡xx门牌号");
obj1.setEntOrgType(311L);
List<AlibabaAlihealthDrugKytWesSaveentRequest.Address> list3 = new ArrayList<AlibabaAlihealthDrugKytWesSaveentRequest.Address>();
AlibabaAlihealthDrugKytWesSaveentRequest.Address obj4 = new AlibabaAlihealthDrugKytWesSaveentRequest.Address();
list3.add(obj4);
obj4.setAreaName("朝阳区");
obj4.setCityName("北京市");
obj4.setProvName("北京");
obj1.setStoreAddrs(list3);
obj1.setEntName("测试企业");
obj1.setUserRoleType(3L);
AlibabaAlihealthDrugKytWesSaveentRequest.Address obj5 = new AlibabaAlihealthDrugKytWesSaveentRequest.Address();
obj5.setProvName("境外不用不填，境内必填");
obj5.setCityName("境外不用不填，境内必填");
obj5.setAreaName("韩国");
obj1.setRegAddr(obj5);
obj1.setLicenseType(8L);
obj1.setMobilePhone("15812548651");
obj1.setOrgCode("有按实际填写，没有则填写：无");
obj1.setTel("0731-4567894");
obj1.setContactPsnNm("张三");
obj1.setEmail("123@qq.com");
req.setAddEntReq(obj1);
req.setLicPictureByte(new FileItem("/tmp/file.txt"));
AlibabaAlihealthDrugKytWesSaveentResponse rsp = client.execute(req);
System.out.println(rsp.getBody());

ITopClient client = new DefaultTopClient(url, appkey, secret);
AlibabaAlihealthDrugKytWesSaveentRequest req = new AlibabaAlihealthDrugKytWesSaveentRequest();
req.RefEntId = "cf846d0b3e6445d6b6538c7637c4ebf6";
req.LicenseToken = "服务时间";
AlibabaAlihealthDrugKytWesSaveentRequest.AddEntReqDTODomain obj1 = new AlibabaAlihealthDrugKytWesSaveentRequest.AddEntReqDTODomain();
obj1.DictRegionDetail = "xx镇xx乡xx门牌号";
obj1.EntOrgType = 311L;
List<AlibabaAlihealthDrugKytWesSaveentRequest.AddressDomain> list3 = new List<AlibabaAlihealthDrugKytWesSaveentRequest.AddressDomain>();
AlibabaAlihealthDrugKytWesSaveentRequest.AddressDomain obj4 = new AlibabaAlihealthDrugKytWesSaveentRequest.AddressDomain();
list3.Add(obj4);
obj4.AreaName = "朝阳区";
obj4.CityName = "北京市";
obj4.ProvName = "北京";
obj1.StoreAddrs= list3;
obj1.EntName = "测试企业";
obj1.UserRoleType = 3L;
AlibabaAlihealthDrugKytWesSaveentRequest.AddressDomain obj5 = new AlibabaAlihealthDrugKytWesSaveentRequest.AddressDomain();
obj5.ProvName = "境外不用不填，境内必填";
obj5.CityName = "境外不用不填，境内必填";
obj5.AreaName = "韩国";
obj1.RegAddr= obj5;
obj1.LicenseType = 8L;
obj1.MobilePhone = "15812548651";
obj1.OrgCode = "有按实际填写，没有则填写：无";
obj1.Tel = "0731-4567894";
obj1.ContactPsnNm = "张三";
obj1.Email = "123@qq.com";
req.AddEntReq_ = obj1;
req.LicPictureByte = new FileItem("/tmp/file.txt");
AlibabaAlihealthDrugKytWesSaveentResponse rsp = client.Execute(req);
Console.WriteLine(rsp.Body);

$c = new TopClient;
$c->appkey = $appkey;
$c->secretKey = $secret;
$req = new AlibabaAlihealthDrugKytWesSaveentRequest;
$req->setRefEntId("cf846d0b3e6445d6b6538c7637c4ebf6");
$req->setLicenseToken("服务时间");
$add_ent_req = new AddEntReqDTO;
$add_ent_req->dict_region_detail="xx镇xx乡xx门牌号";
$add_ent_req->ent_org_type="311";
$store_addrs = new Address;
$store_addrs->area_name="朝阳区";
$store_addrs->city_name="北京市";
$store_addrs->prov_name="北京";
$add_ent_req->store_addrs = $store_addrs;
$add_ent_req->ent_name="测试企业";
$add_ent_req->user_role_type="3";
$reg_addr = new Address;
$reg_addr->prov_name="境外不用不填，境内必填";
$reg_addr->city_name="境外不用不填，境内必填";
$reg_addr->area_name="韩国";
$add_ent_req->reg_addr = $reg_addr;
$add_ent_req->license_type="8";
$add_ent_req->mobile_phone="15812548651";
$add_ent_req->org_code="有按实际填写，没有则填写：无";
$add_ent_req->tel="0731-4567894";
$add_ent_req->contact_psn_nm="张三";
$add_ent_req->email="123@qq.com";
$req->setAddEntReq(json_encode($add_ent_req));
//附件上传的机制参见PHP CURL文档，在文件路径前加@符号即可
$req->setLicPictureByte(@fileLocation);
$resp = $c->execute($req);

curl -X POST 'http://gw.api.taobao.com/router/rest' \
-H 'Content-Type:multipart/form-data;charset=utf-8' \
-F 'app_key=12129701' \
-F 'format=json' \
-F 'method=alibaba.alihealth.drug.kyt.wes.saveent' \
-F 'partner_id=apidoc' \
-F 'sign=610C235ADD3EA0D152796E5E171841AC' \
-F 'sign_method=hmac' \
-F 'timestamp=2025-05-16+14%3A44%3A56' \
-F 'v=2.0' \
-F 'add_ent_req=null' \
-F 'license_token=%E6%9C%8D%E5%8A%A1%E6%97%B6%E9%97%B4' \
-F 'ref_ent_id=cf846d0b3e6445d6b6538c7637c4ebf6' \
-F 'lic_picture_byte=@/tmp/file.txt'

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

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

req.ref_ent_id="cf846d0b3e6445d6b6538c7637c4ebf6"
req.license_token="服务时间"
req.add_ent_req="数据结构示例JSON格式"
req.lic_picture_byte=top.api.FileItem('abc.jpg',open('abc.jpg','rb'))
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.drug.kyt.wes.saveent");
add_param(pRequest,"ref_ent_id","cf846d0b3e6445d6b6538c7637c4ebf6");
add_param(pRequest,"license_token","服务时间");
add_param(pRequest,"add_ent_req","数据结构JSON示例");
add_file_param(pRequest,"lic_picture_byte","文件内容");
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.drug.kyt.wes.saveent', {
	'ref_ent_id':'cf846d0b3e6445d6b6538c7637c4ebf6',
	'license_token':'服务时间',
	'add_ent_req':'数据结构JSON示例',
	'lic_picture_byte':'文件内容'
}, function(error, response) {
	if (!error) console.log(response);
	else console.log(error);
})

XML示例
JSON示例

<alibaba_alihealth_drug_kyt_wes_saveent_response>
    <result>
        <success>true</success>
        <model>
            <check_msg>&quot;&quot;</check_msg>
            <par_ref_ent_id>c14212121212</par_ref_ent_id>
            <add_sucess>true</add_sucess>
        </model>
        <msg_info>&quot;&quot;</msg_info>
        <msg_code>&quot;&quot;</msg_code>
    </result>
</alibaba_alihealth_drug_kyt_wes_saveent_response>

{
    "alibaba_alihealth_drug_kyt_wes_saveent_response":{
        "result":{
            "success":true,
            "model":{
                "check_msg":"\"\"",
                "par_ref_ent_id":"c14212121212",
                "add_sucess":true
            },
            "msg_info":"\"\"",
            "msg_code":"\"\""
        }
    }
}

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下载

阿里健康追溯码

alibaba.alihealth.drug.kyt.wes.saveent (新增往来单位企业记录)

公共参数

请求参数

响应参数

请求示例

响应示例

异常示例

错误码解释

API工具

如何获得此API

FAQ

用户导航

用户反馈

用户反馈

用户反馈