Giter Site home page Giter Site logo

mzcretin / rolltoolsapi Goto Github PK

View Code? Open in Web Editor NEW
3.3K 77.0 369.0 1.86 MB

一个提供开发中常用数据的一个稳定聚合Api接口源,运行于独立服务器,免费,且长期维护,会持续添加新的接口!【只fork不star是很没品的】

Home Page: https://www.mxnzp.com/doc/list

License: MIT License

api

rolltoolsapi's Introduction

RollToolsApi

项目国际化翻译解决方案,支持Android、iOS、Flutter、前端Vue、后端PHP等等,点几下按钮就能实现翻译内容的自动抓取和翻译后文件的自动生成,适合各类场景下的国际化需求。目前项目正在快速适配和推广阶段,欢迎广大程序员加入。项目主页:https://github.com/MZCretin/Eva-Translate 官网入口:https://cretinzp.com/pro-translate

想没想过做个自己的APP?

想没想过自己做个APP,自己做自己的产品,自己决定交互,自己制作ui,那么快来吧,我开源了段子乐APP的数据和接口,你完全可以自己diy一个你自己的产品了~,详情请查看:https://github.com/MZCretin/duanzile-open-api 欢迎star

大道至简系列

需求解决系列之-【系列工具概览】 此系列是大道至简的起始,将一系列简单恶心的操作封装起来,框架么,可以败絮其中,但一定要金絮其外!

一个提供开发中常用数据的一个稳定聚合Api接口源,运行于独立服务器,此服务从2018年11月19日第一个用户开始成功调用接口,到现在已经稳定运行近4个年头,服务器也升级换代了十几次,提交代码一千多次。接口会秉承免费,且长期维护,和持续添加新的接口!

如果在使用过程中有什么问题,或者有什么好的意见或者建议,都可以与我联系,[email protected],或者扫描下方微信二维码添加我为好友,目前有RollApi交流群,里面大佬云集,不仅可以聊技术,还可以谈人生,想加群的可以加我,我拉你进群,联系我请注明您的来意【备注RollApi】!

主页地址:ROLL,目前接口已经支持https请求,推荐使用 https://www.mxnzp.com/api ,更安全,http://www.mxnzp.com/api 可继续使用,域名已经成功备案,所有接口的文档地址:https://www.mxnzp.com/doc/list

解锁新方式

郑重说明:非app_id请求方式将于2020年4月1日停止对外服务,请替换成app_id请求的方式,否则将无法正常使用接口!届时将拦截所有非app_id的请求,对您的使用造成影响,敬请谅解!

想体验接口? 可获取临时app_id测试,获取方式:扫描下方小程序码->选择TAB-我的->点击获取临时app_id即可获取临时体验接口的app_id和app_secret,此app_id仅为测试使用,次日凌晨自动重置,重置之后之前生成的app_id将失效,真正使用接口请申请属于自己专属的app_id。

  • 各位开发者,为了更方便的使用,经过一段时间的努力,开通了app_id和app_secret方式请求接口的方式,使用此方式最大的好处在于不会再有那么多限制了,包括你可以在你的服务器中调用,包括不会封IP!
  • 如何注册app_id和app_secret呢?扫描下方小程序码(或者搜索小程序【电点科技】),进入我的页面,绑定手机号之后即可获取你的专属app_id和app_secret,使用新方式吧*年!
  • 如何确定是否正确使用了app_id的方式呢?
    • 扫描下方小程序码(或者搜索小程序【电点科技】),进入我的页面,点击数据统计,这里将会显示接口的调用情况,如果配置正确,这里将会有统计数据。
  • 如何使用呢?
    • 在每个请求链接后面添加app_id=你的app_id&app_secret=你的app_secret两个参数,如果是POST请求,需要将两个参数放在参数列表中请求
    • 【推荐方案】在请求头header中添加app_id=你的app_id&app_secret=你的app_secre两个参数,更加方便

Stargazers over time

Stargazers over time

特别声明

