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

時間  2019-11-07
標籤 開放 通用 api 總有 喜歡 简体版
原文   原文鏈接

前言

前段時間作了一個小插件，須要調用一個查詢指按期號中獎號碼的Api接口，找了不少開放的接口，都不合我意，要麼限速，要麼收費，要麼進羣。還可能不穩定，接口動不動就被改掉了，致使訪問失敗。遂罷。java

本身擼一個！git

首先實現的是給本身用的福彩相關的Api，推薦給朋友後試着還不錯，因而在朋友的推薦下新增了一些其餘的api接口，爲之購買了獨立的服務器並部署了項目，目前域名正在備案中。github

目標

我會堅持維護，也會積極響應朋友的號召，有好的意見也會積極採納並實施。更重要的是：接口不限速，不收費，不加羣，但但願你不要頻繁請求，注意優化本身的邏輯，頻繁調用系統可能會禁用你的ip，致使你沒法正常請求。更不要惡意攻擊，且行且珍惜。api

說明

博客中的Api文檔是截止昨晚發佈的，不會實時更新，之後新增的Api接口以及詳細的文檔說明都會在Github上進行，我會盡心維護，盡力寫好文檔。固然在使用過程當中有什麼問題或者建議，最好是在Github的issue中提出來或者直接聯繫我。您的star就是對我最大的鼓勵！服務器

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

經常使用郵箱：mxnzp_life@163.comdom

經常使用QQ：792075058工具

我的站點主頁：www.mxnzp.compost

接口文檔

目錄

通用

  • 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

2018年11月27日23:14:49

接口列表

1、福彩-雙色球接口

指按期號中獎號碼

  • 接口說明： 獲取指按期號的雙色球獲獎號碼信息

  • 接口地址： [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/latest

  • 參數說明： 無

  • 返回數據：

    • 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"
        }
    ]
}
複製代碼

2、節假日及萬年曆

指定日期的節假日及萬年曆信息

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
                }
            ]
        }
    ]
}
複製代碼

3、全國城市列表（全國地級市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": "羅湖區"
                        },
                        ...這裏只顯示了兩個區...
                    ]
                }
            ]
        }
    ]
}
複製代碼

4、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": "廣東省深圳市 電信"
    }
}
複製代碼

5、小工具

獲取不重複長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"
    }
}
複製代碼

6、天氣信息

獲取特定城市今日天氣

  • 接口說明： 獲取特定城市今日天氣信息

  • 接口地址： [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級"
            },
            ...這裏只顯示了一條數據...
        ]
    }
}
複製代碼

7、笑話段子

分頁獲取笑話段子列表

  • 特別說明： 此接口的數據來源是個人另一個產品【段子樂】，目前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"
        },
        ...這裏只顯示了一條數據...
    ]
}
複製代碼

8、生成二維碼

生成單一二維碼

  • 接口說明： 根據傳入的內容生成二維碼，能夠選擇獲取二維碼下載連接，也能夠直接獲取圖片的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
    }
}
複製代碼

9、生成隨機圖片驗證碼

生成隨機圖片驗證碼

  • 接口說明： 生成隨機長度的圖片驗證碼。

  • 接口地址： [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，一個可愛的小男孩。

相關文章
相關標籤/搜索
每日一句
    每一个你不满意的现在，都有一个你没有努力的曾经。
本站公眾號
   歡迎關注本站公眾號,獲取更多信息
聯繫我們 最近搜索 最新文章 沪ICP备13005482号-10 MyBatis教程 SQL 教程 MySQL教程 Java 教程 Thymeleaf 教程 Hibernate教程 Spring教程 Redis教程