接口调用地址
线路类型一 [普通集群负载-IP接口]
说明：直接访问 https://api.apihz.cn/getapi.php 获取当前最优IP接口地址。由普通负载集群服务器组成，通过IP接口地址调用，如果单个服务器过载可自行切换IP接口地址尝试其他负载服务器。IP并非永久固定且容易遭受攻击，平台可能不定期更换。
线路类型二 [普通集群负载-域名接口]
说明：域名接口会自动分发请求到普通集群服务器均衡负载，该域名TTL值为60秒，表示你的请求会每60秒实现自动轮换负载服务器，但也可能因你的网络服务商存在DNS缓存造成短时间内无法自动切换负载。如果某个负载服务器出现故障，也可能会造成个别地区存在一定时间的故障期。
线路类型三 [VIP集群负载-VIP线路接口]
说明：VIP专线在普通集群组的基础上额外增加独享大带宽集群组，每次请求自动均衡负载，自动故障切换，抗攻击，全球智能CDN加速。超高稳定性！最低30¥/月，彩钻以上会员专属，登录后购买。注：VIP线路是指调用接口的线路更有保障以及每分钟拥有更高的调用频次等，并非收费接口包月使用。
请求示例
[GET]请求示例：(请登录后使用自己的KEY独享频次)
复制参数
复制全部
[POST]请求示例：(请根据开发语言自行POST，参考【GET/POST教程】，或下载【超级客户端】调试。)
请求参数说明
注意：请求编码为UTF8，否则带中文请求可能失败。一般参数不能带+号，会被自动替换为空格。参数内容较大的必须用POST，不能GET。
提示：如发现接口有BUG，可加服务QQ群及时向我们反馈。
提示：请求参数里的开发者ID与KEY，登录后台菜单【个人资料】里查看。
提示：如发现接口有BUG，可加服务QQ群及时向我们反馈。
提示：请求参数里的开发者ID与KEY，登录后台菜单【个人资料】里查看。
| 名称 | 参数 | 必填 | 说明 |
|---|---|---|---|
| 开发者ID | id | 是 | 用户中心的数字ID，例：id=10000000 |
| 开发者KEY | key | 是 | 用户中心通讯秘钥，例：key=15he5h15ty854j5sr152hs2 |
| cookie | ck | 否 | 随便打开一篇文章，浏览器F12进入调试模式，复制整段cookie。不传CK如果失败请多次尝试，有一定几率成功。很多文章必须传CK才能获取。例：ck=cookie |
| 文章URL | url | 是 | 文章地址，如果链接地址带&符号，请把&符号替换为<>。例：url=http://xhslink.com/a/AFsYwhoawxYcb或url=https://www.xiaohongshu.com/discovery/item/6847cbb80000000021005c23?source=webshare<>xhsshare=pc_web<>xsec_token=ABM4mjk01lktakV9U1sZjZ6TrO4sZfJTNLeOBZWDPNqDQ=<>xsec_source=pc_share |
| 是否使用缓存 | hctype | 否 | 1=不使用缓存，一般在内容里图片链接失效时可不使用缓存，获取最新的图片地址。例：hctype=1 |
| 动态秘钥 | dkey | 否 | 开发者开启动态秘钥验证后需传此参数，主要针对直接在客户端调用接口的场景。请在官网后台菜单【个人资料】里配置。例：dkey=0cd2a494831736587c33f30d1e544371 |
| 用户IP | uip | 否 | 接口调用者IP，用于后台统计IP地域分布，ISP运营商，时段IP数统计等，如不传该参数则默认为接口请求端IP，该参数主要用于使用后端服务器/中间件请求接口的方式使用。例：uip=123.123.123.123。该参数彩钻/炫钻/焱钻会员专享。 |
返回参数说明
| 名称 | 参数 | 说明 |
|---|---|---|
| 状态码 | code | 200成功，400错误 |
| 信息提示 | msg | 信息提示。 |
| 文章ID | noteId | 文章ID。 |
| 文章标题 | title | 文章标题。 |
| 文章内容 | desc | 文章内容。 |
| 作者昵称 | nickname | 作者昵称。 |
| 作者ID | userId | 作者ID。 |
| 作者头像 | avatar | 作者头像。 |
| 图片数据集 | data | 资源数据集，图片。包含不同分辨率图片等。 |
| 视频数据集 | video | 视频数据集。 |
返回数据示例
示例：{"code":400,"msg":"通讯秘钥错误。"}
示例：
{
"code": 200,
"noteId": "6847cbb80000000021005c23",
"title": "《庐州月》彩排～",
"desc": "",
"nickname": "祝绪丹Bambi",
"userId": "56ef751daed75817cf5981dd",
"avatar": "https://sns-avatar-qc.xhscdn.com/avatar/5e78f8de50bbc200014f5d93.jpg",
"data": [{
"url": "",
"urlPre": "http://sns-webpic-qc.xhscdn.com/202506241143/13e5a31b7e3a0cef1b4389cac7ccc638/1040g2sg31ihpqvrtgcj0477g0vqhr0etbrenlfg!nd_prv_wlteh_jpg_3",
"stream": [],
"height": 2560,
"width": 2560,
"infoList": [{
"imageScene": "WB_PRV",
"url": "http://sns-webpic-qc.xhscdn.com/202506241143/13e5a31b7e3a0cef1b4389cac7ccc638/1040g2sg31ihpqvrtgcj0477g0vqhr0etbrenlfg!nd_prv_wlteh_jpg_3"
}, {
"url": "http://sns-webpic-qc.xhscdn.com/202506241143/c1b43e31a710a334e23392c5a25c6f05/1040g2sg31ihpqvrtgcj0477g0vqhr0etbrenlfg!nd_dft_wlteh_jpg_3",
"imageScene": "WB_DFT"
}],
"urlDefault": "http://sns-webpic-qc.xhscdn.com/202506241143/c1b43e31a710a334e23392c5a25c6f05/1040g2sg31ihpqvrtgcj0477g0vqhr0etbrenlfg!nd_dft_wlteh_jpg_3",
"livePhoto": false,
"fileId": "",
"traceId": ""
}],
"video": [{
"hdrType": 0,
"avgBitrate": 993917,
"audioBitrate": 56097,
"rotate": 0,
"streamType": 258,
"videoBitrate": 931174,
"audioChannels": 2,
"defaultStream": 0,
"format": "mp4",
"videoDuration": 104300,
"streamDesc": "X264_MP4",
"height": 720,
"volume": 0,
"ssim": 0,
"backupUrls": [
"http://sns-bak-v1.xhscdn.com/stream/79/110/258/01e847cbb749fbf34f03700197587466af_258.mp4",
"http://sns-bak-v6.xhscdn.com/stream/79/110/258/01e847cbb749fbf34f03700197587466af_258.mp4"],
"videoCodec": "h264",
"audioCodec": "aac",
"audioDuration": 104234,
"masterUrl": "http://sns-video-hw.xhscdn.com/stream/79/110/258/01e847cbb749fbf34f03700197587466af_258.mp4",
"vmaf": -1,
"weight": 59,
"width": 720,
"duration": 104300,
"qualityType": "HD",
"size": 12958196,
"fps": 30,
"psnr": 0
}]
}
更新记录
