扇貝-每日一句

【原文鏈接】：https://blog.tecchen.xyz ，博文同步發布到博客園。
由於精力有限，對文章的更新可能不能及時同步，請點擊上面的原文鏈接訪問最新內容。
歡迎訪問我的個人網站：https://www.tecchen.xyz 。

前言

偶然看到某個小伙伴的博客（https://alili.tech/ ）有查詢扇貝的每日一句，加上打字效果，讓我感覺很新奇。所以扒了下扇貝的每日一句接口，放到自己的服務器上，后續集成到自己的博客里面。
API共分為幾個接口，

• 第一個接口是直接獲取當天的每日一句，返回的字段較多，有些字段並未標注什么含義，也沒有什么作用；
• 第二個接口是查詢歷史的每日一句，因為本服務是從2019-01-12開始提供的，所以歷史的數據是比較簡單的結構。當然2019-01-12開始的每日一句都保存了下來，再查詢就和第一種接口的數據是一致的了。
• 第三個接口是隨機查詢歷史的每日一句。

你也可以通過Spring Cloud進行調用，我使用程序員DD的注冊中心：http://eureka.didispace.com/
應用名稱：QUOTE-API

使用中存在任何問題，可通過郵箱[e-mail]聯系我~（ 如果侵權，請聯系我刪除 ）

另外還有個天氣預報的API（應用名稱：WEATHER-API）還在開發中，敬請關注~

接口文檔

每日一句

• 請求地址

http://api.tecchen.xyz/api/quote/

• 請求方式

GET

• 請求參數示例

無

• 請求參數說明

無

• 返回參數示例

{
	"code": 0,
	"message": "成功",
	"data": {
		"id": "ihscc",
		"author": "Juvenal",
		"content": "Never does nature say one thing and wisdom another.",
		"assignDate": "2019-01-19",
		"adUrl": "https://h10.shanbay.com/s/track?st=s&url=https%3A%2F%2Fwww.shanbay.com%2Fweb%2Fplan365%2F&ct=transformer&x_data=%7B%22_%22%3A+%228d58fd%22%7D&x_cdata=%7B%22campaign_code%22%3A+%22kc98hu5tv%22%7D",
		"shareUrl": "https://www.shanbay.com/soup/mobile/quote/2019-01-19/",
		"shareUrls": {
			"weibo": "https://www.shanbay.com/soup/mobile/quote/2019-01-19/",
			"shanbay": "https://www.shanbay.com/soup/mobile/quote/2019-01-19/",
			"wechat": "https://www.shanbay.com/soup/mobile/quote/2019-01-19/",
			"qzone": "https://www.shanbay.com/soup/mobile/quote/2019-01-19/",
			"wechat_user": "https://www.shanbay.com/soup/mobile/quote/2019-01-19/"
		},
		"trackObject": {
			"code": "abb22",
			"share_url": "https://www.shanbay.com/soup/mobile/quote/2019-01-19/",
			"object_id": 2485
		},
		"translation": "自然與智慧永不相悖。",
		"originImgUrls": [
			"https://media-image1.baydn.com/soup_pub_image/ccdbwr/fd3e0cb49ece0faeab0ec1126dab342f.aaf209e859f6598d50ec3d3593e6596b.png@!fhd_webp",
			"https://media-image1.qiniu.baydn.com/soup_pub_image/ccdbwr/fd3e0cb49ece0faeab0ec1126dab342f.aaf209e859f6598d50ec3d3593e6596b.png?imageView2/2/w/1080/format/webp"
		],
		"shareImgUrls": [
			"https://media-image1.baydn.com/soup_pub_image/ccdbwr/61fcabc6631b1deac4804fcb84739ba2.3a1761e8ed5c49723ee6040d390fe416.png@!w720",
			"https://media-image1.qiniu.baydn.com/soup_pub_image/ccdbwr/61fcabc6631b1deac4804fcb84739ba2.3a1761e8ed5c49723ee6040d390fe416.png?imageView2/2/w/720/"
		]
	}
}

• 返回參數說明

