如何使用Postman调试HMS Core推送接口？

Posted 2022-09-08 华为移动服务

HMS Core推送服务支持开发者使用HTTPS协议接入Push服务端。Postman是一款接口测试工具，它可以模拟用户发起的各类HTTP请求，将请求数据发送至服务端，获取对应的响应结果。Postman可以模拟开发者服务器申请Access Token，调用鉴权等接口的请求。

因此有很多开发者在测试端侧推送效果或定位推送问题时都会选择使用Postman测试推送接口。例如，开发者想使用接口推送测试消息但又不方便直接使用应用正式服务端推送时，就可以使用Postman模拟服务端的推送请求。或者服务端接口调试不通，又不确定是不是参数有问题，就可以用postman验证一下请求是否成功。本文将介绍使用Postman调用HMS Core推送接口的具体操作步骤。

一、Postman下载安装

下载地址：https://www.postman.com/downloads/，点击Download，下载对应版本，然后安装。本文使用的是v7.36.1版本。

如果网络使用了代理，需要给Postman配置代理（如网络没有代理，请忽略）：

1. 打开File菜单，点击Settings菜单，弹出设置界面。

2. 在设置界面选中Proxy，配置您的网络代理。

二、调用鉴权接口，获取Access Token。

接口说明文档

1. 在Postman新建一个Tab，输入接口地址，选择POST方式：

post地址：https://oauth-login.cloud.huawei.com/oauth2/v3/token

2. 选择body，勾选“x-www-form-urlencoded”，然后在下方列表里输入参数名称和对应的值。

三个参数说明如下：

grant_type——固定值“client_credentials”。

client_id——对于AppGallery Connect类应用，该值为应用中OAuth 2.0客户端ID（凭据）的Client ID。

client_secret——对于AppGallery Connect类应用，该值为应用中OAuth 2.0客户端ID（凭据）的Client Secret。

3. 点击send，就可以调用接口返回access_token了，如下图所示：

   

4. 保存调试配置，按下ctrl+s，输入名字“Get Token”，新建目录“push”，即可保存。

三、调用消息推送接口发送Push消息

接口说明文档

1. 在Postman新建一个Tab，输入接口地址（将[appid]替换为实际的appid），选择POST方式：

post地址：https://push-api.cloud.huawei.com/v1/[appId]/messages:send

2. 选择Authorization，TYPE选择“Bearer Token”，然后在Token输入框中输入二中获取的access_token，如下图：

3. 选择Body，选中“raw”，下拉框选择“JSON”，然后在下方输入框中复制消息内容，点击send，就可以发送消息了，如下图：

4. 保存调试配置，按下ctrl+s，输入名字“Send Message”，保存在目录“push”下即可。

四、使用Postman生成其他常用工具/语言的命令

使用Postman已有的调试成功的接口，可以自动生成其他工具的命令，如常用的cURL、Nodejs、Python、Ruby等，可以直接复制使用。

获取方式：在窗口右边，点击Code，即可弹出命令页面，可以选择自己需要的语言的命令。

最后附上使用Postman导出的实例文件，有需要的开发者可以直接导入测试。

了解更多详情>>

访问华为开发者联盟官网
获取开发指导文档
华为移动服务开源仓库地址：GitHub、Gitee

关注我们，第一时间了解 HMS Core 最新技术资讯~