AI 助理
备案控制台
开发者社区 开发与运维 文章 正文

微信开发工具包WxJava之微信公众号开发的常用API使用篇

2023-06-07 1559 发布于四川
版权
举报
版权声明：
本文内容由阿里云实名注册用户自发贡献，版权归原作者所有，阿里云开发者社区不拥有其著作权，亦不承担相应法律责任。具体规则请查看《 阿里云开发者社区用户服务协议》和 《阿里云开发者社区知识产权保护指引》。如果您发现本社区中有涉嫌抄袭的内容，填写 侵权投诉表单进行举报，一经查实，本社区将立刻删除涉嫌侵权内容。
简介： 承接上文：微信开发工具包WxJava之微信公众号开发的入门使用篇，续写下文。

WxJava

承接上文：微信开发工具包WxJava之微信公众号开发的入门使用篇，续写下文。

微信开发工具包WxJava是一个基于Java语言的微信公众号和小程序开发工具包，提供了丰富的API接口，可以根据自己的需求选择相应的接口。

WxJava中常用API：

获取access_token：access_token是调用微信公众平台API的全局唯一凭证，通过获取access_token可以进行后续的API调用。

用户管理：包括用户信息的获取、设置备注名、拉黑用户等。

创建自定义菜单：创建自定义菜单，包括点击事件、跳转URL等。自定义菜单是指将公众号的功能以菜单形式展现给用户，方便用户快速访问公众号的各项功能。

模板消息：通过调用模板消息API可以向用户发送预设的模板消息，方便公众号进行消息推送，包含文字、链接、图片等。

素材管理：素材可以是图文消息、图片、语音、视频等多种类型，通过调用素材管理API可以实现对素材的上传、获取和删除等操作。

消息管理：通过客服接口发送文本、图片、语音、视频等消息给用户。同理，用户向公众号发送消息，公众号向用户回复的消息。

网页授权：网页授权是指允许公众号获取用户在微信内的基本信息，并在网页中进行相关操作的功能。

JS-SDK：JS-SDK可以帮助公众号在网页中调用微信提供的一些基础服务，如分享、支付等。


        

          
        

        
        

          

          AI 代码解读

用户管理

用户管理提供了：更新用户备注名、获得用户信息、获得用户列表、查询用户标签列表、批量给用户添加标签、批量给用户移除标签等API

相关API

更新用户备注名

wxMpService.getUserService().userUpdateRemark(openid, "测试备注名");


        

          
        

        
        

          

          AI 代码解读

获得用户信息

String lang = "zh_CN"; //语言
WxMpUser user = wxMpService.getUserService().userInfo(openid,lang);


        

          
        

        
        

          

          AI 代码解读

获得用户列表

WxMpUserList wxUserList = wxMpService.getUserService().userList(next_openid);


        

          
        

        
        

          

          AI 代码解读

查询用户标签列表

List<Long> tags = wxMpService.getUserTagService().userTagList(openid);


        

          
        

        
        

          

          AI 代码解读

批量给用户添加标签

String[]openids,long tagid;
wxMpService.getUserTagService().batchTagging(tagid,openids);


        

          
        

        
        

          

          AI 代码解读

批量给用户移除标签

wxMpService.getUserTagService().batchUntagging(tagid,openids);


        

          
        

        
        

          

          AI 代码解读

使用示例

用户管理以使用获得用户列表API为例：

    @RequestMapping("/user")
    public String user() throws WxErrorException {
   
   
        // 可选，第一个拉取的OPENID，null为从头开始拉取
        String nextOpenid = null;
        // 获得用户列表,一次拉取调用最多拉取10000个关注者的OpenID
        WxMpUserList wxMpUserList = wxMpService.getUserService().userList(nextOpenid);
        log.info("wxMpUserList = {}", wxMpUserList);

        // 语言
        String lang = "zh_CN";
        List<String> openids = wxMpUserList.getOpenids();
        for (String openid : openids) {
   
   
            // 获得用户信息
            WxMpUser user = wxMpService.getUserService().userInfo(openid, lang);
            log.info("user = {}", user);

            // 更新用户备注名
            wxMpService.getUserService().userUpdateRemark(openid, "开发者");
        }

        return "OK";
    }


        

          
        

        
        

          

          AI 代码解读
        

      
      
