GET /bing/info · oh! IT

访问类别：匿名 API，可携带 Token 使用独立额度

请求参数

mktquery: Bing 日图地区; string · Bing 日图地区 · 默认值："zh-CN" · 可选：zh-CN、en-US、ja-JP、en-IN、pt-BR、fr-FR、de-DE、en-CA、en-GB、it-IT、es-ES、fr-CA

响应

200 D1 中的完整日图快照与可用版本列表，包含 updatedAt、expiresAt；香港时间每天 08:00 和 20:00 刷新，有效期 26 小时；响应公开缓存最长 300 秒并受快照有效期约束，顶层 url 指向最高质量版本

application/json

{
  "type": "object",
  "properties": {
    "market": {
      "type": "string",
      "enum": [
        "zh-CN",
        "en-US",
        "ja-JP",
        "en-IN",
        "pt-BR",
        "fr-FR",
        "de-DE",
        "en-CA",
        "en-GB",
        "it-IT",
        "es-ES",
        "fr-CA"
      ]
    },
    "date": {
      "type": "string"
    },
    "endDate": {
      "type": "string"
    },
    "url": {
      "type": "string",
      "format": "uri"
    },
    "title": {
      "type": "string"
    },
    "copyright": {
      "type": "string"
    },
    "copyrightUrl": {
      "type": "string",
      "format": "uri"
    },
    "images": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "resolution": {
            "type": "string",
            "enum": [
              "UHD",
              "1920x1200",
              "1920x1080",
              "1366x768",
              "1280x768",
              "1024x768",
              "800x600",
              "800x480",
              "1080x1920",
              "768x1280",
              "720x1280",
              "640x480",
              "480x800",
              "400x240",
              "320x240",
              "240x320"
            ]
          },
          "width": {
            "type": "integer",
            "exclusiveMinimum": 0
          },
          "height": {
            "type": "integer",
            "exclusiveMinimum": 0
          },
          "url": {
            "type": "string",
            "format": "uri"
          }
        },
        "required": [
          "resolution",
          "width",
          "height",
          "url"
        ]
      },
      "minItems": 1
    },
    "updatedAt": {
      "type": "string",
      "format": "date-time"
    },
    "expiresAt": {
      "type": "string",
      "format": "date-time"
    }
  },
  "required": [
    "market",
    "date",
    "endDate",
    "url",
    "title",
    "copyright",
    "copyrightUrl",
    "images",
    "updatedAt",
    "expiresAt"
  ]
}

400 请求校验或执行失败

application/json

{
  "type": "object",
  "properties": {
    "error": {
      "type": "object",
      "properties": {
        "code": {
          "type": "string"
        },
        "message": {
          "type": "string"
        },
        "issues": {
          "type": "array",
          "items": {
            "type": "object",
            "properties": {
              "location": {
                "type": "string",
                "enum": [
                  "body",
                  "query",
                  "path",
                  "header"
                ]
              },
              "field": {
                "type": "string"
              },
              "code": {
                "type": "string"
              },
              "message": {
                "type": "string"
              }
            },
            "required": [
              "location",
              "field",
              "code",
              "message"
            ]
          }
        }
      },
      "required": [
        "code",
        "message"
      ]
    }
  },
  "required": [
    "error"
  ]
}

401 凭据无效、停用、过期或缺少所需 Token

application/json

{
  "type": "object",
  "properties": {
    "error": {
      "type": "object",
      "properties": {
        "code": {
          "type": "string"
        },
        "message": {
          "type": "string"
        },
        "issues": {
          "type": "array",
          "items": {
            "type": "object",
            "properties": {
              "location": {
                "type": "string",
                "enum": [
                  "body",
                  "query",
                  "path",
                  "header"
                ]
              },
              "field": {
                "type": "string"
              },
              "code": {
                "type": "string"
              },
              "message": {
                "type": "string"
              }
            },
            "required": [
              "location",
              "field",
              "code",
              "message"
            ]
          }
        }
      },
      "required": [
        "code",
        "message"
      ]
    }
  },
  "required": [
    "error"
  ]
}

