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

Roll圈圈發表於2018-12-04

前言

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

自己擼一個！

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

目標

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

說明

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

GIthub地址：github.com/MZCretin/Ro…

常用郵箱：mxnzp_life@163.com

常用QQ：792075058

個人站點主頁：www.mxnzp.com

介面文件

通用

HOST地址： www.mxnzp.com/api
說明： 所有的介面都會返回如下格式的資料，具體資料包裝在data中，需要根據狀態來確定請求是否成功。
請求方法： 所有的請求中都是大部分都是GET請求（如果有特殊情況，則會特殊標明）

資料返回格式：

{
    "code": 1,
    "msg": "資料返回成功",
    "data": null
}
複製程式碼

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

更新記錄

2019年01月09日20:16:38

新增生成隨機驗證碼的介面，可以生成任意長度的驗證碼圖片，檢視說明；段子介面新增隨機段子列表，可以獲取隨機段子，檢視說明。

2018年12月14日15:02:00

新增生成二維碼的介面，可生成指定大小，指定內容的二位麼，也可生成帶logo的二維碼。檢視說明

2018年12月10日22:54:46

節假日及萬年曆介面新增新的介面，新增查詢指定型別的節假日資訊列表，比如節日，休息日，工作日檢視說明和檢視說明

2018年12月07日09:20:07

新增正式域名，可用正式域名訪問檢視說明

2018年12月01日22:49:42

新增笑話段子的api介面檢視說明

2018年11月27日23:14:49

新增天氣查詢的api介面檢視說明

介面列表

一、福彩-雙色球介面

指定期號中獎號碼

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

資料樣例：

{
    "openCode": "01,03,06,10,11,29+16",
    "code": "ssq",
    "expect": "2018135",
    "name": "雙色球",
    "time": "2018-11-18 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： 型別描述比如國慶,休息日,工作日
- 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： 型別描述比如國慶,休息日,工作日
- 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： 型別描述比如國慶,休息日,工作日
- 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/month/{date}/{type} 【例如： [HOST]/holiday/list/month/201810/rest】
引數說明： date 查詢的月份格式 yyyyMM （只有年月），type 需要查詢的型別{可選值：型別 workday 工作日 holiday 節假日 rest 休息日 festival 節日}
返回資料：
- month： 當前月份
- year： 當前年份
  - date： 當前日期
  - weekDay： 當前周第幾天 1-週一 2-週二 ... 7-週日
  - yearTips： 天干地支紀年法描述例如：戊戌
  - type： 型別 0 工作日 1 假日 2 節假日
  - typeDes： 型別描述比如國慶,休息日,工作日
  - chineseZodiac： 屬相例如：狗
  - solarTerms： 節氣描述例如：小雪
  - lunarCalendar： 農曆日期
  - suit： 宜事項
  - dayOfYear： 這一年的第幾天
  - weekOfYear： 這一年的第幾周

資料樣例

{
    "code": 1,
    "msg": "資料返回成功",
    "data": [
        {
            "month": 10,
            "year": 2018,
            "days": [
                {
                    "date": "2018-10-13",
                    "weekDay": 6,
                    "yearTips": "戊戌",
                    "type": 1,
                    "typeDes": "休息日",
                    "chineseZodiac": "狗",
                    "solarTerms": "寒露後",
                    "avoid": "開市.交易.祭祀.入宅.安葬",
                    "lunarCalendar": "九月初五",
                    "suit": "捕捉.畋獵.餘事勿取",
                    "dayOfYear": 286,
                    "weekOfYear": 41
                },
                ...中間隱藏了一部分的資料...
                {
                    "date": "2018-10-28",
                    "weekDay": 7,
                    "yearTips": "戊戌",
                    "type": 1,
                    "typeDes": "休息日",
                    "chineseZodiac": "狗",
                    "solarTerms": "霜降後",
                    "avoid": "出行.祈福.安葬.作灶",
                    "lunarCalendar": "九月廿",
                    "suit": "會親友.嫁娶.訂盟.納采.納婿.拆卸.修造.動土.起基.豎柱.上樑.安床.會親友.納財",
                    "dayOfYear": 301,
                    "weekOfYear": 43
                }
            ]
        }
    ]
}
複製程式碼

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

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

資料樣例：

{
    "code": 1,
    "msg": "資料返回成功",
    "data": [
        {
            "month": 1,
            "year": 2018,
            "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
                }
            ]
        }
    ]
}
複製程式碼

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

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