wxMpUserList = {
   
   "total":1,"count":1,"openids":["oqIoX6A_aW-_VxMbfV3vn3N2_adc"],"nextOpenid":"oqIoX6A_aW-_VxMbfV3vn3N2_adc"}

user = {
   
   "subscribe":true,"openId":"oqIoX6A_aW-_VxMbfV3vn3N2_adc","nickname":"","language":"zh_CN","headImgUrl":"","subscribeTime":1682671274,"remark":"","groupId":0,"tagIds":[],"subscribeScene":"ADD_SCENE_OTHERS","qrScene":"0","qrSceneStr":""}


        

          
        

        
        

          

          AI 代码解读

二维码管理

二维码管理介绍

可以生成带参数的二维码，应用于为了满足用户渠道推广分析和用户帐号绑定等场景

用户扫描带场景值二维码时，可以推送以下两种事件：

如果用户未关注公众号，则用户可以关注公众号，关注后微信会将带场景值关注事件推送给开发者。

如果用户已关注公众号，在用户扫描后会自动进入会话，微信也会将带场景值扫描事件推送给开发者。


        

          
        

        
        

          

          AI 代码解读

二维码管理中有2种类型的二维码：

1、临时二维码

临时二维码是有过期时间的，最长可以设置为在二维码生成后的30天（即2592000秒）后过期，但能够生成较多数量。临时二维码主要用于帐号绑定等不要求二维码永久保存的业务场景

2、永久二维码

永久二维码是无过期时间的，但数量较少（目前为最多10万个）。永久二维码主要用于适用于帐号绑定、用户来源统计等场景。

创建二维码ticket

每次创建二维码ticket需要提供一个开发者自行设定的参数scene_id

// 临时ticket
WxMpQrCodeTicket ticket = wxMpService.getQrcodeService().qrCodeCreateTmpTicket(scene, expire_seconds);

// 永久ticket
WxMpQrCodeTicket ticket = wxMpService.getQrcodeService().qrCodeCreateLastTicket(scene);


        

          
        

        
        

          

          AI 代码解读

通过ticket换取二维码

获取二维码ticket后，开发者可用ticket换取二维码图片。请注意，本接口无须登录态即可调用。

// 创建二维码ticket
WxMpQrCodeTicket ticket = wxMpService.getQrcodeService().qrCodeCreate*();

// 获得在系统临时目录下的文件，需要自己保存使用，注意：临时文件夹下存放的文件不可靠，不要直接使用
File file = wxMpService.getQrcodeService().qrCodePicture(ticket);


        

          
        

        
        

          

          AI 代码解读
        

      
      
    @RequestMapping("/user")
    public String user() throws WxErrorException {
   
   
        WxMpQrCodeTicket ticket = wxMpService.getQrcodeService().qrCodeCreateTmpTicket("scene_id", 2592000);
        File file = wxMpService.getQrcodeService().qrCodePicture(ticket);
        log.info("file = {}", file);
        return file.getPath();
    }


        

          
        

        
        

          

          AI 代码解读
        

      
      
 ticket = {
   
   "ticket":"gQHz7zwAAAAAAAAAAS5odHRwOi8vd2VpeGluLnFxLmNvbS9xLzAySjhRY0VsRWFjbkUxaFN0UGhBY24AAgR2kEtkAwQAjScA","expireSeconds":2592000,"url":"http://weixin.qq.com/q/02J8QcElEacnE1hStPhAcn"}
 file = C:\Users\Admin\AppData\Local\Temp\wxjava-temp4795776614163231975\4063eff3-53d5-4227-9ee4-eff1be9201fa1918629243212569901.jpg


        

          
        

        
        

          

          AI 代码解读

获取二维码ticket后，开发者可用ticket换取二维码图片。请注意，本接口无须登录态即可调用

https://mp.weixin.qq.com/cgi-bin/showqrcode?ticket=TICKET


        

          
        

        
        

          

          AI 代码解读

接收消息

接收事件推送

实现一个接收关注、取消关注事件推送的处理。

