開放通用Api，總有你喜歡的

API · 發表 2018-12-04 11:09:32

摘要：前言前段時間做了一個小外掛，需要呼叫一個查詢指定期號中獎號碼的Api介面，找了很多開放的介面，都不合我意，要麼限速，要麼收費，要麼進群。還可能不穩定，介面動不動就被改掉了，導致訪問失敗。遂罷。自己擼一個！首先實現的是給自己用的福彩相關的Api，推薦給...

前言

前段時間做了一個小外掛，需要呼叫一個查詢指定期號中獎號碼的Api介面，找了很多開放的介面，都不合我意，要麼限速，要麼收費，要麼進群。還可能不穩定，介面動不動就被改掉了，導致訪問失敗。遂罷。

自己擼一個！

首先實現的是給自己用的福彩相關的Api，推薦給朋友後試著還不錯，於是在朋友的推薦下新增了一些其他的api介面，為之購買了獨立的伺服器並部署了專案，目前域名正在備案中。

目標

我會堅持維護，也會積極響應朋友的號召，有好的意見也會積極採納並實施。更重要的是：介面不限速 ，不收費 ，不加群 ，但希望你不要頻繁請求，注意優化自己的邏輯，頻繁呼叫系統可能會禁用你的ip，導致你無法正常請求。更不要惡意攻擊，且行且珍惜。

說明

部落格中的Api文件是截止昨晚釋出的，不會實時更新，以後新增的Api介面以及詳細的文件說明都會在Github上進行，我會盡心維護，盡力寫好文件。當然在使用過程中有什麼問題或者建議，最好是在Github的issue中提出來或者直接聯絡我。您的star就是對我最大的鼓勵！

GIthub地址： ofollow,noindex">https://github.com/MZCretin/RollToolsApi

常用郵箱： [email protected]

常用QQ：792075058

介面文件

通用

HOST地址：http://119.27.186.22:8091
說明：所有的介面都會返回如下格式的資料，具體資料包裝在data中，需要根據狀態來確定請求是否成功。
請求方法：所有的請求都是GET請求
資料返回格式：

{
"code": 1,
"msg": "資料返回成功",
"data": null
}

資料返回格式說明（下面所有介面中的資料返回都是基於data的，不再介紹code和msg，請知悉）：
- code：狀態碼 1 返回成功 0 返回失敗此時，請關注msg錯誤資訊
- msg：提示資訊，當code返回0的時候包含錯誤提示資訊
- data：主要資訊，不同介面返回的東西不一樣

更新記錄

2018年11月27日23:14:49

介面列表

一、福彩-雙色球介面

指定期號中獎號碼

介面說明：獲取指定期號的雙色球獲獎號碼資訊
介面地址：[HOST]/lottery/ssq/aim_lottery?expect=2018135
引數說明：expect：彩票期號（七位）必傳
返回資料：
- openCode：本期中獎號碼
- code：彩票編號標識（雙色球是ssq）
- expect：彩票期號
- name：彩票名稱
- time：釋出時間
資料樣例：

{
"openCode": "10,12,15,25,26,27+14",
"code": "ssq",
"expect": "2018136",
"name": "雙色球",
"time": "2018-11-20 21:18:20"
}

獲取雙色球中獎資訊列表

介面說明：獲取最新雙色球中獎號碼資訊
介面地址：[HOST]/lottery/ssq/lottery_list?page=1
引數說明：page 頁號
返回資料：
- page：當前頁數
- totalCount：總數量
- totalPage：總頁數
- limit：每頁數量
- list：每頁具體資料
  - openCode：本期中獎號碼
  - code：彩票編號標識（雙色球是ssq）
  - expect：彩票期號
  - name：彩票名稱
  - time：釋出時間
資料樣例：

{
"page": 1,
"totalCount": 903,
"totalPage": 91,
"limit": 10,
"list": [
{
"openCode": "10,12,15,25,26,27+14",
"code": "ssq",
"expect": "2018136",
"name": "雙色球",
"time": "2018-11-20 21:18:20"
},
{
"openCode": "01,03,06,10,11,29+16",
"code": "ssq",
"expect": "2018135",
"name": "雙色球",
"time": "2018-11-18 21:18:20"
}
]
}

