开放通用Api，总有你喜欢的

Posted 梳碧湖的砍柴人

tags:

篇首语：本文由小常识网(cha138.com)小编为大家整理，主要介绍了开放通用Api，总有你喜欢的相关的知识，希望对你有一定的参考价值。

接口文档

目录

通用

  • HOST地址： www.mxnzp.com/api

  • 说明： 所有的接口都会返回如下格式的数据，具体数据包装在data中，需要根据状态来确定请求是否成功。

  • 请求方法： 所有的请求都是GET请求

  • 数据返回格式：

    {
    "code": 1,
    "msg": "数据返回成功",
    "data": null
}
复制代码

  • 数据返回格式说明（下面所有接口中的数据返回都是基于data的，不再介绍code和msg，请知悉）：

    • code： 状态码 1 返回成功 0 返回失败 此时，请关注msg错误信息
    • msg： 提示信息，当code返回0的时候包含错误提示信息
    • data： 主要信息，不同接口返回的东西不一样

更新记录

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/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"
        }
    ]
}
复制代码

二、节假日及万年历

指定日期的节假日及万年历信息

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"
            },
            ...这里只显示了一条数据...
        ]
    }
}
复制代码

 

 

以上是关于开放通用Api，总有你喜欢的的主要内容，如果未能解决你的问题，请参考以下文章

Java工厂模式之总有你想不到的知识

深入JDK源码，这里总有你不知道的知识点！

Java策略模式之总有你想不到的知识

Java责任链模式之总有你想不到的知识

Java抽象工厂模式之总有你想不到的知识

JS控制台打印星星，总有你要的那一款~呐~给你小心心哦~~~?