@Component
public class SubscribeHandler implements WxMpMessageHandler {
   
   
    @Override
    public WxMpXmlOutMessage handle(WxMpXmlMessage wxMessage, Map<String, Object> context, WxMpService wxMpService, WxSessionManager sessionManager) throws WxErrorException {
   
   
        return WxMpXmlOutMessage.TEXT().fromUser(wxMessage.getToUser()).toUser(wxMessage.getFromUser())
                .content("欢迎关注XX公众号").build();
    }
}


        

          
        

        
        

          

          AI 代码解读
        

      
      
@Component
@Slf4j
public class UnSubscribeHandler implements WxMpMessageHandler {
   
   
    @Override
    public WxMpXmlOutMessage handle(WxMpXmlMessage wxMessage, Map<String, Object> context, WxMpService wxMpService, WxSessionManager sessionManager) throws WxErrorException {
   
   
        return WxMpXmlOutMessage.TEXT().fromUser(wxMessage.getToUser()).toUser(wxMessage.getFromUser())
                .content("注意：已经取消关注，即使回复消息也不会收到").build();
    }
}


        

          
        

        
        

          

          AI 代码解读
        

      
      
@Configuration
public class MessageRouterConfig {
   
   
    @Autowired
    private WxMpService wxMpService;

    @Autowired
    private SubscribeHandler subscribeHandler;

    @Autowired
    private UnSubscribeHandler unSubscribeHandler;

    @Bean
    public WxMpMessageRouter messageRouter() {
   
   
        // 创建消息路由
        final WxMpMessageRouter router = new WxMpMessageRouter(wxMpService);
        // 订阅事件
        router.rule().async(false).msgType(WxConsts.XmlMsgType.EVENT).event(WxConsts.EventType.SUBSCRIBE).handler(subscribeHandler).end();
        // 取消订阅事件
        router.rule().async(false).msgType(WxConsts.XmlMsgType.EVENT).event(WxConsts.EventType.UNSUBSCRIBE).handler(unSubscribeHandler).end();
        return router;
    }
}


        

          
        

        
        

          

          AI 代码解读
        

      
      
    @RequestMapping("send")
    public String configAccess(@RequestBody String requestBody, @RequestParam("signature") String signature, @RequestParam("timestamp") String timestamp, @RequestParam("nonce") String nonce) {
   
   
        if (!wxMpService.checkSignature(timestamp, nonce, signature)) {
   
   
            log.error("签名校验 ===》 非法请求");
            return null;
        }
        WxMpXmlMessage xmlMessage = WxMpXmlMessage.fromXml(requestBody);
        WxMpXmlOutMessage outMessage = null;
        try {
   
   
            outMessage = wxMpMessageRouter.route(xmlMessage);
        } catch (Exception e) {
   
   
            log.error("消息路由异常", e);
        }
        return outMessage == null ? null : outMessage.toXml();
    }


        

          
        

        
        

          

          AI 代码解读

image.png

群发接口

文本消息

    @RequestMapping("send")
    public String send() throws WxErrorException {
   
   
        WxMpMassOpenIdsMessage massMessage = new WxMpMassOpenIdsMessage();
        massMessage.setMsgType(WxConsts.MassMsgType.TEXT);
        massMessage.setContent("文本消息内容文本消息内容文本消息内容文本消息内容文本消息内容文本消息内容");
        // 用户openid 扫描`测试号二维码`可以得到
        massMessage.getToUsers().add("oqIoX6A_aW-_VxMbfV3vn3N2_adc");
        // 针对异常：errcode: 40130，具体异常请参考文末异常项
        massMessage.getToUsers().add("");

        WxMpMassSendResult massResult = wxMpService.getMassMessageService().massOpenIdsMessageSend(massMessage);
        return "OK";
    }


        

          
        

        
        

          

          AI 代码解读

image.png