最近问的一个比较多的问题就是,接口访问404,在这里我想说,请各位大佬仔细阅读文档,仔细阅读文档,仔细阅读文档,尤其是"通用"模块的文档,我们的Host地址是域名+/api(https://www.mxnzp.com/api),不是纯域名,不要再来问题这个问题了。。。一个正常的请求应该是 https://www.mxnzp.com/api/xxxxx

随着使用本api用户的增多,每一次对服务器的升级维护,都需要格外小心,否则将会影响到用户的使用。特此创建了一个交流群,旨在交流使用通用接口中遇到的问题,以及其他新接口的建议,群中大佬云集,可以进行学术交流!有新接口的诞生也方便通知大家!另外一个作用就是,如果接口需要停机维护,会提前在群中通知,以免对大家的使用带来不便以及损失!

前期开放扫描二维码进群的方式让群里多了很多发布淫秽,色情,赌博的广告信息,现关闭此方式,需要加群的请添加我微信好友,我拉你入群(备注下通用API),感谢您的支持!

自助IP解封:对于使用中逻辑不正确导致的IP封禁,现提供自助解封方式,微信公众号搜索《Cretin的开发之路》,回复任意消息可召唤出自助服务系统,按照说明进行IP自助解封!如图三


更新记录

2024-02-21 19:12:08

2023-11-29 14:23:01

2023-10-12 22:23:08

2023-09-20 12:11:42

2023-09-12 14:42:11

2023-02-28 17:52🕠2

2022-07-01 08:32:17

2021-12-07 23:47:22

2021-11-11 19:57:01

2021-11-09 17:23:23

2021-10-21 14:14:00

2021-10-02 18:12:00

2021-09-29 13:22:00

2021-09-27 17:57:00

2021-09-24 19:46:14

2020-06-08 16:36:29

  • 节假日及万年历相关接口新增 indexWorkDayOfMonth 字段,此字段返回是当前月的第几个工作日,二、节假日及万年历
  • 天气接口新增天气描述,风力描述,风向描述清单,附件

2020-02-26 21:47:39

2020-01-17 14:53:43

2020-01-16 22:16:09

2020-01-13 23:28:37

2019-11-20 10:12:34

  • 新增app_id+app_secret 方式请求接口,使用此方式可避免请求限流以及封禁IP。解锁新方式
  • 新开发《Roll地盘》小程序,可以申请app_id+app_secret,可以查询你申请的app_id下每日请求统计数据!

2019-09-09 09:44:35

2019-08-28 12:10:13

2019-08-10 19:23:14

2019-08-06 23:09:05

  • 新增其他彩种的彩票信息,包括之前的双色球一共七种彩种,聚合成一个接口方便调用,当然,之前的双色球接口使用已做兼容处理,不会受到影响!查看说明

2019-07-24 23:54:27

  • 新增物流查询的接口,查看说明
  • 段子接口当请求页数超过最大页数时返回空数组
  • 修复一些已知的bug

2019-07-10 20:22:17

2019-07-08 17:59:41

  • 新增垃圾分类信息查询接口,查看说明
  • 修复线上一些已知bug

2019-07-05 19:15:06

  • 新增获取不同类型最新新闻的接口,查看说明

2019年07月02日 19:30:22

2019年06月05日15:54:50

  • 新增查询手机归属地的接口,查看说明
  • IP地址查询的接口逻辑优化,数据搜索更加准确,查看说明
  • 音乐搜索新增page参数,可实现数据分页查询,查看说明

2019年05月22日13:07:41

  • 新增音乐相关接口,拥有这些接口,基本上可以实现一个小的音乐播放器,查看说明

2019年05月15日11:57:20

  • 新增国家电话区号列表接口,查看说明
  • 国家城市列表接口新增世界级国家城市列表查询,查看说明

2019年04月11日23:59:55

  • 服务器已经支持https请求,之前的http请求不受影响!

2019年03月13日11:27:58

  • 一、服务器硬件更新
    • 1、升级服务器内存和cpu
  • 二、接口更新(本次没有新接口添加)
    • 1、节假日api的假日信息更新到2002年,2002年之前的节假日信息国务院没有发布,不再做统计!查看说明
    • 2、节假日api每日信息新增星座字段!查看说明
    • 3、修复天气api模糊搜索的bug,现在搜索会先全量匹配,匹配不到才会进行模糊匹配!查看说明

2019年01月29日09:53:10

  • 新增生成条形码接口,可以生成商品对应的条形码,查看说明;新增条形码对应的商品信息,输入条形码上的商品code,可以获取对应的商品信息,查看说明

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


目录


通用

  • HOST地址: 推荐使用https接口更安全:https://www.mxnzp.com/api 之前的 http://www.mxnzp.com/api 可继续使用不受影响!

  • app_id和app_secret方式请求(摆脱被封IP的限制,可在服务器中调用接口):

    • 在参数中添加app_id=你的app_id&app_secret=你的app_secret
    • 【推荐方案】在请求头header中添加app_id=你的app_id&app_secret=你的app_secret
    • 唯一获取app_id和app_secret方式,扫描上方小程序码进行操作!
  • 说明: 所有的接口都会返回如下格式的数据,具体数据包装在data中,需要根据状态来确定请求是否成功。

  • 请求方法: 所有的请求中都是大部分都是GET请求(如果有特殊情况,则会特殊标明)

  • 数据返回格式:

    {
        "code": 1,
        "msg": "数据返回成功",
        "data": null
    }
  • 数据返回格式说明(下面所有接口中的数据返回都是基于data的,不再介绍code和msg,请知悉):

    • code: 状态码 1 返回成功 0 返回失败 此时,请关注msg错误信息
    • msg: 提示信息,当code返回0的时候包含错误提示信息
    • data: 主要信息,不同接口返回的东西不一样
  • 列表数据格式说明(大部分列表数据都满足下列格式,特殊接口除外,在此特别说明,后面就不再赘述了)

    • page: 当前页数
    • totalCount: 总数量
    • totalPage: 总页数
    • limit: 每页数量
    • list: 每页具体数据
      • 具体列表数据模型

捐赠

由于服务器端的维护以及部分接口的维护都是需要付费的,所以如果此项目对您有帮助,还希望您捐赠支持,让我能好好的一直坚持下去。金额不在于多少,一份心意就好!在此感谢捐赠列表中所有的捐赠者,你们的鼓励是我最大的动力!捐赠列表

    
---------

版权声明

本站所对外提供的Api接口中,部分数据来源于网络,如有侵权,请联系我进行处理!

本站所提供的所有Api接口仅仅是秉承交流学习的**,没有任何盈利的行为,用户在使用过程中造成的版权问题由使用者自行承担,与本站维护者无关,请知悉!


接口列表

由于当前项目仅仅是文档项目,有新接口时不方便更新,后续新接口将在个人主页更新,请知悉~

文档地址:https://www.mxnzp.com/doc/list

附件

天气描述清单

  • 少云
  • 晴间多云
  • 多云
  • 有风
  • 平静
  • 微风
  • 和风
  • 清风
  • 强风/劲风
  • 疾风
  • 大风
  • 烈风
  • 风暴
  • 狂爆风
  • 飓风
  • 热带风暴
  • 中度霾
  • 重度霾
  • 严重霾
  • 阵雨
  • 雷阵雨
  • 雷阵雨并伴有冰雹
  • 小雨
  • 中雨
  • 大雨
  • 暴雨
  • 大暴雨
  • 特大暴雨
  • 强阵雨
  • 强雷阵雨
  • 极端降雨
  • 毛毛雨/细雨
  • 小雨-中雨
  • 中雨-大雨
  • 大雨-暴雨
  • 暴雨-大暴雨
  • 大暴雨-特大暴雨
  • 雨雪天气
  • 雨夹雪
  • 阵雨夹雪
  • 冻雨
  • 阵雪
  • 小雪
  • 中雪
  • 大雪
  • 暴雪
  • 小雪-中雪
  • 中雪-大雪
  • 大雪-暴雪
  • 浮尘
  • 扬沙
  • 沙尘暴
  • 强沙尘暴
  • 龙卷风
  • 浓雾
  • 强浓雾
  • 轻雾
  • 大雾
  • 特强浓雾
  • 未知

风力表清单

  • ≤3
  • 4
  • 5
  • 6
  • 7
  • 8
  • 9
  • 10
  • 11
  • 12

风向表清单

  • 无风向
  • 东北
  • 东南
  • 西南
  • 西
  • 西北
  • 旋转不定

rolltoolsapi's People

Stargazers

 avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar

Watchers

 avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar

rolltoolsapi's Issues

路人甲

过来跟主人问个好。支持支持...

万年历20190929号type类型错误

https://www.mxnzp.com/api/holiday/single/20190929

{
code: 1,
msg: "数据返回成功",
data: {
date: "2019-09-29",
weekDay: 7,
yearTips: "己亥",
type: 1,
typeDes: "工作日",
chineseZodiac: "猪",
solarTerms: "秋分后",
avoid: "定磉.安葬",
lunarCalendar: "九月初一",
suit: "祭祀.赴任.动土.上梁.开光.塑绘.冠笄.拆卸.起基.安床.开市.立券.赴任.经络",
dayOfYear: 272,
weekOfYear: 39,
constellation: "天秤座"
}
}

type 应该是0吧

节假日-按月查有个数据有问题

https://www.mxnzp.com/api/holiday/list/month/201910

2019-10-12号 type错误,应该是0

{
date: "2019-10-12",
weekDay: 6,
yearTips: "己亥",
type: 1,
typeDes: "工作日",
chineseZodiac: "猪",
solarTerms: "寒露后",
avoid: "上梁.开光.造屋.架马.合寿木",
lunarCalendar: "九月十四",
suit: "造车器.嫁娶.订盟.纳采.会亲友.祭祀.出行.开市.立券.移徙.入宅.破土.安葬",
dayOfYear: 285,
weekOfYear: 41,
constellation: "天秤座"
},

NoTitle

我有世界国家城市信息的json和世界国家电话区号json,如果可以转换为接口,我可以为您提供json文件

404

接口挂了,返回404

想看下源码

觉得你挺厉害的!想看下源码不知道可以不

个人建议

接口可以实行免费和付费两种,这样也可以避免部分恶意的用户,同时也可以为作者带来收入。

IP请求附带国家的信息

{
"ip":"(---)",
"province":"",
"provinceId":999999,
"city":"",
"cityId":0,
"isp":"美国",
"desc":" 美国"
}

如题,如果我要判断客户端IP是国内还是国外的话,返回值里没有正常的信息,我用日本IP也返回的上面数据

后续更新计划中,考虑一下支持判断国家?

关于请求超时

是否是最近的服务器在升级吗?最近几乎都是请求超时504,但还是非常感谢提大佬供免费接口给我们测试.

关于笑话API的请求问题

大佬,您好,今天我用您的jokes接口时,出现了小程序请求返回JSON数据不一样.

  • 比如在PC模拟端上请求全部正常:

20200209162113

20200209163218

  • 但是在真机模拟上,除了第一页是正常返回JSON格式外,后面data数据都多了个""双引号:

20200209162407

而且,我也使用JSON.parse尝试对其data解析,但是报错,当然,也是今天才出现这种情况,昨天都没有出现,我也参考了网上资料,也有类似的情况,不知道是什么问题呢?非常感谢您能提供这个机会给我们学习

网上资料一
网上资料二

物流查询问题

curl -X POST -H "Content-Type:application/x-www-form-urlencoded" -H "Content-Length:67" -H "Host:www.mxnzp.com" -H "Connection:Keep-Alive" -H "Accept-Encoding:gzip" -H "User-Agent:okhttp/3.11.0" -d 'app_id=pvgqxxxxxsdqr&app_secret=Vjk9xxxxxxxQT09' "https://www.mxnzp.com/api/logistics/details/search?logistics_no=557019329315102&logistics_id=2"
无法获得响应结果 只能等待超时

日历2015年-端午节

2015年6月标注了两次端午节,分别是9-11号和20-22。正确得端午节是20-22号,9-11号多标了。

接口超时

历史上的今天:/history/today

{
  "msg": "请求超时,请稍后再试",
  "code": 0
}

接口返回值错误

以下接口
[HOST]/lottery/common/latest?code=pl3
的返回值是错的,并不是最新一期开奖结果

日历2015-中秋节

法定2015中秋节休息9月26和9月27两天,api标注的中秋节多了28号。

关于“指定日期节假日信息”接口问题

Recommend Projects

  • React photo React

    A declarative, efficient, and flexible JavaScript library for building user interfaces.

  • Vue.js photo Vue.js

    🖖 Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.

  • Typescript photo Typescript

    TypeScript is a superset of JavaScript that compiles to clean JavaScript output.

  • TensorFlow photo TensorFlow

    An Open Source Machine Learning Framework for Everyone

  • Django photo Django

    The Web framework for perfectionists with deadlines.

  • D3 photo D3

    Bring data to life with SVG, Canvas and HTML. 📊📈🎉

Recommend Topics

  • javascript

    JavaScript (JS) is a lightweight interpreted programming language with first-class functions.

  • web

    Some thing interesting about web. New door for the world.

  • server

    A server is a program made to process requests and deliver data to clients.

  • Machine learning

    Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.

  • Game

    Some thing interesting about game, make everyone happy.

Recommend Org

  • Facebook photo Facebook

    We are working to build community through open source technology. NB: members must have two-factor auth.

  • Microsoft photo Microsoft

    Open source projects and samples from Microsoft.

  • Google photo Google

    Google ❤️ Open Source for everyone.

  • D3 photo D3

    Data-Driven Documents codes.