公众号openApi管理

最新推荐文章于 2024-05-29 08:56:00 发布
最新推荐文章于 2024-05-29 08:56:00 发布
阅读量629 收藏 1
点赞数
分类专栏： 微信服务号开发 文章标签： 微信 微信公众平台 java
版权声明：本文为博主原创文章，遵循 CC 4.0 BY-SA 版权协议，转载请附上原文出处链接和本声明。
本文链接：https://blog.csdn.net/m0_58095675/article/details/126918725
版权

代码获取编号：001

功能说明

官方文档地址是：https://developers.weixin.qq.com/doc/offiaccount/openApi/clear_quota.html
分为3部分

  • 查询 openAPI 调用quota
  • 清空 api 的调用quota
  • 查询 rid 信息

前置条件

进入公众号后台，在“基本配置”中，将调用接口的IP地址添加为白名单。
需要先获取access_token，作为所有接口调用的参数。

查询配额

不太清楚为什么官方文档一定要把配额写成quota，个人觉得中文更好理解。
上一篇写到每个api都有调用额度限制，比如最常用的获取access_token，一天最多获取2000次；又比如上一篇用到的网络检测接口，限制每天调用1440次。查询配额接口就是用来查询剩余配额情况的，方便再配额即将用光或者已经用光的情况下进行清空（会恢复到最大值）。

		// 先获取access_token，这部分正式环境需要配置定时获取，每天2000次调用限制
		String url = "https://api.weixin.qq.com/cgi-bin/token?grant_type=client_credential&appid=" + APPID + "&secret=" + SECRET;
		String result = Jsoup.connect(url).ignoreContentType(true).method(Method.GET).execute().body();
		System.out.println(result);
		String accessToken = JSON.parseObject(result).getString("access_token");
		//  查询网络检测配额
		url = "https://api.weixin.qq.com/cgi-bin/openapi/quota/get?access_token=" + accessToken;
		JSONObject param = new JSONObject();
		param.put("cgi_path", "/cgi-bin/callback/check");
		result = Jsoup.connect(url).ignoreContentType(true).method(Method.POST).requestBody(param.toString()).execute().body();
		System.out.println(result);

如果运行正常，会打印出剩余的配额。返回格式大体为：

{"errcode":0,"errmsg":"ok","quota":{"daily_limit":1440,"used":1,"remain":1439}}

清空配额

每个月可调用10次清零机会，避免配额耗尽引发异常。
清空配额的含义就是当已分配的配额比如获取ip地址的每天1440次用光以后，调用一下又恢复到1440次。官方有了次数限制，这个必然不能作为长期使用的方式。
还是用上面获取ip地址为例：

  • 调用一次网络检测接口
  • 查询网络检测接口配额（已使用不是0了）
  • 清空配额
  • 查询网络检测接口配额（恢复已使用是0，未使用1440）
		// 先获取access_token，这部分正式环境需要配置定时获取，每天2000次调用限制
		String url = "https://api.weixin.qq.com/cgi-bin/token?grant_type=client_credential&appid=" + APPID + "&secret=" + SECRET;
		String result = Jsoup.connect(url).ignoreContentType(true).method(Method.GET).execute().body();
		System.out.println(result);
		String accessToken = JSON.parseObject(result).getString("access_token");
		// 调用一次网络检测接口，用于测试查询配额剩余情况
		url = "https://api.weixin.qq.com/cgi-bin/callback/check?access_token=" + accessToken;
		JSONObject param = new JSONObject();
		param.put("action", "all");
		param.put("check_operator", "DEFAULT");
		result = Jsoup.connect(url).ignoreContentType(true).method(Method.POST).requestBody(param.toString()).execute().body();
		System.out.println(result);
		// 查询网络检测配额
		url = "https://api.weixin.qq.com/cgi-bin/openapi/quota/get?access_token=" + accessToken;
		param = new JSONObject();
		param.put("cgi_path", "/cgi-bin/callback/check");
		result = Jsoup.connect(url).ignoreContentType(true).method(Method.POST).requestBody(param.toString()).execute().body();
		System.out.println(result);
		// 清空配额
		url = "https://api.weixin.qq.com/cgi-bin/clear_quota?access_token=" + accessToken;
		param = new JSONObject();
		param.put("appid", APPID);
		result = Jsoup.connect(url).ignoreContentType(true).method(Method.POST).requestBody(param.toString()).execute().body();
		System.out.println(result);
		// 必须暂停下，微信端生效需要一定时间
		Thread.sleep(2000);
		// 查询配额
		url = "https://api.weixin.qq.com/cgi-bin/openapi/quota/get?access_token=" + accessToken;
		param = new JSONObject();
		param.put("cgi_path", "/cgi-bin/callback/check");
		result = Jsoup.connect(url).ignoreContentType(true).method(Method.POST).requestBody(param.toString()).execute().body();
		System.out.println(result);