图片消息

    @RequestMapping("send")
    public String send() throws WxErrorException {
   
   
        File file = new File("D://test.png");

        WxMediaUploadResult uploadMediaRes = null;
        try (
                FileInputStream fileInputStream = new FileInputStream(file);
        ) {
   
   
            uploadMediaRes = wxMpService.getMaterialService().mediaUpload(WxConsts.MediaFileType.IMAGE, "jpg", fileInputStream);
        } catch (Exception e) {
   
   
            e.printStackTrace();
            return "Fail";
        }


        WxMpMassOpenIdsMessage massMessage = new WxMpMassOpenIdsMessage();
        massMessage.setMsgType(WxConsts.MassMsgType.IMAGE);
        massMessage.setMediaId(uploadMediaRes.getMediaId());
        // 用户openid 扫描`测试号二维码`可以得到
        massMessage.getToUsers().add("oqIoX6A_aW-_VxMbfV3vn3N2_adc");
        // errcode: 40130
        massMessage.getToUsers().add("");

        WxMpMassSendResult massResult = wxMpService.getMassMessageService().massOpenIdsMessageSend(massMessage);
        log.info("massResult ===》 {}", massResult);
        return "OK";
    }


        

          
        

        
        

          

          AI 代码解读

image.png

异常

在测试群发接口时，出现以下异常：

Servlet.service() for servlet [dispatcherServlet] in context with path [] threw exception [Request processing failed; nested exception is me.chanjar.weixin.common.error.WxRuntimeException: javax.net.ssl.SSLException: java.lang.RuntimeException: Unexpected error: java.security.InvalidAlgorithmParameterException: the trustAnchors parameter must be non-empty] with root cause


java.security.InvalidAlgorithmParameterException: the trustAnchors parameter must be non-empty
  at java.security.cert.PKIXParameters.setTrustAnchors(PKIXParameters.java:200) ~[na:1.8.0_41]
  at java.security.cert.PKIXParameters.<init>(PKIXParameters.java:120) ~[na:1.8.0_41]
  at java.security.cert.PKIXBuilderParameters.<init>(PKIXBuilderParameters.java:104) ~[na:1.8.0_41]


        

          
        

        
        

          

          AI 代码解读

因为群发的用户数用户有两个或两个以上，由于本公众号只有一个关注用户，所以报错。

me.chanjar.weixin.common.error.WxErrorException: 错误代码：40130, 错误信息：invalid openid list size, at least two openid rid: 644a404f-092ae85f-012852f0，微信原始报文：{
   
   "errcode":40130,"errmsg":"invalid openid list size, at least two openid rid: 644a404f-092ae85f-012852f0"}


        

          
        

        
        

          

          AI 代码解读
        

      
      
me.chanjar.weixin.common.error.WxErrorException: 错误代码：40017, 错误信息：不合法的按钮类型，微信原始报文：{
   
   "errcode":40017,"errmsg":"invalid button type rid: 644b41e9-28e5a17e-0983ff62"}


        

          
        

        
        

          

          AI 代码解读

模板消息、业务通知

通过调用模板消息API可以向用户发送预设的模板消息，方便公众号进行消息推送等。

配置消息模板

创建微信模板

模板标题：系统异常通知

模板内容：

服务名称:   {
   
   {
   
   keyword1.DATA}} 
IP和端口:   {
   
   {
   
   keyword2.DATA}}
异常内容:   {
   
   {
   
   keyword3.DATA}} 
异常时间:   {
   
   {
   
   keyword4.DATA}} 

系统异常，请及时处理。


        

          
        

        
        

          

          AI 代码解读

image.png

业务通知实现

    @RequestMapping("send")
    public String send() {
   
   
        WxMpTemplateMessage templateMessage = WxMpTemplateMessage.builder()
                // 用户openid 扫描`测试号二维码`可以得到
                .toUser("oqIoX6A_aW-_VxMbfV3vn3N2_adc")
                // 模板id
                .templateId(templateId)
                //点击消息要访问的网址
                .url("https://baidu.com/")
                .build();

        templateMessage.addData(new WxMpTemplateData("keyword1", "user服务", "#000000"))
                .addData(new WxMpTemplateData("keyword2", "192.168.30.30:8080"))
                .addData(new WxMpTemplateData("keyword3", "获取数据失败"))
                .addData(new WxMpTemplateData("keyword4", LocalDateTime.now()+""));
        try {
   
   
            // 发送模板消息
            wxMpService.getTemplateMsgService().sendTemplateMsg(templateMessage);
        } catch (WxErrorException e) {
   
   
            e.printStackTrace();
        }
        return "OK";
    }


        

          
        

        
        

          

          AI 代码解读

