Golang实现获取Bing的每日一图

实现方法来自：利用Api获取必应的每日一图

接口分析

主要api是：

https://www.bing.com/HPImageArchive.aspx?format=js&idx=0&n=1

响应体如下：

{
    "images": [
        {
            "startdate": "20240229",
            "fullstartdate": "202402291600",
            "enddate": "20240301",
            "url": "/th?id=OHR.Schmetterlingswiese_ZH-CN3740804088_1920x1080.jpg&rf=LaDigue_1920x1080.jpg&pid=hp",
            "urlbase": "/th?id=OHR.Schmetterlingswiese_ZH-CN3740804088",
            "copyright": "德国草地上的蝴蝶 (© Albert Fertl/Getty Images)",
            "copyrightlink": "https://www.bing.com/search?q=%E8%9D%B4%E8%9D%B6&form=hpcapt&mkt=zh-cn",
            "title": "蝶舞翩跹",
            "quiz": "/search?q=Bing+homepage+quiz&filters=WQOskey:%22HPQuiz_20240229_Schmetterlingswiese%22&FORM=HPQUIZ",
            "wp": true,
            "hsh": "00894a0ae6a40ff698e21ce2afdd33eb",
            "drk": 1,
            "top": 1,
            "bot": 1,
            "hs": []
        }
    ],
    "tooltips": {
        "loading": "正在加载...",
        "previous": "上一个图像",
        "next": "下一个图像",
        "walle": "此图片不能下载用作壁纸。",
        "walls": "下载今日美图。仅限用作桌面壁纸。"
    }
}

主要业务逻辑实现

package service

import (
	"encoding/json"
	"io"
	"log"
	"net/http"
	"time"
)

// from page :https://cloud.tencent.com/developer/article/2086721
type BingImage struct {
	Bot           int    `json:"bot"`
	Copyright     string `json:"copyright"`
	CopyrightLink string `json:"copyrightlink"`
	Drk           int    `json:"drk"`
	EndDate       string `json:"enddate"`
	FullStartDate string `json:"fullstartdate"`
	Hs            []int  `json:"hs"`
	Hsh           string `json:"hsh"`
	Quiz          string `json:"quiz"`
	StartDate     string `json:"startdate"`
	Title         string `json:"title"`
	Top           int    `json:"top"`
	Url           string `json:"url"`
	UrlBase       string `json:"urlbase"`
	Wp            bool   `json:"wp"`
}

type BingToolTips struct {
	Loading  string `json:"loading"`
	Next     string `json:"next"`
	Previous string `json:"previous"`
	WallE    string `json:"walle"`
	WallS    string `json:"walls"`
}

type BingResponse struct {
	Images   []BingImage  `json:"images"`
	Tooltips BingToolTips `json:"tooltips"`
}

type Picture struct {
	Title     string `json:"title"`
	URL       string `json:"url"`
	Copyright string `json:"copyright"`
}

var picture *Picture
var lastTime time.Time

func GetPicture() *Picture {
	if picture != nil && isToday(lastTime) {
		return picture
	}
	lastTime = time.Now()
	picture = getNewPicture()
	return picture
}

func isToday(t time.Time) bool {
	now := time.Now() // 获取当前时间
	return t.Year() == now.Year() && t.Month() == now.Month() && t.Day() == now.Day()
}

func getNewPicture() *Picture {
	resp, err := http.Get("https://www.bing.com/HPImageArchive.aspx?format=js&idx=0&n=1")
	if err != nil {
		log.Fatal(err)
	}

	defer func(Body io.ReadCloser) {
		err := Body.Close()
		if err != nil {
			log.Fatal(err)
		}
	}(resp.Body)
	body, err := io.ReadAll(resp.Body)
	if err != nil {
		log.Fatal(err)
	}

	response := BingResponse{}
	err = json.Unmarshal(body, &response)
	if err != nil {
		log.Fatal(err)
	}

	if len(response.Images) > 0 {
		image := response.Images[0]
		return &Picture{
			Title:     image.Title,
			Copyright: image.Copyright,
			URL:       "https://www.bing.com" + image.Url,
		}
	}

	return nil
}

说明：

1. 结构体的属性名首字母均为大写，因为涉及到Json的序列化，首字母小写在Golang中意味着“私有”，私有的属性无法完成序列化。
2. picture声明为指针类型，主要是保证全局只存在一份数据，也方便做缓存

对外暴露接口

r.GET("/image", func(context *gin.Context) {
		context.PureJSON(200, service.GetPicture())
	})

说明：

1. 这个地方使用的是 context.PureJson() ,其主要原因是 context.Json()会对参数中的特殊字符进行转义，接口中的&字符转义后图片地址将无法正常访问。而PureJson()则可原封不动的将数据返回。