資料樣例

{
    "code": 1,
    "msg": "資料返回成功，域名已經成功備案，為了更優雅的呼叫，不久後將廢棄8091埠，請儘快使用新域名直接呼叫，多有不便敬請諒解",
    "data": [
        {
            "month": 1,
            "year": 2018,
            "days": [
                {
                    "date": "2018-01-06",
                    "weekDay": 6,
                    "yearTips": "丁酉",
                    "type": 1,
                    "typeDes": "休息日",
                    "chineseZodiac": "雞",
                    "solarTerms": "小寒後",
                    "avoid": "嫁娶.開市.入宅.安床.破土.安葬",
                    "lunarCalendar": "冬月廿",
                    "suit": "祭祀.齋醮.納財.捕捉.畋獵",
                    "dayOfYear": 6,
                    "weekOfYear": 1
                },
                ...中間還有一些資料沒有顯示...
                {
                    "date": "2018-01-28",
                    "weekDay": 7,
                    "yearTips": "丁酉",
                    "type": 1,
                    "typeDes": "休息日",
                    "chineseZodiac": "雞",
                    "solarTerms": "大寒後",
                    "avoid": "祈福.嫁娶.造廟.安床.謝土",
                    "lunarCalendar": "臘月十二",
                    "suit": "納采.訂盟.祭祀.求嗣.出火.塑繪.裁衣.會親友.入學.拆卸.掃舍.造倉.掛匾.掘井.開池.結網.栽種.納畜.破土.修墳.立碑.安葬.入殮",
                    "dayOfYear": 28,
                    "weekOfYear": 4
                }
            ]
        },
        ...中間有2月到11月的資料沒有展示...
        {
            "month": 12,
            "year": 2018,
            "days": [
                {
                    "date": "2018-12-01",
                    "weekDay": 6,
                    "yearTips": "戊戌",
                    "type": 1,
                    "typeDes": "休息日",
                    "chineseZodiac": "狗",
                    "solarTerms": "小雪後",
                    "avoid": "作灶.治病",
                    "lunarCalendar": "十月廿四",
                    "suit": "祭祀.祈福.訂盟.納采.裁衣.拆卸.修造.動土.起基.安床.移徙.入宅.安香.入殮.移柩.安葬.謝土.赴任.進人口.會親友",
                    "dayOfYear": 335,
                    "weekOfYear": 48
                },
                ...中間還有一些資料沒有顯示...
                {
                    "date": "2018-12-30",
                    "weekDay": 7,
                    "yearTips": "戊戌",
                    "type": 1,
                    "typeDes": "元旦",
                    "chineseZodiac": "狗",
                    "solarTerms": "冬至後",
                    "avoid": null,
                    "lunarCalendar": "冬月廿四",
                    "suit": "塑繪.齋醮.出行.拆卸.解除.修造.移徙.造船.入殮.除服.成服.移柩.啟攢.修墳.立碑.謝土",
                    "dayOfYear": 364,
                    "weekOfYear": 52
                }
            ]
        }
    ]
}
複製程式碼

三、全國城市列表（全國地級市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"
            },
            ...這裡只顯示了一條資料...
        ]
    }
}
複製程式碼

隨機獲取笑話段子列表

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

資料樣例：

{
    "code": 1,
    "msg": "資料返回成功",
    "data": [
        {
            "content": "朋友問我，如果在這個時代做個普通人，你最想做什麼樣的。我說，我想做個皇城根底下的社會閒散人員，好吃懶做，遊手好閒，靠著祖上的餘蔭收點租子過日子。",
            "updateTime": "2018-04-30 13:45:44"
        },
        ...這裡只顯示了一條資料...
    ]
}
複製程式碼

八、生成二維碼

生成單一二維碼