403 需要管理员 Token

application/json

{
  "type": "object",
  "properties": {
    "error": {
      "type": "object",
      "properties": {
        "code": {
          "type": "string"
        },
        "message": {
          "type": "string"
        },
        "issues": {
          "type": "array",
          "items": {
            "type": "object",
            "properties": {
              "location": {
                "type": "string",
                "enum": [
                  "body",
                  "query",
                  "path",
                  "header"
                ]
              },
              "field": {
                "type": "string"
              },
              "code": {
                "type": "string"
              },
              "message": {
                "type": "string"
              }
            },
            "required": [
              "location",
              "field",
              "code",
              "message"
            ]
          }
        }
      },
      "required": [
        "code",
        "message"
      ]
    }
  },
  "required": [
    "error"
  ]
}

413 请求体过大

application/json

{
  "type": "object",
  "properties": {
    "error": {
      "type": "object",
      "properties": {
        "code": {
          "type": "string"
        },
        "message": {
          "type": "string"
        },
        "issues": {
          "type": "array",
          "items": {
            "type": "object",
            "properties": {
              "location": {
                "type": "string",
                "enum": [
                  "body",
                  "query",
                  "path",
                  "header"
                ]
              },
              "field": {
                "type": "string"
              },
              "code": {
                "type": "string"
              },
              "message": {
                "type": "string"
              }
            },
            "required": [
              "location",
              "field",
              "code",
              "message"
            ]
          }
        }
      },
      "required": [
        "code",
        "message"
      ]
    }
  },
  "required": [
    "error"
  ]
}

415 请求内容类型无效

application/json

{
  "type": "object",
  "properties": {
    "error": {
      "type": "object",
      "properties": {
        "code": {
          "type": "string"
        },
        "message": {
          "type": "string"
        },
        "issues": {
          "type": "array",
          "items": {
            "type": "object",
            "properties": {
              "location": {
                "type": "string",
                "enum": [
                  "body",
                  "query",
                  "path",
                  "header"
                ]
              },
              "field": {
                "type": "string"
              },
              "code": {
                "type": "string"
              },
              "message": {
                "type": "string"
              }
            },
            "required": [
              "location",
              "field",
              "code",
              "message"
            ]
          }
        }
      },
      "required": [
        "code",
        "message"
      ]
    }
  },
  "required": [
    "error"
  ]
}

429 请求过于频繁，Retry-After 为建议等待秒数；匿名额度及认证保护在各 Cloudflare 地点近似计数，Token 业务额度使用 D1 原子计数

application/json

{
  "type": "object",
  "properties": {
    "error": {
      "type": "object",
      "properties": {
        "code": {
          "type": "string"
        },
        "message": {
          "type": "string"
        },
        "issues": {
          "type": "array",
          "items": {
            "type": "object",
            "properties": {
              "location": {
                "type": "string",
                "enum": [
                  "body",
                  "query",
                  "path",
                  "header"
                ]
              },
              "field": {
                "type": "string"
              },
              "code": {
                "type": "string"
              },
              "message": {
                "type": "string"
              }
            },
            "required": [
              "location",
              "field",
              "code",
              "message"
            ]
          }
        }
      },
      "required": [
        "code",
        "message"
      ]
    }
  },
  "required": [
    "error"
  ]
}

500 内部执行失败

application/json

{
  "type": "object",
  "properties": {
    "error": {
      "type": "object",
      "properties": {
        "code": {
          "type": "string"
        },
        "message": {
          "type": "string"
        },
        "issues": {
          "type": "array",
          "items": {
            "type": "object",
            "properties": {
              "location": {
                "type": "string",
                "enum": [
                  "body",
                  "query",
                  "path",
                  "header"
                ]
              },
              "field": {
                "type": "string"
              },
              "code": {
                "type": "string"
              },
              "message": {
                "type": "string"
              }
            },
            "required": [
              "location",
              "field",
              "code",
              "message"
            ]
          }
        }
      },
      "required": [
        "code",
        "message"
      ]
    }
  },
  "required": [
    "error"
  ]
}