打印结果为

{"errcode":0,"errmsg":"ok","quota":{"daily_limit":1440,"used":2,"remain":1438}}
{"errcode":0,"errmsg":"ok"}
{"errcode":0,"errmsg":"ok","quota":{"daily_limit":1440,"used":0,"remain":1440}}

可以发现最终配额又恢复到了最大值。

查询rid信息

对接微信公众号的时候，难免看到错误信息，同时伴随着一条含有rid的errmsg。可以根据这个rid，查询最近7天对应详细错误，方便排查。
举个例子：清空配额的时候，需要传递appid，如果把appid传递错误，就肯定会返回错误信息，我们把错误信息信息中rid提取出来，就可以使用 查询rid信息 接口获知详细原因了。
这个不适合收到错误rid就立刻调用，需要微信缓存一阵子才能查询到。

		// 这部分测试获取rid信息。先调用清空配额接口，故意把appid写错
		url = "https://api.weixin.qq.com/cgi-bin/clear_quota?access_token=" + accessToken;
		param = new JSONObject();
		param.put("appid", APPID+"234");
		result = Jsoup.connect(url).ignoreContentType(true).method(Method.POST).requestBody(param.toString()).execute().body();
		System.out.println(result);
		String rid = JSON.parseObject(result).getString("errmsg").split(":")[1].trim();
		// 这里必须暂停，给微信点时间缓一下
		Thread.sleep(6000);
		// 查询上面rid对应的详细错误信息
		url = "https://api.weixin.qq.com/cgi-bin/openapi/rid/get?access_token=" + accessToken;
		param = new JSONObject();
		param.put("rid", rid);
		result = Jsoup.connect(url).ignoreContentType(true).method(Method.POST).requestBody(param.toString()).execute().body();
		System.out.println(result);

打印结果：

{"errcode":40013,"errmsg":"invalid appid rid: 6326ce0a-33d0d6d0-672a95dd"}
{"errcode":0,"errmsg":"ok","request":{"invoke_time":1663487498,"cost_in_ms":6,"request_url":"access_token=60_Yx0by_JLDemp4tieyd71fzTmdblS9QVQXLViBCFRN-VISqEFZwuEHd0HaxcygqGU7LH8S5qaKcZHODMAbueqA6DukWaefOs-wFnpuZKcBtcEoBg6qN2GsrS8psUnpbZwMXkp_7_KcJ6rVRRfVDWiAAAFNG","request_body":"{\"appid\":\"wx276049d6a7551dca234\"}","response_body":"{\"errcode\":40013,\"errmsg\":\"invalid appid rid: 6326ce0a-33d0d6d0-672a95dd\"}","client_ip":"106.47.67.229"}}

完整代码

上面提到的步骤所有代码如下

package com.lootaa.wechat;

import org.jsoup.Jsoup;

import com.alibaba.fastjson.JSON;
import com.alibaba.fastjson.JSONObject;

import org.jsoup.Connection.Method;

/**
 * 前置条件：公众号后台设置ip白名单
 */
public class Test001 {

	public static final String APPID = "wx276049d6a7551dca";
	public static final String SECRET = "cbe109fdf6f399bd72ed3a4afafa21b1";
	
