ROLL-BLOG

  • 博客首页
  • 个人主页
  • 留言板
  • 在线工具
  • 关于我
ROLL
纸上得来终觉浅,绝知此事要躬行
  1. 首页
  2. api相关
  3. 正文

通用免费Api使用教程

9月 25, 2021 63071点热度 30人点赞 62条评论

其实所有的文档内容都有在GitHub上体现~你有空的话可以点个star。

项目地址:https://github.com/MZCretin/RollToolsApi

What?

什么是RollToolsApi,这是一个公益项目,Roll 圈圈的意思,Tools 工具的意思,Api 接口的意思,说到底就是一个胖的像个球的我提供的一个工具类接口集合。

Why?

为什么要做这个呢?这些接口其实最开始是我自己使用的,后来也顺便提供给朋友用,再后来就直接开放出来了~并且为之购买了独立的服务器维护。说到底就是为了情怀~

How?

怎么使用呢?其实这就是一个普通的Api接口,调用方式很简单,就发送Http请求就好了,跟你在日常开发的时对接的后台接口是一样的。

其实最开始是没有任何使用门槛的,就是是谁都可以调用,也不会限速,限次数,限IP,但是慢慢的就有了一些不怀好意的人,老是来攻击服务器,服务器经常性的被搞炸,后来逼不得已,对接口的使用进行了一些限制,那就是需要你申请一个app_id和app_secret才能使用接口。但是你不用担心,申请完app_id和app_secret之后就可以畅通无阻的使用接口,没有任何限制。

接口文档在哪里呢?

所有最新的接口文档会在这里同步更新:https://www.mxnzp.com/doc/list

什么是app_id和app_secret?

它只是一个身份的象征,代表你是自己人。

怎么申请呢?

目前只提供在小程序上进行申请(其实只是想你帮我点下广告,哈哈哈),扫描下方的二维码进入小程序(或者搜索小程序【电点科技】),在我的页面中申请app_id和app_secret。申请成功之后即可将app_id和app_srcret作为请求参数进行任意接口的访问了。经过很长时间的反馈,大家都说小程序里面的广告其实也挺好看的~~~~

小程序tu

怎么使用呢?

  • 在每个请求链接后面添加app_id=你的app_id&app_secret=你的app_secret两个参数,如果是POST请求,需要将两个参数放在参数列表中请求。
  • 在请求头header中添加app_id=你的app_id&app_secret=你的app_secre两个参数,更加方便【推荐方案】。

怎么检测是否正确接入?

  • 如果你没有正确接入,是没有办法获取到数据的。
  • 扫描上方小程序码(或者搜索小程序【电点科技】),进入我的页面,点击数据统计,这里将会显示接口的调用情况,如果配置正确,这里将会有统计数据。

出现问题怎么整?

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

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

    小程序tu

  • 给我的邮箱发邮件,说出你的问题,mxnzp_life@163.com

  • 进入上面提到的小程序,进入之后,有个客服入口,点击去也能找到我呢。

接口的通用说明

  • 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: 每页具体数据
标签: 指南
最后更新:11月 2, 2022

穆仙念

这个人很懒,什么都没留下

点赞
下一篇 >