介面說明： 根據傳入的內容生成二維碼，可以選擇獲取二維碼下載連結，也可以直接獲取圖片的Base64字串自己解析（注：Base64字串前面預設新增了“data:image/jpg;base64,”，取值的時候請根據需要對這個內容進行處理）。
介面地址： [HOST]/qrcode/create/single 【例如： [HOST]/qrcode/create/single?content=你好&size=500&type=0】
引數說明： content：生成二維碼的內容 size：生成二維碼的大小（不傳預設為500）type：你希望返回二維碼的型別：（0=下載連結 1=base64字串）
返回資料：
- qrCodeUrl： 如果type=0 則此引數會有值，且此值會返回二維碼的下載連結
- content： 此二維碼所代表的內容
- type： 生成的二維碼的輸出方式（0=下載連結 1=base64字串）
- qrCodeBase64： 如果type=1 則此引數會有值，且此值會返回二維碼的base64字串（注：Base64字串前面預設新增了“data:image/jpg;base64,”，取值的時候請根據需要對這個內容進行處理）

資料樣例：

{
    "code": 1,
    "msg": "資料返回成功",
    "data": {
        "qrCodeUrl": "http://www.mxnzp.com/api_file/qrcode/7/2/d/d/0/9/a/e/327588b1ddb44cf7a95e43d7ad2f5b90.png",
        "content": "你好",
        "type": 0,
        "qrCodeBase64": null
    }
}
複製程式碼

生成帶logo二維碼

介面說明： 根據傳入的內容生成帶logo的二維碼，可以選擇獲取二維碼下載連結，也可以直接獲取圖片的Base64字串自己解析（注：Base64字串前面預設新增了“data:image/jpg;base64,”，取值的時候請根據需要對這個內容進行處理）。
請求方法： POST
介面地址： [HOST]/qrcode/create/logo 【例如： [HOST]/qrcode/create/logo?content=你好&size=600&logo_size=500&type=0&logo_img=logo圖片】
引數說明： content：生成二維碼的內容 size：生成二維碼的大小（不傳預設為500）type：你希望返回二維碼的型別：（0=下載連結 1=base64字串） logo_size：logo的大小（不傳預設為而二維碼大小的1/5）logo_img：嵌入在二維碼中的logo圖片檔案，使用post請求上傳至伺服器
返回資料：
- qrCodeUrl： 如果type=0 則此引數會有值，且此值會返回二維碼的下載連結
- content： 此二維碼所代表的內容
- type： 生成的二維碼的輸出方式（0=下載連結 1=base64字串）
- qrCodeBase64： 如果type=1 則此引數會有值，且此值會返回二維碼的base64字串（注：Base64字串前面預設新增了“data:image/jpg;base64,”，取值的時候請根據需要對這個內容進行處理）

資料樣例：

{
    "code": 1,
    "msg": "資料返回成功",
    "data": {
        "qrCodeUrl": "http://127.0.0.1:8080/api_file/qrcode/d/8/f/7/3/a/1/8/ff1ea758421647ca9f96136f6298aac8.png",
        "content": "你好",
        "type": 0,
        "qrCodeBase64": null
    }
}
複製程式碼

九、生成隨機圖片驗證碼

生成隨機圖片驗證碼

介面說明： 生成隨機長度的圖片驗證碼。
介面地址： [HOST]/verifycode/code 【例如： [HOST]/verifycode/code?len=5&type=0】
引數說明： len：生成驗證碼的長度，不傳預設5位，type=0：返回型別，0-生成圖片的地址連結 1-生成驗證碼圖片的base64字串（注：Base64字串前面預設新增了“data:image/jpg;base64,”，取值的時候請根據需要對這個內容進行處理）
返回資料：
- verifyCode： 圖片對應的驗證碼的值
- verifyCodeImgUrl： 如果type=0 則此引數會有值，且此值會返回驗證碼的下載連結
- verifyCodeBase64： 如果type=1 則此引數會有值，且此值會返回驗證碼的base64字串（注：Base64字串前面預設新增了“data:image/jpg;base64,”，取值的時候請根據需要對這個內容進行處理）
- whRatio： 驗證碼圖片大小的寬高比

返回資料：

{
    "code": 1,
    "msg": "資料返回成功",
    "data": {
        "verifyCode": "jcyJG",
        "verifyCodeImgUrl": "http://127.0.0.1:8080/api_file/varitycode/a/6/d/a/9/8/c/2/592da008c864486396b9a2a68110d05e.jpg",
        "verifyCodeBase64": null,
        "whRatio": "225,80"
    }
}
複製程式碼

關於我的

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