502 请求校验或执行失败

application/json

{
  "type": "object",
  "properties": {
    "error": {
      "type": "object",
      "properties": {
        "code": {
          "type": "string"
        },
        "message": {
          "type": "string"
        },
        "issues": {
          "type": "array",
          "items": {
            "type": "object",
            "properties": {
              "location": {
                "type": "string",
                "enum": [
                  "body",
                  "query",
                  "path",
                  "header"
                ]
              },
              "field": {
                "type": "string"
              },
              "code": {
                "type": "string"
              },
              "message": {
                "type": "string"
              }
            },
            "required": [
              "location",
              "field",
              "code",
              "message"
            ]
          }
        }
      },
      "required": [
        "code",
        "message"
      ]
    }
  },
  "required": [
    "error"
  ]
}

503 请求校验或执行失败

application/json

{
  "type": "object",
  "properties": {
    "error": {
      "type": "object",
      "properties": {
        "code": {
          "type": "string"
        },
        "message": {
          "type": "string"
        },
        "issues": {
          "type": "array",
          "items": {
            "type": "object",
            "properties": {
              "location": {
                "type": "string",
                "enum": [
                  "body",
                  "query",
                  "path",
                  "header"
                ]
              },
              "field": {
                "type": "string"
              },
              "code": {
                "type": "string"
              },
              "message": {
                "type": "string"
              }
            },
            "required": [
              "location",
              "field",
              "code",
              "message"
            ]
          }
        }
      },
      "required": [
        "code",
        "message"
      ]
    }
  },
  "required": [
    "error"
  ]
}

504 请求校验或执行失败

application/json

{
  "type": "object",
  "properties": {
    "error": {
      "type": "object",
      "properties": {
        "code": {
          "type": "string"
        },
        "message": {
          "type": "string"
        },
        "issues": {
          "type": "array",
          "items": {
            "type": "object",
            "properties": {
              "location": {
                "type": "string",
                "enum": [
                  "body",
                  "query",
                  "path",
                  "header"
                ]
              },
              "field": {
                "type": "string"
              },
              "code": {
                "type": "string"
              },
              "message": {
                "type": "string"
              }
            },
            "required": [
              "location",
              "field",
              "code",
              "message"
            ]
          }
        }
      },
      "required": [
        "code",
        "message"
      ]
    }
  },
  "required": [
    "error"
  ]
}

响应示例

运行命令前，将环境变量 BASE_URL 设置为站点地址。

成功响应

curl --silent --show-error -H 'User-Agent: simpleWebUtils-example/1.1.0' -H 'Accept: application/json' "$BASE_URL"'/bing/info?mkt=zh-CN'

HTTP 200
content-type: application/json
content-encoding: gzip
cache-control: public, max-age=300

