领取资料,咨询答疑,请➕wei: June__Go
上一小节我们学习了Postman保存请求至Collections集合的方法,本小节我们讲解一下Postman关联接口的调用方法。
1、关联接口说明
例如:有可能存在部分任务场景,或者部分API接口必须登录或者获取token后才能访问,设想一下,现在后端基本都是热更新框架,每次热更新都会清除Session,边开发边测试时,每次热更新后,都要先访问一下登录接口,再访问其他接口,有点繁琐。
2、关联接口的调用方法
下面我们使用钉钉开放接口进行演示,首先我们获取接口认证的access_token后,将其存入环境变量,然后通过创建公告接口入参引入access_token环境变量来创建钉钉公告。
步骤1:获取接口认证access_token
接口名称:获取钉钉企业内部应用的access_token
接口文档:获取企业内部应用的access_token - 钉钉开放平台
请求方式:GET
请求地址:https://oapi.dingtalk.com/gettoken
Query参数
名称 | 类型 | 是否必填 | 示例值 | 描述 |
appkey | String | 是 | dingeqqpkv3xxxx | 应用的唯一标识key。 |
appsecret | String | 是 | GT-lsu-taDAsTsxxxx | 应用的密钥。AppKey和AppSecret可在钉钉开发者后台的应用详情页面获取。 |
返回参数
名称 | 类型 | 示例值 | 描述 |
access_token | String | fw8ef8we8f76e6f7s8dxxxx | 生成的access_token。 |
expires_in | Number | 7200 | access_token的过期时间,单位秒。 |
errmsg | String | ok | 返回码描述。 |
errcode | Number | 0 | 返回码。 |
postman 获取钉钉企业内部应用的access_token接口调用如下:
步骤2:将上一步接口中获取的access_token,通过后置脚本,设置为全局变量,如下图
步骤3:通过创建公告接口入参引入access_token环境变量来创建钉钉公告
接口名称:创建公告
请求方式:POST
请求地址:https://oapi.dingtalk.com/topapi/blackboard/create
Query参数
名称 | 类型 | 是否必填 | 示例值 | 描述 |
access_token | String | 是 | 6d1bxxxx | 调用该接口的应用凭证。
|
Body参数
名称 | 类型 | 是否必填 | 示例值 | 描述 |
create_request | OapiCreateBlackboardVo | 是 | 请求对象。 | |
operation_userid | String | 是 | manager01 | 操作人的userId,必须是公告管理员。 |
author | String | 否 | 杨xx | 公告作者。 |
private_level | Number | 否 | 0 | 保密等级:
|
ding | Boolean | 否 | false | 是否发送应用内钉提醒:
|
blackboard_receiver | BlackboardReceiverOpenVo | 是 | 公告接收人。 | |
title | String | 是 | 入职须知 | 公告标题。 |
push_top | Boolean | 否 | true | 公告是否置顶。
|
content | String | 是 | 欢迎加入我们的大家庭 | 公告内容。 |
category_id | String | 否 | 987uy66t5rt54er | 公告分类ID。 |
coverpic_mediaid | String | 否 | @lADPDeC2ufXOeRzMqM0BLA | 封面图,格式为@mediaId。 可以通过上传媒体文件接口上传图片,获取media_id参数值。 |
返回参数
名称 | 类型 | 示例值 | 描述 |
result | Boolean | true | 是否创建成功。
|
success | Boolean | true | 本次调用是否成功。
|
errcode | Number | 0 | 返回码。 |
request_id | String | roz884n3k7rf | 请求ID。 |
postman创建公告接口调用(注意:入参中需要使用{{access_token}}的方式,来引用步骤2中设置的环境变量),如下图
以上我们在postman中就完成了两个有上下游关联关系接口调用。
最后感谢每一个认真阅读我文章的人,礼尚往来总是要有的,虽然不是什么很值钱的东西,如果你用得到的话可以直接拿走,希望可以帮助到大家!领取资料,咨询答疑,请➕wei: June__Go