image.png

自定义菜单管理

创建自定义菜单，包括点击事件、跳转URL等。自定义菜单是指将公众号的功能以菜单形式展现给用户，方便用户快速访问公众号的各项功能。

AIP介绍

自定义菜单使用2个核心对象：

WxMenu：菜单对象

WxMenuButton：按钮对象


        

          
        

        
        

          

          AI 代码解读

创建自定义菜单

包括新增和修改，修改相当于覆盖之前的菜单。

WxMenu wxMenu = new WxMenu();


        

          
        

        
        

          

          AI 代码解读

设置菜单

wxMpService.getMenuService().menuCreate(wxMenu);


        

          
        

        
        

          

          AI 代码解读

删除自定义菜单

wxMpService.getMenuService().menuDelete();


        

          
        

        
        

          

          AI 代码解读

获得自定义菜单

WxMenu wxMenu = wxMpService.getMenuService().menuGet();


        

          
        

        
        

          

          AI 代码解读

传递JSON参数

    @GetMapping("createMenu")
    public String createMenu() throws WxErrorException {
   
   
        String json="{\"button\": [{\"name\": \"点击\",\"type\": \"click\",\"key\": \"1\"},{\"name\": \"跳转\",\"type\": \"view\",\"url\": \"http://www.baidu.com\"}]}";
        // 创建按钮
        wxMpService.getMenuService().menuCreate(json);

        // 获取菜单信息
        WxMpGetSelfMenuInfoResult selfMenuInfo = wxMpService.getMenuService().getSelfMenuInfo();
        log.info("selfMenuInfo : {}", selfMenuInfo);

        return "OK";
    }


        

          
        

        
        

          

          AI 代码解读

image.png

传递对象参数

    @GetMapping("createMenu")
    public String createMenu() throws WxErrorException {
   
   
        // 创建菜单对象
        WxMenu menu = new WxMenu();

        // 创建按钮A
        WxMenuButton button_a = new WxMenuButton();
        button_a.setType(WxConsts.MenuButtonType.CLICK);
        button_a.setName("按钮A");
        button_a.setKey("BUTTON_A");

        // 创建按钮A的子按钮1
        WxMenuButton button_a_1 = new WxMenuButton();
        button_a_1.setType(WxConsts.MenuButtonType.VIEW);
        button_a_1.setName("子按钮1");
        button_a_1.setUrl("https://www.baidu.com");
        // 将子按钮添加到按钮A
        button_a.getSubButtons().add(button_a_1);

        // 创建按钮A的子按钮2
        WxMenuButton button_a_2 = new WxMenuButton();
        button_a_2.setType(WxConsts.MenuButtonType.CLICK);
        button_a_2.setName("子按钮2");
        button_a_2.setKey("BUTTON_A_2");
        button_a.getSubButtons().add(button_a_2);

        // 创建按钮B
        WxMenuButton button_b = new WxMenuButton();
        button_b .setType(WxConsts.MenuButtonType.CLICK);
        button_b.setName("按钮B");
        button_b.setKey("BUTTON_B");

        // 将按钮A和按钮B添加到菜单
        menu.getButtons().add(button_a);
        menu.getButtons().add(button_b);

        // 创建按钮
        wxMpService.getMenuService().menuCreate(menu);

        // 获取菜单信息
        WxMpGetSelfMenuInfoResult selfMenuInfo = wxMpService.getMenuService().getSelfMenuInfo();
        log.info("selfMenuInfo : {}", selfMenuInfo);

        return "OK";
    }


        

          
        

        
        

          

          AI 代码解读

image.png

OAuth2网页授权

流程时序图

微信网页授权流程时序图如下：
image.png

相关API说明

构造网页授权url

wxMpService.getOAuth2Service().buildAuthorizationUrl(url, WxConsts.OAuth2Scope.SNSAPI_USERINFO, null)


        

          
        

        
        

          

          AI 代码解读

获得access token

WxOAuth2AccessToken wxOAuth2AccessToken = wxMpService.getOAuth2Service().getAccessToken(code);


        

          
        

        
        

          

          AI 代码解读

