接口线路类型一[集群IP接口-免费]
[接口地址1]
：当前负载【
优】 接口通讯【
正常】
复制
测速
[接口地址2]
：当前负载【
优】 接口通讯【
正常】
复制
测速
[接口地址3]
：当前负载【
优】 接口通讯【
正常】
复制
测速
接口线路类型二[域名接口-免费]
[接口地址]
：[自动分发到集群接口服务器，但可能因网络运营商DNS缓存如果某个集群节点发生故障会造成个别地区有1天左右的故障期。CC防火墙适中。]
复制
测速
接口线路类型三[超高稳定-最低24¥/月]
[彩钻接口]
：[专属集群+普通集群+备用集群，自动负载均衡，自动故障切换，抗攻击，全球智能CDN加速。超高稳定性！CC防火墙宽松。登录后购买。]
复制
测速
请求示例
[GET]请求示例：(以下为公共KEY，共享每分钟调用频次，请登录后使用自己的KEY独享频次)
复制全部
复制参数
[POST]请求示例(请根据开发语言自行POST)
请求参数说明
注意：请求编码为UTF8，否则带中文请求可能失败。一般参数不能带+号，会被自动替换为空格。
提示：如发现接口有BUG，可加服务QQ群500700444，及时向我们反馈。
提示：请求参数里的开发者ID与KEY，登录后台菜单【个人资料】里查看。
| 名称 |
参数 |
必填 |
说明 |
| 开发者ID | id | 是 | 用户中心的数字ID，例：id=10000000 |
| 开发者KEY | key | 是 | 用户中心通讯秘钥，例：key=15he5h15ty854j5sr152hs2 |
| 搜索类型 | type | 是 | 1=随机结果，2=指定关键词搜索。例：type=1 |
| 关键词 | words | 否 | 要搜索的表情包关键词，长度不超过10个汉字，URL编码，例：words=大笑 |
| 页码 | page | 否 | 当type=2时需传页码，默认1，例：page=1 |
| 结果数量 | limit | 否 | 返回结果数量，不超过20，默认1，例：limit=1 |
| 动态秘钥 | dkey | 否 | 开发者开启动态秘钥验证后需传此参数，主要针对直接在客户端调用接口的场景。请在官网后台菜单【个人资料】里配置。例：dkey=0cd2a494831736587c33f30d1e544371 |
| 用户IP | uip | 否 | 接口调用者IP，用于后台统计IP地域分布，ISP运营商，时段IP数统计等，如不传该参数则默认为接口请求端IP，该参数主要用于使用后端服务器/中间件请求接口的方式使用。例：uip=123.123.123.123。该参数彩钻会员和炫钻会员专享。 |
返回参数说明
| 名称 |
参数 |
说明 |
| 状态码 | code | 200成功，400错误 |
| 信息提示 | msg | 如果状态码返回400，则msg返回错误提示。 |
| 结果集 | res | 返回表情包图片地址结果集 |
| 当前页码 | page | 返回当前页码，当type=2时才返回 |
| 最大页码 | maxpage | 返回搜索结果的最大页码，当type=2时才返回 |
| 结果数量 | count | 返回搜索结果总数量，当type=2时才返回 |
返回数据示例
示例：{"code":400,"msg":"通讯秘钥错误。"}
type=1示例：{"code":200,"res":["https:\/\/res.apihz.cn\/img\/bqb\/81a0564e2225ee18ebc47774df9b0231.jpg","https:\/\/res.apihz.cn\/img\/bqb\/81a0624562b54c6c3a0c59c71be9a9db.jpg","https:\/\/res.apihz.cn\/img\/bqb\/81a10ec6cd169826ba0bd6149797bcc9.jpg","https:\/\/res.apihz.cn\/img\/bqb\/81a1dd421ff4d4c872798d2ffdc62ee7.jpg","https:\/\/res.apihz.cn\/img\/bqb\/81a22fdd1d382fd76ce8b28d73f8546a.jpg","https:\/\/res.apihz.cn\/img\/bqb\/81a35c91482940a358d2a2df0216dbe0.jpg"]}
type=2示例：{"code":200,"page":"2","maxpage":8,"count":"40","res":["https:\/\/res.apihz.cn\/img\/bqb\/23ff32c6884466dd45af8f6963cc5fb8.jpg","https:\/\/res.apihz.cn\/img\/bqb\/2a881766e29ea0407a6aeb8748a98b50.jpg","https:\/\/res.apihz.cn\/img\/bqb\/3dee3222a441dfea93a3a94bc16d446c.gif","https:\/\/res.apihz.cn\/img\/bqb\/3feea35161b70528ba6b7d08902bcfdf.jpg","https:\/\/res.apihz.cn\/img\/bqb\/433428d5358517907082dafba26b135f.png"]}
更新记录
2024-04-15 11:10:02 - 新增接口。
图像壁纸-表情包-API盒子官方资源库版-2024-04-16 11:21:54
