/ 接口详情

bing

必应每日一图

接口信息

POST api.849484.xyz/apis/bing
方法
POST
分类
未分类
计费
免费
KEY
无需 KEY
调用
8
QPM
不限制
鉴权
无需密钥
作者
haibin

详细文档

bing

接口说明

该接口用于获取必应每日一图，适合需要展示每日壁纸或背景图的开发者。调用简单，无需鉴权即可使用。

调用地址

http://api.haibinde.com/apis/bing

请求方式

POST

鉴权说明

本接口无需密钥，直接调用即可。

请求参数

该接口为必应每日一图服务，请求参数说明如下：

参数名 类型 必填 说明
(无) - - 该接口无需传入任何请求参数，直接发起 POST 请求即可获取数据

成功响应示例

{
  "code": 0,
  "message": "success",
  "data": {
    "copyright": "Copyright © Microsoft",
    "url": "https://www.bing.com/HPImageArchive.aspx",
    "urlbase": "https://www.bing.com",
    "startdate": "2023-10-01",
    "title": "必应每日一图",
    "images": [
      {
        "url": "/media/HPImageView.aspx?rendertype=webp&width=1080&height=1080",
        "startdate": "2023-10-01",
        "title": "每日图片标题"
      }
    ]
  }
}

响应字段说明

字段 类型 说明
code Integer 状态码，0 表示请求成功。
message String 状态描述信息。
data Object 每日图片数据主体。
data.copyright String 图片版权信息。
data.url String 图片归档页面链接。
data.urlbase String 基础链接前缀。
data.startdate String 当日日期，格式为 YYYY-MM-DD。
data.title String 当日图片主题标题。
data.images Array 图片详情列表，通常包含当日图片信息。
data.images[].url String 图片相对路径，需拼接 data.urlbase 使用。
data.images[].startdate String 图片发布日期。
data.images[].title String 图片具体描述或标题。

错误响应示例

{
  "code": 0,
  "msg": "未提供调用密钥",
  "errcode": 11001
}

业务错误码说明

下表列出接口可能返回的业务错误码及其含义：

错误码 含义
11001 未提供调用密钥
11002 密钥错误
11003 密钥已禁用
11004 积分余额不足
11005 请求过于频繁（QPM 限制）
11006 接口维护中
11007 接口已禁用
11008 接口不可用
11009 密钥校验暂不可用
11010 积分系统暂不可用
11011 收费接口须提供有效密钥
11012 鉴权方式错误
11013 接口不存在
11014 ***地址无效
11015 ***地址不允许
11016 ***请求失败
11017 服务暂不可用
11018 请求方式不允许
11019 当前IP不在白名单内
11020 启用出口代理须提供有效密钥
11021 未配置可用出口代理
11022 出口代理不可用
11023 密钥已过期
11024 令牌分配积分不足
11025 该密钥无权调用此接口

调用示例

终端 curl（bash）

curl -X POST "http://api.haibinde.com/apis/bing"

PHP

// PHP 示例：调用必应每日一图接口
$ch = curl_init();
curl_setopt($ch, CURLOPT_URL, "http://api.haibinde.com/apis/bing");
curl_setopt($ch, CURLOPT_POST, true);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
$response = curl_exec($ch);
curl_close($ch);
echo $response;

注意事项

  • 协议与域名：请严格使用指定的调用地址 http://api.haibinde.com/apis/bing。当前接口仅支持 HTTP 协议，请勿自行替换为 HTTPS 或更改域名，以免因证书不匹配或路由未配置导致请求失败。
  • 请求方式：接口仅接受 POST 请求。若使用 GET 或其他方法，将返回错误状态码。
  • 参数传递：该接口无需请求参数。请勿在请求体中发送额外的 JSON 字段、表单数据或 URL 查询参数，这可能导致解析异常或无预期的结果。
  • 身份认证：该接口无需 API 密钥、Token 或任何形式的安全凭证。请勿在请求头中附带无效的 Authorization 字段，以免干扰网关识别。
  • 频率限制：作为免费服务，接口设有基础并发与日调用上限。请勿通过脚本进行高频轮询或批量抓取，以免触发临时封禁。建议生产环境中加入本地缓存机制，同一天的结果只需请求一次。
  • 数据时效性：返回的“每日一图”数据按自然日更新。通常在每日凌晨完成更新，若当日请求未获取到最新图片，可稍后重试，勿在刚跨天后立即死循环调用。
  • 依赖稳定性：该接口聚合外部图片资源，若***临时故障或图片 CDN 不可用，接口可能返回错误或空数据。请在客户端设计中增加重试机制与降级方案（如显示默认占位图），确保前端用户体验不受单点故障影响。
  • 响应处理：由于未提供具体返回示例，请在实际集成时做好空值判断与非标准 JSON 结构的兼容性处理，避免因字段缺失导致前端渲染崩溃。