二、節假日及萬年曆

指定日期的節假日及萬年曆資訊

2018-11-26 18:07:28更新：節假日新增型別描述，比如【國慶,休息日,工作日】

介面說明：獲取指定日期的節假日及萬年曆資訊
介面地址：[HOST]/holiday/single/{date} 【例如： [HOST]/holiday/single/20181121】
引數說明：date 日期格式 yyyyMMdd
返回資料：
- date：當前日期
- weekDay：當前周第幾天 1-週一 2-週二 ... 7-週日
- yearTips：天干地支紀年法描述例如：戊戌
- type：型別 0 工作日 1 假日 2 節假日
- typeDes：型別描述比如國慶,休息日,工作日
- date：當前日期
- chineseZodiac：屬相例如：狗
- solarTerms：節氣描述例如：小雪
- lunarCalendar：農曆日期
- suit：宜事項
- dayOfYear：這一年的第幾天
- weekOfYear：這一年的第幾周
資料樣例：

{
"code": 1,
"msg": "資料返回成功",
"data": {
"date": "2018-11-25",
"weekDay": 7,
"yearTips": "戊戌",
"type": 1,
"chineseZodiac": "狗",
"solarTerms": "小雪後",
"typeDes" : "休息日",
"avoid": "移徙.入宅.安門.作樑.安葬",
"lunarCalendar": "10-18",
"suit": "祭祀.祈福.求嗣.齋醮.沐浴.冠笄.出行.理髮.拆卸.解除.起基.動土.定磉.安碓磑.開池.掘井.掃舍.除服.成服.移柩.啟攢.立碑.謝土",
"dayOfYear": 329,
"weekOfYear": 47
}
}

指定多個日期的節假日及萬年曆資訊

介面說明：獲取指定多個日期的節假日及萬年曆資訊
介面地址：[HOST]/holiday/multi/{dates} 【例如： [HOST]/holiday/multi/20180101,20181010,20181011】
引數說明：dates 日期組格式 yyyyMMdd,yyyyMMdd,yyyyMMdd （中間用英文逗號隔開）
返回資料：
- date：當前日期
- weekDay：當前周第幾天 1-週一 2-週二 ... 7-週日
- yearTips：天干地支紀年法描述例如：戊戌
- type：型別 0 工作日 1 假日 2 節假日
- typeDes：型別描述比如國慶,休息日,工作日
- date：當前日期
- chineseZodiac：屬相例如：狗
- solarTerms：節氣描述例如：小雪
- lunarCalendar：農曆日期
- suit：宜事項
- dayOfYear：這一年的第幾天
- weekOfYear：這一年的第幾周
資料樣例：

{
"code": 1,
"msg": "資料返回成功",
"data": [
{
"date": "2018-01-01",
"weekDay": 1,
"yearTips": "丁酉",
"type": 2,
"chineseZodiac": "雞",
"solarTerms": "冬至後",
"avoid": "出行.安葬.修墳.開市",
"lunarCalendar": "11-15",
"typeDes" : "元旦",
"suit": "祭祀.塑繪.開光.裁衣.冠笄.嫁娶.納采.拆卸.修造.動土.豎柱.上樑.安床.移徙.入宅.安香.結網.捕捉.畋獵.伐木.進人口.放水",
"dayOfYear": 1,
"weekOfYear": 1
},
{
"date": "2018-10-10",
"weekDay": 3,
"yearTips": "戊戌",
"type": 0,
"chineseZodiac": "狗",
"solarTerms": "寒露後",
"typeDes" : "工作日",
"avoid": "造廟.嫁娶.掘井.栽種.造橋.作灶.動土",
"lunarCalendar": "9-2",
"suit": "祭祀.開光.出行.解除.伐木.作樑.出火.拆卸.入宅.移徙.安床.修造.造畜椆棲.掃舍",
"dayOfYear": 283,
"weekOfYear": 41
},
{
"date": "2018-10-11",
"weekDay": 4,
"yearTips": "戊戌",
"type": 0,
"typeDes" : "工作日",
"chineseZodiac": "狗",
"solarTerms": "寒露後",
"avoid": "入宅.上樑.齋醮.出火.謝土",
"lunarCalendar": "9-3",
"suit": "納采.訂盟.開市.交易.立券.會親友.納畜.牧養.問名.移徙.解除.作廁.入學.起基.安床.開倉.出貨財.安葬.啟攢.入殮.除服.成服",
"dayOfYear": 284,
"weekOfYear": 41
}
]
}