	/**
	 * 完整项目源码可关注公众号"lootaayun"（洛塔），回复001获取
	 */
	public static void main(String[] args) throws Exception {
		// 先获取access_token，这部分正式环境需要配置定时获取，每天2000次调用限制
		String url = "https://api.weixin.qq.com/cgi-bin/token?grant_type=client_credential&appid=" + APPID + "&secret=" + SECRET;
		String result = Jsoup.connect(url).ignoreContentType(true).method(Method.GET).execute().body();
		System.out.println(result);
		String accessToken = JSON.parseObject(result).getString("access_token");
		// 调用一次网络检测接口，用于测试查询配额剩余情况
		url = "https://api.weixin.qq.com/cgi-bin/callback/check?access_token=" + accessToken;
		JSONObject param = new JSONObject();
		param.put("action", "all");
		param.put("check_operator", "DEFAULT");
		result = Jsoup.connect(url).ignoreContentType(true).method(Method.POST).requestBody(param.toString()).execute().body();
		System.out.println(result);
		// 查询网络检测配额
		url = "https://api.weixin.qq.com/cgi-bin/openapi/quota/get?access_token=" + accessToken;
		param = new JSONObject();
		param.put("cgi_path", "/cgi-bin/callback/check");
		result = Jsoup.connect(url).ignoreContentType(true).method(Method.POST).requestBody(param.toString()).execute().body();
		System.out.println(result);
		// 清空配额
		url = "https://api.weixin.qq.com/cgi-bin/clear_quota?access_token=" + accessToken;
		param = new JSONObject();
		param.put("appid", APPID);
		result = Jsoup.connect(url).ignoreContentType(true).method(Method.POST).requestBody(param.toString()).execute().body();
		System.out.println(result);
		// 必须暂停下，微信端生效需要一定时间
		Thread.sleep(2000);
		// 查询配额
		url = "https://api.weixin.qq.com/cgi-bin/openapi/quota/get?access_token=" + accessToken;
		param = new JSONObject();
		param.put("cgi_path", "/cgi-bin/callback/check");
		result = Jsoup.connect(url).ignoreContentType(true).method(Method.POST).requestBody(param.toString()).execute().body();
		System.out.println(result);
		
		
		// 这部分测试获取rid信息。先调用清空配额接口，故意把appid写错
		url = "https://api.weixin.qq.com/cgi-bin/clear_quota?access_token=" + accessToken;
		param = new JSONObject();
		param.put("appid", APPID+"234");
		result = Jsoup.connect(url).ignoreContentType(true).method(Method.POST).requestBody(param.toString()).execute().body();
		System.out.println(result);
		String rid = JSON.parseObject(result).getString("errmsg").split(":")[1].trim();
		// 这里必须暂停，给微信点时间缓一下
		Thread.sleep(6000);
		// 查询上面rid对应的详细错误信息
		url = "https://api.weixin.qq.com/cgi-bin/openapi/rid/get?access_token=" + accessToken;
		param = new JSONObject();
		param.put("rid", rid);
		result = Jsoup.connect(url).ignoreContentType(true).method(Method.POST).requestBody(param.toString()).execute().body();
		System.out.println(result);
		
	}
	
}
lootaa
关注
  • 0
    点赞
  • 踩
  • 1
    收藏
    觉得还不错? 一键收藏
  • 打赏
    打赏
  • 0
    评论
