接口地址:https://api.uouin.com/app/bingimg
返回格式:Json
请求方式:Http(s) Get/Post请求
请求示例:https://api.uouin.com/app/bingimg?username=用户名&key=密钥
接口说明:必应每日背景图片,返回必应最近8天的背景高清图片,适合用于做电脑桌面壁纸。
请求参数说明:
参数名称 | 必填 | 类型 | 说明 |
---|---|---|---|
username | 是 | string | 用户名 |
key | 是 | string | 密钥 |
url | 是 | string | 需要传入的数据或地址 |
返回参数说明:
参数名称 | 类型 | 说明 |
---|---|---|
code | number | |
data | string | 返回的数据,如有则返回! |
statu | string | 异常为false,正常为true! |
count | number | 点数包,如按量计费则返回! | url | string | 传入的数据! |
响应文本:
{
"msg": "获取成功",
"data": [
{
"headline": "让我们扬帆起航!",//图标标题
"imgurl": "https://cn.bing.com/th?id=OHR.ConwyRiver_ZH-CN6871799250_1920x1080.jpg&rf=LaDigue_1920x1080.jpg&pid=hp",//图片地址
"copyright": "从康威河眺望康威城堡,威尔士 (© David Chapman/Alamy Stock Photo)",//图标版权
"timestamp": "202407050900"//必应显示时间
},
{
"headline": "邂逅美丽海岸线",
"imgurl": "https://cn.bing.com/th?id=OHR.NoahBeach_ZH-CN6676061324_1920x1080.jpg&rf=LaDigue_1920x1080.jpg&pid=hp",
"copyright": "丹翠雨林的诺亚海滩,昆士兰州,澳大利亚 (© bjeayes/Getty Images)",
"timestamp": "202407040900"
},
{
"headline": "风景如画的白色小镇",
"imgurl": "https://cn.bing.com/th?id=OHR.ZaharaDeLaSierra_ZH-CN6500182265_1920x1080.jpg&rf=LaDigue_1920x1080.jpg&pid=hp",
"copyright": "扎哈拉德拉谢拉,安达卢西亚,西班牙 (© Francesco Carovillano/eStock Photo)",
"timestamp": "202407030900"
},
{
"headline": "等等,谁在那儿?",
"imgurl": "https://cn.bing.com/th?id=OHR.MeerkatManor_ZH-CN2486051161_1920x1080.jpg&rf=LaDigue_1920x1080.jpg&pid=hp",
"copyright": "猫鼬家族 (© anetapics/Shutterstock)",
"timestamp": "202407020900"
},
{
"headline": "昔日城市的“灵魂”",
"imgurl": "https://cn.bing.com/th?id=OHR.ItalicaRuins_ZH-CN5932138207_1920x1080.jpg&rf=LaDigue_1920x1080.jpg&pid=hp",
"copyright": "意大利卡,桑蒂蓬塞的一座古罗马城市,塞维利亚,安达卢西亚,西班牙 (© Moses Palermo/Amazing Aerial Agency)",
"timestamp": "202407010900"
},
{
"headline": "为加拿大干杯",
"imgurl": "https://cn.bing.com/th?id=OHR.FisgardLighthouse_ZH-CN5474064913_1920x1080.jpg&rf=LaDigue_1920x1080.jpg&pid=hp",
"copyright": "菲斯加德灯塔,埃斯奎莫尔特港,科尔伍德,不列颠哥伦比亚省,加拿大 (© davemantel/Getty Images)",
"timestamp": "202406300900"
},
{
"headline": "你不会忘记它的!",
"imgurl": "https://cn.bing.com/th?id=OHR.UbudBali_ZH-CN4891348277_1920x1080.jpg&rf=LaDigue_1920x1080.jpg&pid=hp",
"copyright": "乌布寺庙的石雕,巴厘岛,印度尼西亚 (© R. Schönebaum/plainpicture)",
"timestamp": "202406290900"
},
{
"headline": "只见树木,不见森林",
"imgurl": "https://cn.bing.com/th?id=OHR.NienhagenMecklenburg_ZH-CN4482269700_1920x1080.jpg&rf=LaDigue_1920x1080.jpg&pid=hp",
"copyright": "宁哈根的山毛榉林,梅克伦堡-前波美拉尼亚州,德国 (© Martin Ruegner/Getty Images)",
"timestamp": "202406280900"
}
],
"statu": "true",
"code": "200"
}
系统状态码参考:
状态码code | 说明 | |
---|---|---|
-200 | 用户名不能空 | |
-201 | key不能空 | |
-202 | url不能为空 | |
-203 | 点数包余额不足 | |
-204 | 访问API频率超过套餐限制,请升级套餐 | |
-205 | 请求的接口地址有误,请到API文档获取请求地址 | |
-206 | 账户VIP会员没开通或已过期 | |
-207 | 用户名或key不对 | |
-208 | 非白名单IP,请添加白名单IP | |
-209 | 账户状态异常 | |
-210 | 接口异常,查询失败 | |
-211 | 账户未绑定手机号 | |
-212 | 检测超时,请重试 | |
-213 | 网址存在安全风险,如误报可添加白名单域名 | |
-214 | API功能未开通 | |
1001 | 检测域名状态正常 | |
1002 | 检测域名状态异常或封禁 | |
200 | 获取数据成功 | |
1 | 短网址类调用生成成功 |
对接代码演示:
$result = file_get_contents("https://api.uouin.com/app/bingimg?username=用户名&key=密钥&url=".urlencode($url));
$json = json_decode($result,true);
if($json[code] < 0){
echo $json[msg];// API接口异常,返回异常信息
}
if($code == 1001){
echo "域名正常"; //判断code为1001即为正常
}
if($code == 1002){ //判断code为1002即为拦截
echo "已被封禁";
}
//可通过sleep()或usleep()函数控制调用频率