指定月份所有的節假日及萬年曆資訊

介面說明：獲取指定月份的節假日及萬年曆資訊
介面地址：[HOST]/holiday/list/month/{date} 【例如： [HOST]/holiday/list/month/201802】
引數說明：date 查詢的月份格式 yyyyMM （只有年月）
返回資料：
- date：當前日期
- weekDay：當前周第幾天 1-週一 2-週二 ... 7-週日
- yearTips：天干地支紀年法描述例如：戊戌
- type：型別 0 工作日 1 假日 2 節假日
- typeDes：型別描述比如國慶,休息日,工作日
- date：當前日期
- chineseZodiac：屬相例如：狗
- solarTerms：節氣描述例如：小雪
- lunarCalendar：農曆日期
- suit：宜事項
- dayOfYear：這一年的第幾天
- weekOfYear：這一年的第幾周
資料樣例：

{

"code": 1,
"msg": "資料返回成功",
"data": [
{
"date": "2018-02-01",
"weekDay": 4,
"yearTips": "丁酉",
"type": 0,
"chineseZodiac": "雞",
"typeDes" : "工作日",
"solarTerms": "大寒後",
"avoid": "開倉.嫁娶.移徙.入宅",
"lunarCalendar": "12-16",
"suit": "祭祀.沐浴.祈福.齋醮.訂盟.納采.裁衣.拆卸.起基.豎柱.上樑.安床.入殮.除服.成服.移柩.啟攢.掛匾.求嗣.出行.合帳.造畜椆棲",
"dayOfYear": 32,
"weekOfYear": 5
},
...中間隱藏了"2018-02-02"~"2018-02-27"的資料
{
"date": "2018-02-28",
"weekDay": 3,
"yearTips": "戊戌",
"type": 0,
"chineseZodiac": "狗",
"typeDes" : "工作日",
"solarTerms": "雨水後",
"avoid": "掘井",
"lunarCalendar": "1-13",
"suit": "祭祀.齋醮.裁衣.合帳.冠笄.訂盟.納采.嫁娶.入宅.安香.謝土.入殮.移柩.破土.立碑.安香.會親友.出行.祈福.求嗣.立碑.上樑.放水",
"dayOfYear": 59,
"weekOfYear": 9
}
]

}

指定年份所有的節假日及萬年曆資訊

介面說明：獲取指定年份的節假日及萬年曆資訊
介面地址：[HOST]/holiday//list/year/{date} 【例如： [HOST]/holiday/list/year/2018】
引數說明：date 查詢的年份格式 yyyy （只有年份）
返回資料：
- date：當前日期
- weekDay：當前周第幾天 1-週一 2-週二 ... 7-週日
- yearTips：天干地支紀年法描述例如：戊戌
- type：型別 0 工作日 1 假日 2 節假日
- typeDes：型別描述比如國慶,休息日,工作日
- date：當前日期
- chineseZodiac：屬相例如：狗
- solarTerms：節氣描述例如：小雪
- lunarCalendar：農曆日期
- suit：宜事項
- dayOfYear：這一年的第幾天
- weekOfYear：這一年的第幾周
資料樣例：