{
  "market": "zh-CN",
  "date": "2026-11-10",
  "endDate": "2026-11-11",
  "url": "https://www.bing.com/th?id=OHR.Atlantica_ZH-CN6593995386_UHD.jpg",
  "title": "奇妙纷呈的森林",
  "copyright": "大西洋森林，巴西 (© FG Trade/Getty Images)",
  "copyrightUrl": "https://www.bing.com/search?q=%E5%B7%B4%E8%A5%BF%E5%A4%A7%E8%A5%BF%E6%B4%8B%E6%A3%AE%E6%9E%97&form=hpcapt&mkt=zh-cn",
  "images": [
    {
      "resolution": "UHD",
      "width": 3840,
      "height": 2160,
      "url": "https://www.bing.com/th?id=OHR.Atlantica_ZH-CN6593995386_UHD.jpg"
    },
    {
      "resolution": "1920x1200",
      "width": 1920,
      "height": 1200,
      "url": "https://www.bing.com/th?id=OHR.Atlantica_ZH-CN6593995386_1920x1200.jpg"
    },
    {
      "resolution": "1920x1080",
      "width": 1920,
      "height": 1080,
      "url": "https://www.bing.com/th?id=OHR.Atlantica_ZH-CN6593995386_1920x1080.jpg"
    },
    {
      "resolution": "1080x1920",
      "width": 1080,
      "height": 1920,
      "url": "https://www.bing.com/th?id=OHR.Atlantica_ZH-CN6593995386_1080x1920.jpg"
    },
    {
      "resolution": "1366x768",
      "width": 1366,
      "height": 768,
      "url": "https://www.bing.com/th?id=OHR.Atlantica_ZH-CN6593995386_1366x768.jpg"
    },
    {
      "resolution": "1280x768",
      "width": 1280,
      "height": 768,
      "url": "https://www.bing.com/th?id=OHR.Atlantica_ZH-CN6593995386_1280x768.jpg"
    },
    {
      "resolution": "768x1280",
      "width": 768,
      "height": 1280,
      "url": "https://www.bing.com/th?id=OHR.Atlantica_ZH-CN6593995386_768x1280.jpg"
    },
    {
      "resolution": "720x1280",
      "width": 720,
      "height": 1280,
      "url": "https://www.bing.com/th?id=OHR.Atlantica_ZH-CN6593995386_720x1280.jpg"
    },
    {
      "resolution": "1024x768",
      "width": 1024,
      "height": 768,
      "url": "https://www.bing.com/th?id=OHR.Atlantica_ZH-CN6593995386_1024x768.jpg"
    },
    {
      "resolution": "800x600",
      "width": 800,
      "height": 600,
      "url": "https://www.bing.com/th?id=OHR.Atlantica_ZH-CN6593995386_800x600.jpg"
    },
    {
      "resolution": "800x480",
      "width": 800,
      "height": 480,
      "url": "https://www.bing.com/th?id=OHR.Atlantica_ZH-CN6593995386_800x480.jpg"
    },
    {
      "resolution": "480x800",
      "width": 480,
      "height": 800,
      "url": "https://www.bing.com/th?id=OHR.Atlantica_ZH-CN6593995386_480x800.jpg"
    },
    {
      "resolution": "640x480",
      "width": 640,
      "height": 480,
      "url": "https://www.bing.com/th?id=OHR.Atlantica_ZH-CN6593995386_640x480.jpg"
    },
    {
      "resolution": "400x240",
      "width": 400,
      "height": 240,
      "url": "https://www.bing.com/th?id=OHR.Atlantica_ZH-CN6593995386_400x240.jpg"
    },
    {
      "resolution": "320x240",
      "width": 320,
      "height": 240,
      "url": "https://www.bing.com/th?id=OHR.Atlantica_ZH-CN6593995386_320x240.jpg"
    },
    {
      "resolution": "240x320",
      "width": 240,
      "height": 320,
      "url": "https://www.bing.com/th?id=OHR.Atlantica_ZH-CN6593995386_240x320.jpg"
    }
  ],
  "updatedAt": "2026-11-11T00:29:19.808Z",
  "expiresAt": "2026-11-12T02:29:19.808Z"
}

错误示例

curl --silent --show-error -H 'User-Agent: simpleWebUtils-example/1.1.0' -H 'Accept: application/json' "$BASE_URL"'/bing/info?mkt=invalid+value'

HTTP 400
content-type: application/json
content-encoding: gzip
cache-control: no-store

{
  "error": {
    "code": "INVALID_INPUT",
    "message": "参数无效",
    "issues": [
      {
        "location": "query",
        "field": "mkt",
        "code": "invalid_value",
        "message": "允许值：zh-CN、en-US、ja-JP、en-IN、pt-BR、fr-FR、de-DE、en-CA、en-GB、it-IT、es-ES、fr-CA"
      }
    ]
  }
}

获取 Bing 日图信息

请求参数

响应

响应示例

成功响应

错误示例

在线调试

响应