文章评论

  • 阿霞

    :eek: :eek:

    9月 26, 2021
    回复
    • 穆仙念

      @阿霞 :smile:

      10月 28, 2021
      回复
  • 阿杜

    来得早呀

    10月 4, 2021
    回复
    • 穆仙念

      @阿杜 早早早

      10月 28, 2021
      回复
  • 丁丁很大

    说实话,这个项目对接了两年多了,还是比较稳定的,希望博主能坚持下去吧~ :exclaim:

    10月 23, 2021
    回复
    • 穆仙念

      @丁丁很大 会坚持的

      10月 28, 2021
      回复
  • 阿鑫

    坚持

    11月 18, 2021
    回复
    • 穆仙念

      @阿鑫 嗯嗯,会的

      11月 18, 2021
      回复
  • ww

    nnn

    5月 16, 2022
    回复
  • i

    :arrow:

    6月 14, 2022
    回复
  • wzyddg

    对于我这种想做点小东西给小圈子用的人,这个API太简单好用了,不用像谷歌百度一样搞一堆加盐和令牌之类。非常感谢你,广告我会多点的。

    6月 18, 2022
    回复
    • 穆仙念

      @wzyddg 感谢支持

      6月 18, 2022
      回复
      • aty

        @穆仙念 app_id怎么只有一天啊,能不能时间长一点

        7月 12, 2022
        回复
        • 穆仙念

          @aty 你别用临时app_id,自己去申请app_id啊

          7月 12, 2022
          回复
  • ce

    为啥总是报请求超时

    6月 19, 2022
    回复
    • 穆仙念

      @ce 那个接口?

      6月 19, 2022
      回复
      • ce

        @穆仙念 短链接那个

        6月 19, 2022
        回复
  • ce

    为啥一直报请求超时

    6月 19, 2022
    回复
    • 穆仙念

      @ce 具体哪个接口?

      6月 19, 2022
      回复
      • ce

        @穆仙念 https://www.mxnzp.com/api/shortlink/create

        6月 19, 2022
        回复
        • 穆仙念

          @ce 接口没问题,应该是你自己的原因

          6月 24, 2022
          回复
  • sa

    新闻详情为啥一直是请求超时啊

    6月 24, 2022
    回复
    • 穆仙念

      @sa 已修复

      7月 12, 2022
      回复
  • shockbear

    历史上的今天接口报超时了

    6月 25, 2022
    回复
    • 穆仙念

      @shockbear 已收到反馈

      7月 12, 2022
      回复
  • 试试水

    怎么获取啊,我获取了之后说要看广告,也没广告出来啊

    6月 26, 2022
    回复
    • 穆仙念

      @试试水 可能小程序出bug了,刷不出来广告了

      7月 12, 2022
      回复
  • 路飞

    跨域怎么搞

    7月 20, 2022
    回复
    • 穆仙念

      @路飞 服务端已经解决了跨域问题

      11月 2, 2022
      回复
  • goewy

    怎样申请APP_ID和APP_SRCRET啊,在小程序里点“查看APPID”,老提醒要看广告才能查看信息。。点可以理解就。。。一头懵

    7月 29, 2022
    回复
    • 穆仙念

      @goewy 你可能遭遇了百年难遇的广告不出来的问题了,找客服给你提供appid和appsecret

      11月 2, 2022
      回复
  • Guangran

    计划使用调用万年历接口,根据节日自动更换博客首页的 banner 图,正在测试中,顺便问一下每秒钟的并发有多少。

    8月 23, 2022
    回复
  • Kevin

    小程序被必胜客封了,请问有其他申请渠道吗?

    8月 29, 2022
    回复
  • 垃圾

    说是没有限制,实际还是显示并发和调用数

    9月 14, 2022
    回复
    • 穆仙念

      @垃圾 你但凡有点渠道也不之余来这里,做个伸手党还骂人。

      11月 2, 2022
      回复
  • 空心菜

    想同步用户手机号归属地,5W个手机号,有没有限制每秒能发多少次请求?

    9月 28, 2022
    回复
  • 韩小怂

    我看了广告为啥还是不能申请appid啊?

    10月 4, 2022
    回复
  • qwq

    qwqw

    10月 6, 2022
    回复
  • facethebug

    申请了专属appip,返回{"msg":"app_id或者app_secret不合法","code":0},这是为啥呢

    10月 17, 2022
    回复
    • 穆仙念

      @facethebug 你应该是手敲appid和appsecret敲错了!
      小程序被限制使用复制能力了,为了解决这个问题,我们在【Cretin的开发之路】公众号上提供了用手机号获取appid信息的入口,去那里可以复制

      11月 2, 2022
      回复
  • yanglaoer

    获取之后 用不了

    10月 19, 2022
    回复
  • yanglaoer

    用不了

    10月 19, 2022
    回复
  • yanglaoer

    密钥复制不了,手动输入后发现没用

    10月 19, 2022
    回复
    • 穆仙念

      @yanglaoer 小程序被限制使用复制能力了,为了解决这个问题,我们在【Cretin的开发之路】公众号上提供了用手机号获取appid信息的入口,去那里可以复制

      11月 2, 2022
      回复
  • AK47

    现在是 app_id 无法拷贝了

    10月 20, 2022
    回复
    • 穆仙念

      @AK47 是的!小程序被限制使用复制能力了,为了解决这个问题,我们在【Cretin的开发之路】公众号上提供了用手机号获取appid信息的入口,去那里可以复制

      11月 2, 2022
      回复
  • 111

    用c#怎么调用http接口啊 我是小白 :exclaim:

    11月 1, 2022
    回复
    • 穆仙念

      @111 百度一下你就知道

      11月 2, 2022
      回复
  • tt_60

    申请了app_id和app_secret,用https://www.mxnzp.com/api/beian/search这个接口总是返回超时是什么原因呢?

    11月 16, 2022
    回复
    • 穆仙念

      @tt_60 贴下具体的请求链接呢

      12月 7, 2022
      回复
  • 1011

    为什么一直都是app_id或者app_secret不合法,申请app_id请访问

    11月 16, 2022
    回复
    • 穆仙念

      @1011 appid不合法就是你输入的appid有问题,小程序用不了了复制功能,去公众号上用手机号获取你的appid,然后复制,不要手敲,更不要图片识别,会出错

      12月 7, 2022
      回复
  • Guilt

    获取到驾考列表,但获取不了答案 控制台说是被策略阻止了

    11月 17, 2022
    回复
    • 穆仙念

      @Guilt 不应该呀,贴出返回的数据看下

      12月 7, 2022
      回复
  • minky

    申请的appid 按照公众号复制了,还是提示不合法,用不了

    11月 21, 2022
    回复
    • 穆仙念

      @minky appid不合法就是你输入的appid有问题,小程序用不了了复制功能,去公众号上用手机号获取你的appid,然后复制,不要手敲,更不要图片识别,会出错

      12月 7, 2022
      回复
  • w

    你好,报请求频繁咋解决?

    11月 21, 2022
    回复
    • 穆仙念

      @w 设置请求之间的间隔为1秒以上即可

      12月 7, 2022
      回复
  • 0605

    2023年的日历信息还未维护吗?

    11月 29, 2022
    回复
    • 穆仙念

      @0605 这个需要等到国务院出2023年放假安排我们才会同步更新哈

      12月 7, 2022
      回复
  • 654

    麻烦问下,2023年的万年历什么时候可以出来

    12月 6, 2022
    回复
    • 穆仙念

      @654 这个需要等到国务院出2023年放假安排我们才会同步更新哈

      12月 7, 2022
      回复
  • 取消回复
    文章目录
    • What?
    • Why?
    • How?
    • 接口文档在哪里呢?
    • 什么是app_id和app_secret?
    • 怎么申请呢?
    • 怎么使用呢?
    • 怎么检测是否正确接入?
    • 出现问题怎么整?
    • 接口的通用说明
    最新 热点 随机
    最新 热点 随机
    太懒了,所以用小爱开楼下的门禁 做个自己的APP?段子乐开放API今日发布 使用NPS搭建内网穿透服务,限时开放 Jetpack系列之App Startup从入门到出家 一、【Mac新机安装】IntelliJ Idea 2020 破解安装.md 【学个新技术】六、SpringCloud 服务注册中心组件-eureka client
    【学个新技术】三、SpringCloud 微服务环境父项目搭建 【需求解决系列之五】一行代码实现Android 6.0以上动态权限的申请 【为生活开发系列之三】Android屏幕适配资源文件批量分类工具 【学个新技术】一、SpringCloud 微服务架构和演变过程 【需求解决系列之四】Android App 在线 自动更新(适配到9.0) 【为生活开发系列之四】图片文字识别与标准文档对比工具
    最近评论
    654 发布于 10 个月前(12月06日) 麻烦问下,2023年的万年历什么时候可以出来
    0605 发布于 10 个月前(11月29日) 2023年的日历信息还未维护吗?
    w 发布于 10 个月前(11月21日) 你好,报请求频繁咋解决?
    minky 发布于 10 个月前(11月21日) 申请的appid 按照公众号复制了,还是提示不合法,用不了
    Guilt 发布于 11 个月前(11月17日) 获取到驾考列表,但获取不了答案 控制台说是被策略阻止了
    书签
    • CSDN
    • Github
    • 傻瓜记账APP
    • 在线工具
    • 掘金
    • 段子乐APP
    • 简书
    • 通用免费API
    标签聚合
    前端开发 指南 后端开发 Docker 学个新技术 就是喜欢玩儿 SpringCloud 解决需求

    Copyright © 2017-2021 All Rights Reserved.

    THEME KRATOS MADE BY VTROIS

    鄂ICP备17026449号-2