{
"code": 1,
"msg": "資料返回成功",
"data": [
{
"month": 1,
"days": [
{
"date": "2018-01-01",
"weekDay": 1,
"yearTips": "丁酉",
"type": 2,
"chineseZodiac": "雞",
"solarTerms": "冬至後",
"typeDes" : "元旦",
"avoid": "出行.安葬.修墳.開市",
"lunarCalendar": "11-15",
"suit": "祭祀.塑繪.開光.裁衣.冠笄.嫁娶.納采.拆卸.修造.動土.豎柱.上樑.安床.移徙.入宅.安香.結網.捕捉.畋獵.伐木.進人口.放水",
"dayOfYear": 1,
"weekOfYear": 1
},
...中間隱藏了"2018-01-02"~"2018-01-30"的資料
{
"date": "2018-01-31",
"weekDay": 3,
"yearTips": "丁酉",
"type": 0,
"chineseZodiac": "雞",
"typeDes" : "工作日",
"solarTerms": "大寒後",
"avoid": "嫁娶.入殮.安葬.出行",
"lunarCalendar": "12-15",
"suit": "塑繪.開光.沐浴.冠笄.會親友.作灶.放水.造畜椆棲",
"dayOfYear": 31,
"weekOfYear": 5
}
]
},
...中間隱藏了02月到11月的資料
{
"month": 12,
"days": [
{
"date": "2018-12-01",
"weekDay": 6,
"yearTips": "戊戌",
"type": 1,
"chineseZodiac": "狗",
"typeDes" : "休息日",
"solarTerms": "小雪後",
"avoid": "作灶.治病",
"lunarCalendar": "10-24",
"suit": "祭祀.祈福.訂盟.納采.裁衣.拆卸.修造.動土.起基.安床.移徙.入宅.安香.入殮.移柩.安葬.謝土.赴任.進人口.會親友",
"dayOfYear": 335,
"weekOfYear": 48
},
...中間隱藏了"2018-12-02"~"2018-12-30"的資料
{
"date": "2018-12-31",
"weekDay": 1,
"yearTips": "戊戌",
"type": 0,
"chineseZodiac": "狗",
"solarTerms": "冬至後",
"avoid": "開市.破土",
"lunarCalendar": "10-25",
"suit": "祭祀.沐浴.安床.納財.畋獵.捕捉",
"dayOfYear": 365,
"weekOfYear": 1
}
]
}
]
}

三、全國城市列表（全國地級市API，資料來源國家統計局）

全國城市列表

介面說明：獲取全國城市列表資訊
介面地址：[HOST]/address/list
引數說明：無參
返回資料：
- code：省/市/區編號
- name：省/市/區名稱
- pchilds：市列表
- cchilds：區列表
資料樣例：

{
"code":1,
"msg":"資料返回成功",
"data":[
{
"code":"130000",
"name":"河北省",
"pchilds":[
{
"code":"130100",
"name":"石家莊市",
"cchilds":[
{
"code":"130101",
"name":"市轄區"
},
{
"code":"130102",
"name":"長安區"
},
...這裡只顯示了兩個區...
]
},
{
"code":"130200",
"name":"唐山市",
"cchilds":[
{
"code":"130201",
"name":"市轄區"
},
{
"code":"130202",
"name":"路南區"
},
...這裡只顯示了兩個區...
]
},
...這裡只顯示了兩個市...
]
}
...這裡只顯示了一個省...
]
}

搜尋全國城市列表

介面說明：搜尋全國城市列表資訊
介面地址：[HOST]/address/search 【例如： [HOST]/address/search?type=1&value=深圳】
引數說明：
- type：型別 0-查詢省份 1-查詢城市
- value：被查詢的省份或者城市名稱
返回資料：
- code：省/市/區編號
- name：省/市/區名稱
- pchilds：市列表
- cchilds：區列表
資料樣例：

{
"code": 1,
"msg": "資料返回成功",
"data": [
{
"code": "440000",
"name": "廣東省",
"pchilds": [
{
"code": "440300",
"name": "深圳市",
"cchilds": [
{
"code": "440301",
"name": "市轄區"
},
{
"code": "440303",
"name": "羅湖區"
},
...這裡只顯示了兩個區...
]
}
]
}
]
}

四、IP地址資訊

獲取訪問者的ip地址資訊

介面說明：獲取訪問者的ip地址資訊，先獲取您的ip地址，再進行解析
介面地址：[HOST]/ip/self
引數說明：無參
返回資料：
- ip：訪問者的ip地址
- province：省份
- provinceId：省份id
- city：城市
- cityId：城市id
- isp：網路服務商名稱例如電信
- desc：拼接好的描述資訊
資料樣例：

{
"code": 1,
"msg": "資料返回成功",
"data": {
"ip": "119.123.72.166",
"province": "廣東省",
"provinceId": 440000,
"city": "深圳市",
"cityId": 440300,
"isp": "電信",
"desc": "廣東省深圳市 電信"
}
}