參數名稱	類型	說明	備注
author	string	作者/出處
content	string	摘錄
assignDate	string	日期
translation	string	翻譯
originImgUrls	Array	原始圖片鏈接	不包含摘錄
shareImgUrls	Array	分享圖片鏈接	包含摘錄

扇貝- 歷史 - 每日一句

獲取指定日期（格式：yyyy-MM-dd）的每日一句

• 請求地址

http://api.tecchen.xyz/api/quote/{requestDate}/

• 請求方式

GET

• 請求參數示例

http://api.tecchen.xyz/api/quote/2019-11-11/

• 請求參數說明

參數名稱	類型	說明	備注
requestDate	string	日期	格式：yyyy-MM-dd

• 返回參數示例

{
	"code": 0,
	"message": "成功",
	"data": {
		"id": null,
		"author": "約翰·梅納德·凱恩斯",
		"content": "Ideas shape the course of history.",
		"assignDate": "2019-01-11",
		"adUrl": null,
		"shareUrl": null,
		"shareUrls": null,
		"trackObject": null,
		"translation": "想法影響着歷史進程。",
		"originImgUrls": [
			"https://media-image1.baydn.com/soup_pub_image/ccdbwr/312d1addd474109097d8be4ceaf44d4c.88972797e32da926072b61a867ea17eb.png?x-oss-process=image/format,jpg"
		],
		"shareImgUrls": null
	}
}

• 返回參數說明

參數名稱	類型	說明	備注
author	string	作者/出處
content	string	摘錄
assignDate	string	日期
translation	string	翻譯
originImgUrls	Array	原始圖片鏈接	不包含摘錄

隨機獲取一句歷史的每日一句

隨機獲取一句歷史的每日一句，可以用於博客首頁，每次訪問，內容都會變化，更吸引讀者。

• 請求地址

http://api.tecchen.xyz/api/quote/history/random/

• 請求方式

GET

• 請求參數示例

無

• 請求參數說明

無

• 返回參數示例

{
	"code": 0,
	"message": "成功",
	"data": {
		"id": null,
		"author": "Baltasar Gracian",
		"content": "A wise man gets more use from his enemies than a fool from his friends.",
		"assignDate": "2017-11-14",
		"adUrl": null,
		"shareUrl": null,
		"shareUrls": null,
		"trackObject": null,
		"translation": "智者從敵人身上學到的，多過愚者從朋友身上學到的。",
		"originImgUrls": [
			"https://media-image1.baydn.com/soup_pub_image/qqnjfi/e50a1650c2a23de9526d8d6c4c30cf46.f707e8b26a5e5baa5b1cd32858ded05b.png?x-oss-process=image/format,jpg"
		],
		"shareImgUrls": null
	}
}

• 返回參數說明

參數名稱	類型	說明	備注
author	string	作者/出處
content	string	摘錄
assignDate	string	日期
translation	string	翻譯
originImgUrls	Array	原始圖片鏈接	不包含摘錄

HTTPS接口

以上接口均支持HTTPS方式請求，請求地址為https://www.tecchen.xyz/api/~，只需要將HTTP改為HTTPS，將api改為www即可。

小彩蛋

瀏覽器訪問https://api.tecchen.xyz/quote.html發現小精彩哦～～～

通用的返回報文格式

參數名稱	類型	說明	備注
code	int	編碼	0:成功; 400:參數非法; 500:服務器錯誤;其他:請根據message確認 不是HTTP的請求狀態碼
message	string	成功／錯誤信息
data	object	數據	以json格式返回

更新記錄

v1.0.0

2019-01-13

• 扇貝每日一句
• 支持歷史的每日一句
• 彩蛋頁面

v1.0.1

2019-01-19

• 優化返回的json
• 優化定時任務獲取日志邏輯
• 支持HTTPS
• 隨機獲取一句歷史的每日一句

v1.0.2

2019-02-18

• 接入Spring cloud gateway
• 靜態頁面和動態請求分離
• 修復因框架升級造成的亂碼問題
• 調整小彩蛋體驗路徑，優化移動端圖片顯示

未完待續……
持續更新……
感謝支持與打賞