接口文档
目录
- 通用
- 更新记录
- 接口列表
- 一、福彩-双色球接口
- 指定期号中奖号码
- 最新中奖号码信息
- 获取双色球中奖信息列表
- 二、节假日及万年历
- 指定日期的节假日及万年历信息
- 指定多个日期的节假日及万年历信息
- 指定月份所有的节假日及万年历信息
- 指定年份所有的节假日及万年历信息
- 三、全国城市列表(全国地级市API,数据来源国家统计局)
- 全国城市列表
- 搜索全国城市列表
- 四、IP地址信息
- 获取访问者的ip地址信息
- 获取指定ip的ip地址信息
- 五、小工具
- 获取不重复长ID
- 获取不重复短ID
- 六、天气信息
- 获取特定城市今日天气
- 获取特定城市今天及未来天气
- 七、笑话段子
- 分页获取笑话段子列表
- 一、福彩-双色球接口
通用
- 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" }, ...这里只显示了一条数据... ] } } 复制代码
原文地址:https://www.cnblogs.com/kkdn/p/10147487.html
时间: 2024-10-08 23:05:23