簡書首頁，連結是 www.jianshu.com/u/123f97613…

掘金首頁，連結是 juejin.im/user/5838d5…

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

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

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

程式設計字型小彙總，總會有你喜歡的那一款！
2015-06-18
程式設計
程式設計師不喜歡開放式辦公室
2014-07-01
程式設計師
你有什麼喜歡的 Linux 終端技巧？
2020-01-25
Linux
你知道開發人員最喜歡的Chrome擴充套件有哪些嗎？
2019-05-11
Chrome套件
8月釋出的手機大全 10款新手機總有一款你會喜歡
2017-09-05
你真的喜歡技術嗎？
2015-01-26
你最喜歡的遊戲體驗背後有何祕密力量
2020-03-12
遊戲
老外最不喜歡的開發信型別，你中了幾個？
2023-02-11
型別
軟體工程師，你真的喜歡你的工作嗎？
2011-05-17
軟體工程工程師
各位程式設計師，你真的喜歡你的工作嗎？
2014-06-12
程式設計師
如何讓使用者喜歡你的網站？
2020-04-16
網站
如何在 GitHub 上支援你喜歡的專案
2020-10-06
Github
喜歡賭球的你，可能被AI盯上了
2018-05-01
AI
Google為什麼砍掉了你喜歡的功能
2014-07-31
Go
從喜歡到放棄CMS(內容管理系統)
2021-06-15
抖音批量取消喜歡,批量取消抖音喜歡
2020-12-12
如果你不喜歡瀏覽器的書籤欄
2019-04-08
瀏覽器
你喜歡玩老遊戲，不是沒有理由的
2019-05-14
遊戲
Git 十四週年：你喜歡 Git 的哪一點？
2019-04-23
Git
從GitHub中整理出來的15個最受歡迎的Python開源框架，你喜歡哪個
2018-05-09
GithubPython框架
Reviews：支援希拉蕊的喜歡玩LOL 支援川普的喜歡玩WOW
2017-02-10
View
這5個Ansible 模組你喜歡嗎
2020-06-22
你喜歡約IT妹子還是夜店妹子？
2013-10-11
如果你喜歡Python 那麼你不得不知的幾個開源專案
2014-10-15
Python
推薦5款冷門小工具，看一看有沒有你喜歡的？
2023-03-02
5個Python整合開發環境，哪個你更喜歡？
2021-06-01
Python開發環境
Taro UI開發小程式實現左滑喜歡右滑不喜歡效果
2020-05-15
UI
強化學習在美團“猜你喜歡”的實踐
2018-11-16
強化學習
強化學習在美團「猜你喜歡」的實踐
2018-12-19
強化學習
Linux 首次引入 nftables，你可能會喜歡 nftables 的理由
2014-02-18
Linux
推薦引擎演算法 – 猜你喜歡的東西
2016-02-05
演算法
這裡有8個流行的Python視覺化工具包，你喜歡哪個？
2019-04-29
Python視覺化
你最喜歡哪個 Linux 發行版？
2020-02-08
Linux
CEO面試你時喜歡問這些問題
2014-12-18
面試
你們喜歡哪種結對程式設計？
2013-08-20
程式設計
Toasteroid吐司機讓你胃口大開喜歡什麼就吃掉它
2016-08-12
AST
敏捷開發團隊,最喜歡的開發工具CORNERSTONE
2019-06-27
敏捷
敏捷開發團隊,最喜歡的開發工具 CORNERSTONE
2019-06-27
敏捷

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

前言

目標

說明

介面文件

目錄

通用

更新記錄

介面列表

一、福彩-雙色球介面

指定期號中獎號碼

最新中獎號碼資訊

獲取雙色球中獎資訊列表

二、節假日及萬年曆

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

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

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

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

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

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

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

全國城市列表

搜尋全國城市列表

四、IP地址資訊

獲取訪問者的ip地址資訊

獲取指定ip的ip地址資訊

五、小工具

獲取不重複長ID

獲取不重複短ID

六、天氣資訊

獲取特定城市今日天氣

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

七、笑話段子

分頁獲取笑話段子列表

隨機獲取笑話段子列表

八、生成二維碼

生成單一二維碼

生成帶logo二維碼

九、生成隨機圖片驗證碼

生成隨機圖片驗證碼

關於我的

相關文章