获得用户基本信息

WxOAuth2UserInfo wxMpUser = wxMpService.getOAuth2Service().getUserInfo(wxMpOAuth2AccessToken, null);


        

          
        

        
        

          

          AI 代码解读

刷新access token

WxOAuth2AccessToken = wxMpService.getOAuth2Service().refreshAccessToken(wxOAuth2AccessToken.getRefreshToken());


        

          
        

        
        

          

          AI 代码解读

验证access token

boolean valid = wxMpService.getOAuth2Service().validateAccessToken(wxOAuth2AccessToken);


        

          
        

        
        

          

          AI 代码解读

构造网页授权url

首先构造网页授权url，然后构成超链接让用户点击：

  /**
     * 构造网页授权url
     *
     * @return
     */
    @GetMapping("authPage")
    public String authPage() {
   
   
        WxOAuth2Service oAuth2Service = wxMpService.getOAuth2Service();
        String callbackUrl = "https://*.zicp.fun/callback";
        // 构建授权url
        String url = oAuth2Service.buildAuthorizationUrl(callbackUrl, WxConsts.OAuth2Scope.SNSAPI_USERINFO, null);
        return url;
    }


        

          
        

        
        

          

          AI 代码解读

获得access token

当用户同意授权后，会回调所设置的url并把authorization code传过来，然后用这个code获得access token，其中也包含用户的openid等信息

    /**
     * 用户确认授权后的回调处理
     */
    @GetMapping("callback")
    public WxOAuth2UserInfo callback(String code) throws WxErrorException {
   
   
        WxOAuth2Service oAuth2Service = wxMpService.getOAuth2Service();
        // 利用code获取accessToken
        WxOAuth2AccessToken accessToken = oAuth2Service.getAccessToken(code);
        // 利用accessToken获取用户信息
        WxOAuth2UserInfo userInfo = oAuth2Service.getUserInfo(accessToken, null);
        return userInfo;
    }


        

          
        

        
        

          

          AI 代码解读
        

      
      
    @GetMapping("createMenu")
    public String createMenu() throws WxErrorException {
   
   
        // 创建菜单对象
        WxMenu menu = new WxMenu();

        // 创建按钮A
        WxMenuButton button_a = new WxMenuButton();
        button_a.setType(WxConsts.MenuButtonType.VIEW);
        button_a.setName("授权登录");
        button_a.setUrl("https://*.zicp.fun/authPage");

        // 创建按钮B
        WxMenuButton button_b = new WxMenuButton();
        button_b .setType(WxConsts.MenuButtonType.CLICK);
        button_b.setName("按钮B");
        button_b.setKey("BUTTON_B");

        // 将按钮A和按钮B添加到菜单
        menu.getButtons().add(button_a);
        menu.getButtons().add(button_b);

        // 创建按钮
        wxMpService.getMenuService().menuCreate(menu);

        return "OK";
    }


        

          
        

        
        

          

          AI 代码解读

image.png

执行测试

在进行OAuth2网页授权测试过程中，获取构造网页授权url，遇到如下异常：
image.png

需要再公众号开发平台设置网页回调域名地址

image.png

image.png

当填写网页回调授权域名地址后，再次获取构造网页授权url，结果如下：
image.png

将得到的构造网页授权url发送到公众号，然后点击该链接，进入到用户授权详情页，用户同意后则将获得access token
image.png

利用accessToken获取用户信息，具体用户信息格式如下

image.png