专栏目录
【微信公众号】15、SpringBoot整合WxJava实现openApi管理
Asurplus
07-17 3万+
本接口用于清空公众号/小程序/第三方平台等接口的每日调用接口次数
基于GitLab OpenAPI 开发一个仿dbt的版本管理WebIDE
知无涯
07-28 3618
基于GitLab OpenAPI 开发一个仿dbt的版本管理WebIDE。 支持获取项目，分支，文件树，文件内容，提交文件修改。
wx-open-api:微信开放平台api
05-12
wx-open-api 微信开放平台+微信公众平台+微信小程序等接口整合 全新的轮子
支付宝支付功能实现原理，微信公众号中实现支付宝支付功能开发流程
热门推荐
青崖梦
01-20 3万+
这篇文章使用一些简单的代码例子来解释微信接入支付宝支付功能的操作步骤，即使新手也可以轻松参透的。 第三方支付是指具备一定实力和信誉保障的独立机构，采用与各大银行签约的方式，通过与银行支付结算系统接口对接而促成交易双方进行交易的网络支付模式。 使用第三方支付，我们只要申请一个帐号平台即可以支持所以银行卡信用卡支付功能，具体支付功能由第三方支付平台来完成。本文所要介绍的是支付宝手机网站支付功能，而...
linux查看raid信息
huoshi
04-18 878
微信中根据报错的rid值来查询访问的接口具体信息
qq_53760081的博客
08-03 810
【代码】 微信中根据报错的rid值来查询访问的接口具体信息。
微信开放平台：OpenAPI、云开发与基础管理能力升级
TCB_CloudBase的博客
11-10 573
微信团队近期对OpenAPI以及微信开放平台第三方平台基础能力进行了若干项优化，帮助开发者更好使用OpenAPI以及帮助服务商更好地使用第三方平台。优化内容具体如下： OpenAPI 管理 为了帮助开发者更高效定位OpenAPI问题，现开放“查询rid信息”接口，通过该接口可以查询请求详情（rid为每个请求的唯一id），包括发起请求的时间戳、请求毫秒级耗时、请求参数、返回参数等，详情可查看官方接口文档。 为了帮助开发者更清晰地了解每个OpenAPI调用次数限制，更合理地调用接口，现开放“查询OpenAPI
【教程】怎样使用OpenApi弹性管理你的云服务器
京庐空间
01-25 809
阿里云的云服务器ECS除了提供控制台来进行日常的管理和资源创建，还提供了OpenApi来进行资源的管理和定制开发。通过OpenApi您可以更加灵活的管理和配置云服务器。 阿里云提供了SDK来包装OpenApi，可以让您将云服务器的管理集成到您的已有系统中。本文以Python的开发来说明OpenApi如何来管理云服务器，即便您没有Python的开发经验，通过本文也可以轻松的0基础入门进行云服务的开
微信分享intent方式和微信Open的api实现方式
04-13
模块备份 微信分享intent方式和微信Open的api实现方式 分享文字、图片、视频给好友； 分享图片(最多9张）、文字视频到朋友圈
openapi-generator,openapi生成器允许自动生成api客户端库（sdk生成）、服务器存根、文档和配置，并给出openapi规范（v2，v3）.zip
09-25
openapi生成器
全过程注册openAPI详细步骤
03-30
详细描述墙内如何注册openAPI，包括手机待接受国外验证码。 1.优先选择Google浏览器 2.要求科学上网，选全局模式 3.最好选无痕浏览模式，清理缓存信息 4.找一个海外手机号码收取验证码，完成验证即可。 注意，大陆...
oas：轻松创建和管理OpenAPI文档
02-10
使用Swagger和OpenAPI定义很困难。 这使其更容易。 安装 npm install oas 命令行界面 CLI工具使创建API定义文件更加容易。 当前，它支持和文档。 用法 使用您的API转到目录，然后键入： oas init 它将引导您逐步...
NCCloud OpenAPI 客户端调试工具
07-18
参考连接: https://blog.csdn.net/kemoing/article/details/125845545 NCCloud OpenAPI 客户端调试工具,方便实施、开发日常接口测试,支持多个OpenAPI服务参数配置,支持json报文格式化显示等.
友盟OpenAPI
04-04
友盟统计Open API,通过友盟Open API,可以获取到友盟统计的数据
友盟OpenAPI.pdf
12-11
友盟OpenAPI.pdf
微信小程序通过公众号服务号发送消息
wuguangrong888的博客
10-20 7327
微信小程序通过公众号服务号发送消息
微信公众号开发——实现用户微信网页授权流程
一恍过去
12-16 1万+
微信公众号开发——实现用户微信网页授权流程
python调用openapi_eleme.openapi.python.sdk · PyPI
weixin_39678525的博客
12-05 399
Project description# Python SDK 接入指南 & CHANGELOG## 接入指南1. 安装eleme sdk依赖包,引入依赖2. 利用sdk.config 模块初始化设置沙箱环境，key,secret,调用config.set_log 设置自己的log处理方式。如果是企业应用还需设置callback_url3. 利用sdk.oauth 模块完成oauth授权测...
Dify快速接入微信
最新发布
qq_55051574的博客
05-29 935
Dify知识库快速接入微信，绘画语音插件无所不能
xiaoya openapi
01-17
根据提供的引用内容，我了解到OpenAPI是一种用于描述和定义HTTP API的规范。它提供了一种与编程语言无关的接口描述方式，使得人和计算机都能够发现和理解服务的功能，而无需访问源代码。 在OpenAPI规范中，可以使用一些工具来格式化OpenAPI文档，其中一个工具是openapi-format。它可以加载OpenAPI文件，并按照层次结构顺序对OpenAPI字段进行排序和过滤，然后将文件输出为JSON或YAML格式。 另外，OpenAPI规范也有一个存储库，即OpenAPI规范存储库。这是一个社区驱动的开放规范，旨在为HTTP API定义提供标准的接口描述。 综上所述，OpenAPI是一种规范，用于描述和定义HTTP API的接口。它提供了一种与编程语言无关的方式来描述API的功能和特性。

“相关推荐”对你有帮助么？

  • 非常没帮助
  • 没帮助
  • 一般
  • 有帮助
  • 非常有帮助
提交
评论
添加红包

请填写红包祝福语或标题

个

红包个数最小为10个

元

红包金额最低5元

当前余额3.43元 前往充值 >
需支付：10.00元
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包

打赏作者

lootaa

你的鼓励是我创作的最大动力

¥1 ¥2 ¥4 ¥6 ¥10 ¥20
扫码支付：¥1
获取中
扫码支付

您的余额不足，请更换扫码支付或充值

打赏作者

实付元
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明：

1.余额是钱包充值的虚拟货币，按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载，可以购买VIP、付费专栏及课程。

余额充值