医疗内容平台 推荐 API

一、接口地址

·预发布环境域名：https://preview.baike.qq.com

·生产环境域名：https://h5.baike.qq.com

注意：说明：

注意：在新接口联调时，请使用预发布环境的域名；已上线接口使用正式环境域名。

二、接口说明

接口地址：https://preview.baike.qq.com/api/access/json/cmd/RecommendV2

接口请求方式：POST

接口请求头：Content-Type: application/json

三、签名生成说明

四、请求参数说明

五、请求用户扩展信息参数说明

六、请求用户扩展信息固定范围说明

七、请求用户标签参数说明

八、响应参数说明

九、响应推荐文章参数说明

十、响应文章作者信息参数说明

十一、响应作者医生信息参数说明

十二、响应作者医院信息参数说明：

十三、输入参数示例

{
"header": {
"version": "1.0.0",
"flag": 0
},
"body": {
"seq": 0,
"cmd": "SearchV2",
"token": "",
"client": {
"clientIP": "",
"adtag": "$adtag"
},
"payload": {
"timestamp": "1669950164",
"noncestr": "0.623706833947",
"signature": "33c8f78ce2258c30af5f31b4153cd8b69035bfad06294a08c4ca0cf2ab5e4a46",
"appid": "2000000000000000",
"recommend_req": {
"article_cnt": 10,
"ad_tag": "$adtag",
"extra_info": [
{
"type": "txyd_outer_userid",
"tag": "userid_1"
}
],
"user_tags": [
{
"type": "disease",
"tag": "高血压",
"weight": 1
}
],
"tag_filter": {
"tags": [
{
"l1_class": "饮食营养",
"l2_class": ""
},
{
"tag_word": "妇科"
}
],
"relation": 1
}
}
}
}
}

十四、响应参数示例

{
"body": {
"message": "success",
"payload": {
"recommend_data": [
{
"ctype": 8,
"url": "https://preview.baike.qq.com/mobile/article.html?sn=yidian-sn-ZHjnr0xXhxqJDontkY7pYLNoePQDmJeao36Z3WSbu6dsHgjNn2BIsuFwOR7lRvJF&tmenulogo=hide&adtag=jkyb.ydyy&externchannel_uin=",
"source": "腾讯医典医学团队",
"title": "乳腺癌早期有哪些危险信号？",
"summary_url": "https://th-yidian-cos-1251316161.file.myqcloud.com/2023062/9efdbf30-0b46-11ee-a34c-e770b37218c5_0.jpg",
"abs": "大部分乳腺癌的患者皆因没有定期做体检筛查，发现乳房异常（肿块）等情况才会就医被确诊。",
"op_author": {
"op_doctor": [
{
"hospital_clickable": 0,
"prefix": "",
"name": "吴炅",
"weight": 0,
"sole": 0,
"department": "乳腺外科",
"follow": -1,
"text": "复旦大学附属肿瘤医院吴炅主任医师审阅",
"hprank": "三甲",
"drid": 10116,
"hpid": 0,
"icon": "https://baike-med-1256891581.file.myqcloud.com/2018095/29bec8d0-b25a-11e8-926b-21df1809aaee_0.png",
"position": "主任医师",
"hospital": "复旦大学附属肿瘤医院",
"doctor_type": 0,
"doctor_clickable": 1
}
]
},
"releasetime": "2023-06-15",
"direction": 1,
"doc_id": "tx00008008nqtjfk"
}
],
"article_cnt": 20
},
"seq": 0,
"traceid": "f1e74579-aca2-4ed0-9f3a-707c00bc9756",
"retcode": 0,
"bizcode": 0,
"cmd": "Recommend"
},
"header": {
"flag": 0,
"version": 0
}
}

十五、预发布示例

curl -H 'content-type: application/json' -d '{
"header": {
"version": "1.0.0",
"flag": 0
},
"body": {
"seq": 0,
"cmd": "RecommendV2",
"token": "",
"client": {
"clientIP": "192.168.1.1",
"adtag": "$adtag"
},
"payload": {
"timestamp": "1494231435",
"noncestr": "0.623706833947",
"signature": "52e050f0e82da2b7582360f516acd04a71eb67e",
"appid": "2000000000000000",
"recommend_req": {
"ad_tag": "$adtag",
"article_cnt": 10,
"extra_info": [
{
"type": "txyd_outer_userid",
"tag": "12345"
}
]
}
}
}
}' 'https://preview.baike.qq.com/api/access/json/cmd/RecommendV2'

十六、生产示例

curl -H 'content-type: application/json' -d '{
"header": {
"version": "1.0.0",
"flag": 0
},
"body": {
"seq": 0,
"cmd": "RecommendV2",
"token": "",
"client": {
"clientIP": "192.168.1.1",
"adtag": "$adtag"
},
"payload": {
"timestamp": "1494231435",
"noncestr": "0.623706833947",
"signature": "52e050f0e82da2b7582360f516acd04a71eb67e",
"appid": "2000000000000000",
"recommend_req": {
"ad_tag": "$adtag",
"article_cnt": 10,
"extra_info": [
{
"type": "txyd_outer_userid",
"tag": "12345"
}
]
}
}
}
}' 'https://h5.baike.qq.com/api/access/json/cmd/RecommendV2'