文章标签：
Java
API
数据格式
开发者
JSON
小程序
关键词：
API开发
微信api
微信公众平台开发
微信开发微信
API微信开发
CodeDevMaster
+关注
29文章1问答
目录
打赏
0
1
3
1
11
分享
相关文章
一个幽默的程序员
|
14天前
|
人工智能 测试技术 API
Apifox对比Apipost：2025年推荐的API协作工具
Apifox与Apipost这两大国产API平台的全方位较量，助你在2025年做出最明智的选择。
一个幽默的程序员
89 2
游客mass6jalwg5qm
|
2月前
|
自动驾驶 程序员 API
告别重复繁琐！Apipost参数描述库让API开发效率飙升！
在API开发中，重复录入参数占用了42%的时间，不仅效率低下还易出错。Apipost推出的参数描述库解决了这一痛点，通过智能记忆功能实现参数自动填充，如版本号、分页控制、用户信息等常用字段，大幅减少手动输入。支持Key-Value与Raw-Json格式导入，一键提取响应结果至文档，将创建20参数接口文档时间从18分钟缩短至2分钟。相比Postman需手动搜索变量，Apipost的参数复用响应速度仅0.3秒，且支持跨项目共享与实时纠错，真正实现“一次定义，终身受益”。
游客mass6jalwg5qm
58 2
WBKJ_Noah18870292986
|
2月前
|
缓存 安全 API
API 接口开发与合理利用：构建高效、安全、可维护的数字桥梁
本文全面解析API接口的设计、优化与安全维护。API作为系统间交互的标准化契约，核心价值在于解耦系统、提升复用性和构建开放生态。设计时需遵循六大原则：明确输入输出、关注单一职责、实现自我表达、确保功能无重叠、保障幂等性及合理版本化。性能优化从批量处理、异步调用、并行执行等方面入手，同时结合缓存、池化技术和SQL优化提升效率。安全性涵盖加密传输、加签验签、Token认证、防重放攻击及限流熔断等十大要点。最后，通过文档自动生成、日志体系和版本管理确保接口可持续迭代。优秀的API应以契约优先、演进思维和防御心态为核心，成为系统的数字资产，支持内外部高效协作与生态建设。
WBKJ_Noah18870292986
95 1
游客mass6jalwg5qm
|
2月前
|
JSON 安全 Java
什么是用于REST API的JWT Bearer令牌以及如何通过代码和工具进行调试
在Web开发中，保护REST API至关重要，而JSON Web令牌（JWT）特别是JWT Bearer令牌，是一种高效方法。它通过紧凑、自包含的结构实现安全信息交换，提升用户体验。本文探讨JWT Bearer的基本概念、结构与实现，包括在Java中的应用步骤，以及使用Apipost和cURL进行测试的方法。JWT优势明显：无状态、互操作性强，适用于分布式系统。掌握JWT Bearer，可助开发者构建更安全、高效的API解决方案。
游客mass6jalwg5qm
99 2
WBKJ_Noah18870292986
|
3月前
|
存储 供应链 监控
1688商品数据实战：API搜索接口开发与供应链分析应用
本文详细介绍了如何通过1688开放API实现商品数据的获取与应用，涵盖接入准备、签名流程、数据解析存储及商业化场景。开发者可完成智能选品、价格监控和供应商评级等功能，同时提供代码示例与问题解决方案，确保法律合规与数据安全。适合企业开发者快速构建供应链管理系统。
WBKJ_Noah18870292986
247 0
卓伊凡
|
3月前
|
安全 API Swift
如何在苹果内购开发中获取App Store Connect API密钥-共享密钥理解内购安全-优雅草卓伊凡
如何在苹果内购开发中获取App Store Connect API密钥-共享密钥理解内购安全-优雅草卓伊凡
卓伊凡
160 15
如何在苹果内购开发中获取App Store Connect API密钥-共享密钥理解内购安全-优雅草卓伊凡
游客4ajxjr2o23cj2
|
2月前
|
前端开发 测试技术 API
2025年API开发必备：10款优秀Postman替代工具大盘点
API测试在现代开发中至关重要，Postman虽为首选，但市场上涌现出许多优秀替代工具。本文精选2025年10款好评如潮的API测试工具：Apifox、Insomnia、Hoppscotch、Paw、Talend API Tester、HTTPie、ARC、Swagger UI、SoapUI和Thunder Client。这些工具各具特色，满足不同需求，如团队协作、开源易用、自动化测试等。无论是简洁轻量还是功能全面，总有一款适合你的团队，助力效率提升。
游客4ajxjr2o23cj2
263 5
游客mass6jalwg5qm
|
2月前
|
存储 人工智能 API
离线VS强制登录？Apipost与Apifox的API工具理念差异深度解析
在代码开发中，工具是助手还是枷锁？本文通过对比Apipost和Apifox在断网环境下的表现，探讨API工具的选择对开发自由度的影响。Apifox强制登录限制了离线使用，而Apipost支持游客模式与本地存储，尊重开发者数据主权。文章从登录策略、离线能力、协作模式等方面深入分析，揭示工具背后的设计理念与行业趋势，帮助开发者明智选择，掌握数据控制权并提升工作效率。
游客mass6jalwg5qm
178 19
寻仙
|
27天前
|
人工智能 自然语言处理 JavaScript
关于API调用速率问题，能否增大一些？另外我想基于其开发实际场景应用，不知是否提供一些相关支持
这是一个关于开源多语言切换项目的简介：作者开发了一款自动为网页提供多语言切换的开源项目，已广泛应用于众多网站和项目。该项目现已对接通义千问（qwen3），但由于接口速度限制成为瓶颈，希望阿里云能提高请求速率。此外，作者询问是否能获得阿里支持，例如提升接口速率、用户推荐分成、以及文档展示支持等，以进一步推广多语言能力至更多应用场景。项目地址：https://github.com/xnx3/translate
寻仙
66 0
游客mass6jalwg5qm
|
2月前
|
安全 Java API
什么是用于 REST API 的 Bearer Token以及如何通过代码和工具进行调试
Bearer Token 是一种基于 OAuth 2.0 的身份验证机制，广泛应用于 REST API 的授权访问中。它通过在 HTTP 请求头中传递令牌，确保用户凭据安全传输并验证。本文深入解析了 Bearer Token 的概念、实现步骤及调试方法，包括其无状态特性、灵活性与安全性优势。同时，提供了 Java 实现示例和使用 Apipost、cURL 等工具测试的实践指导，帮助开发者掌握这一核心技能，保障 API 系统的安全与高效运行。
游客mass6jalwg5qm
231 1