獲取指定ip的ip地址資訊

介面說明：獲取指定ip的ip地址資訊
介面地址：[HOST]/ip/aim_ip?ip=? 【例如： [HOST]/ip/aim_ip?ip=119.123.72.166】
引數說明：ip 被查詢的ip地址需保證是正確的ip地址格式
返回資料：
- ip：訪問者的ip地址
- province：省份
- provinceId：省份id
- city：城市
- cityId：城市id
- isp：網路服務商名稱例如電信
- desc：拼接好的描述資訊
資料樣例：

{
"code": 1,
"msg": "資料返回成功",
"data": {
"ip": "119.123.72.166",
"province": "廣東省",
"provinceId": 440000,
"city": "深圳市",
"cityId": 440300,
"isp": "電信",
"desc": "廣東省深圳市 電信"
}
}

五、小工具

獲取不重複長ID

介面說明：獲取不重複長ID資訊
介面地址：[HOST]/tools/no_repeat_id/long
引數說明：無參
返回資料：
- id： 不重複16位字元id
資料樣例：

{
"code": 1,
"msg": "資料返回成功",
"data": {
"id": "8a2a789976e64a1c9455ebd90853d4c6"
}
}

獲取不重複短ID

介面說明：獲取不重複短ID資訊
介面地址：[HOST]/tools/no_repeat_id/short
引數說明：無參
返回資料：
- id： 不重複8位字元id
資料樣例：

{
"code": 1,
"msg": "資料返回成功",
"data": {
"id": "jlazntmtjrvcrpnb"
}
}

六、天氣資訊

獲取特定城市今日天氣

介面說明：獲取特定城市今日天氣資訊
介面地址：[HOST]/weather/current/{城市名} 【例如： [HOST]/weather/current/深圳市】
引數說明：{城市名} 傳入你需要查詢的城市，請儘量傳入完整值，否則系統會自行匹配，可能會有誤差
返回資料：
- address：城市具體資訊，比如 “廣東省深圳市”
- cityCode：城市code
- temp：溫度值
- weather：天氣描述
- windDirection：風向描述
- windPower：風力描述
- humidity：溼度值
- reportTime：此次天氣釋出時間
資料樣例：

{
"code": 1,
"msg": "資料返回成功",
"data": {
"address": "廣東省 深圳市",
"cityCode": "440300",
"temp": "18℃",
"weather": "小雨",
"windDirection": "東北",
"windPower": "≤3級",
"humidity": "92%",
"reportTime": "2018-11-27 22:40:53"
}
}

獲取特定城市今天及未來天氣

介面說明：獲取特定城市今天及未來天氣資訊
介面地址：[HOST]/weather/forecast/{城市名} 【例如： [HOST]/weather/forecast/深圳市】
引數說明：{城市名} 傳入你需要查詢的城市，請儘量傳入完整值，否則系統會自行匹配，可能會有誤差
返回資料：
- address：城市具體資訊，比如 “廣東省深圳市”
- cityCode：城市code
- reportTime：此次天氣釋出時間
- forecasts：今天及未來天氣列表
  - date：日期
  - dayOfWeek：星期
  - dayWeather：白天天氣描述
  - nightWeather：晚上天氣描述
  - dayTemp：白天溫度
  - nightTemp：晚上溫度
  - dayWindDirection：白天風向
  - nightWindDirection：晚上風向
  - dayWindPower：白天風力
  - nightWindPower：晚上風力
資料樣例：

{
"code": 1,
"msg": "資料返回成功",
"data": {
"address": "廣東省 深圳市",
"cityCode": "440300",
"reportTime": "2018-11-27 22:40:53",
"forecasts": [
{
"date": "2018-11-27",
"dayOfWeek": "2",
"dayWeather": "陣雨",
"nightWeather": "小雨",
"dayTemp": "22℃",
"nightTemp": "17℃",
"dayWindDirection": "無風向",
"nightWindDirection": "無風向",
"dayWindPower": "≤3級",
"nightWindPower": "≤3級"
},
...這裡只顯示了一條資料...
]
}
}