热门文章

最新文章

  • 1
    开发者必备：阿里云百炼 API 调用图文教程
    210
  • 2
    从 OpenAPI 到 MCP：让企业 API 在 AI 助手中焕发新生
    52
  • 3
    狂揽7.5k星！这款开源API网关彻底解放开发者：一键聚合GPT-4、Suno、Midjourney，还能在线充值！
    18
  • 4
    微服务引擎 MSE 及 API 网关 2025 年 4 月产品动态
    23
  • 5
    阿里云微服务引擎 MSE 及 API 网关 2025 年 4 月产品动态
    32
  • 6
    抖音电商新篇章：douyin.item_video API接口的介绍
    24
  • 7
    手把手教你抓取京东商品评论：API 接口解析与 Python 实战
    22
  • 8
    淘宝商品详情API接口解析与 Python 实战指南
    29
  • 9
    1688商品详情API实战：Python调用全流程与数据解析技巧
    19
  • 10
    小红书笔记详情API接口如何使用
    22
  • 1
    微信小程序开发者账号注册流程
    32
  • 2
    【通义灵码 2.5 + Qwen3 + MCP Sever】AI总结微信提取聊天记录！再也不怕错过重要信息！
    394
  • 3
    小程序微信分享功能如何开发？开放平台已绑定仍不能使用的问题？-优雅草卓伊凡
    281
  • 4
    gewe微信机器人搭建教程
    70
  • 5
    9.2K Star！微信排版从未如此简单，这款开源神器让Markdown飞入公众号！
    81
  • 6
    微信百度字节小程序包过大解决方案（实战经验总结）-优雅草卓伊凡|果果|小无
    101
  • 7
    一键部署开源Qwen3并集成到钉钉、企业微信
    146
  • 8
    AppFlow：企业微信使用Qwen3自动回复
    79
  • 9
    WePush 一款基于模拟点击实现的微信消息推送机器人，安全稳定不封号
    103
  • 10
    一年撸完百万行代码，企业微信的全新鸿蒙NEXT客户端架构演进之路
    114

    • 相关电子书

    更多
  • 微信广告引擎与播放节奏算法实践
  • 微信H5视频播放器在海量业务下的实践
  • 微信高效运维之路

    • 相关实验场景

    更多
  • 基于Assistant Api的旅游助手
  • 快速体验智能体API应用
    • 下一篇
    NAT网关操作与使用|学习笔记
    目录