七、笑話段子

分頁獲取笑話段子列表

特別說明：此介面的資料來源是我的另外一個產品【段子樂】，目前Android客戶端已經在各大應用市場上架，定期更新資料到此服務。本服務目前只開放純文字段子，後期看情況開放搞笑短視訊和搞笑圖片的介面。
介面說明：分頁獲取笑話段子列表
介面地址：[HOST/jokes/list 【例如： [HOST]/jokes/list?page=1】
引數說明：page 分頁
返回資料：
- page：當前頁數
- totalCount：總數量
- totalPage：總頁數
- limit：每頁數量
- list：每頁具體資料
  - content：段子內容
  - updateTime：更新時間
資料樣例：

{
"code": 1,
"msg": "資料返回成功",
"data": {
"page": 2,
"totalCount": 9590,
"totalPage": 959,
"limit": 10,
"list": [
{
"content": "兒子:“爸爸，為什麼王叔叔那麼喜歡吃辣”爸爸:“你怎麼知道王叔叔喜歡吃辣？”兒子:“別人都叫我媽媽為辣媽，我經常看到王叔叔抱著我媽媽又親又啃”爸爸:“尼瑪”",
"updateTime": "2018-11-03 09:45:28"
},
...這裡只顯示了一條資料...
]
}
}

關於我的

我就是比較喜歡用程式碼解決生活中的問題，感覺很開心，哈哈哈。也希望大家關注我的簡書，掘金，Github和CSDN。

簡書首頁，連結是https://www.jianshu.com/u/123f97613b86

掘金首頁，連結是https://juejin.im/user/5838d57fac502e006c1708bc

Github首頁，連結是https://github.com/MZCretin

CSDN首頁，連結是http://blog.csdn.net/u010998327

我是Cretin，一個可愛的小男孩。

開放通用Api，總有你喜歡的

前言

目標

說明

介面文件

目錄

通用

資料返回格式：

資料返回格式說明（下面所有介面中的資料返回都是基於data的，不再介紹code和msg，請知悉）：

更新記錄

2018年11月27日23:14:49

介面列表

一、福彩-雙色球介面

指定期號中獎號碼

返回資料：

資料樣例：

最新中獎號碼資訊

引數說明： 無

返回資料：

資料樣例：

獲取雙色球中獎資訊列表

返回資料：

totalCount： 總數量

totalPage： 總頁數

資料樣例：

二、節假日及萬年曆

指定日期的節假日及萬年曆資訊

返回資料：

suit： 宜事項

資料樣例：

指定多個日期的節假日及萬年曆資訊

返回資料：

suit： 宜事項

資料樣例：

指定月份所有的節假日及萬年曆資訊

返回資料：

suit： 宜事項

資料樣例：

指定年份所有的節假日及萬年曆資訊

返回資料：

suit： 宜事項

資料樣例：

三、全國城市列表（全國地級市API，資料來源國家統計局）

全國城市列表

引數說明： 無參

返回資料：

pchilds： 市列表

cchilds： 區列表

資料樣例：

搜尋全國城市列表

引數說明：

返回資料：

pchilds： 市列表

cchilds： 區列表

資料樣例：

四、IP地址資訊

獲取訪問者的ip地址資訊

引數說明： 無參

返回資料：

province： 省份

city： 城市

資料樣例：

獲取指定ip的ip地址資訊

返回資料：

province： 省份

city： 城市

資料樣例：

五、小工具

獲取不重複長ID

引數說明： 無參

返回資料：

資料樣例：

獲取不重複短ID

引數說明： 無參

返回資料：

資料樣例：

六、天氣資訊

獲取特定城市今日天氣

返回資料：

temp： 溫度值

引數說明：無

totalCount：總數量

totalPage：總頁數

suit：宜事項

suit：宜事項

suit：宜事項

suit：宜事項

引數說明：無參

pchilds：市列表

cchilds：區列表

pchilds：市列表

cchilds：區列表

引數說明：無參

province：省份

city：城市

province：省份

city：城市

引數說明：無參

引數說明：無參

temp：溫度值

humidity：溼度值

date：日期

dayOfWeek：星期

totalCount：總數量

totalPage：總頁數