1.3 接口调用案例讲解
本节主题:1.3 接口调用案例讲解
课程讲师:Charlie
观看地址:点我进入
1 本节要点
- 简道云API调用演示
- 第三方接口调用演示(钉钉)
- 第三方接口调用演示(阿里云API市场)
2 课前准备
无
3 课程内容
3.1 简道云API调用演示
简道云API文档地址:https://hc.jiandaoyun.com/open/10992
- 应用idappid
- 表单identryid = formid
- HOSThttps://api.jiandaoyun.com
- 路径根据具体接口进行选择
- URLhttps://api.jiandaoyun.com/api/v1/app/{app_id}/entry/{entry_id}/widgets
- 请求方式POST
- 请求头(Headers,进行鉴权,身份认证)
- 参数名是 Authorization
- 参数值 Bearer YOUR API KEY(你自己的API key)
- 请求参数(body 请求内容),请求参数格式均为JSON
- 错误码快速发现错误
- 示例
演示场景:调用查询单条数据API查询数据
{“data_id”:“5dd6740646357c0006e6eb6e”}
3.2 第三方接口调用演示
- 请求方式GET
- URLhttps://oapi.dingtalk.com/gettoken?appkey=xxxxxx&appsecret=xxxxxxxxx
- HOSThttps://oapi.dingtalk.com
- 路径/gettoken
- 请求参数(URL传参) appkey=xxxxxx&appsecret=xxxxxxxxx
阿里云API市场-接口调用演示:https://market.aliyun.com/products/56928004/cmapi027438.html
- 请求方式POST
- URLhttp://yuyintz.market.alicloudapi.com/ts/voiceNotifySms
- Query放在url后面,用url传参的形式去传递
- Headers参数名是Authorization,参数值是APPCODE AppCode值
注意:
POST的请求参数,要注意请求格式(是json、x-www-form-urlencoded 或 text等等),阿里云市场只给了返回数据的格式,未明确给出请求的格式,但是可以在请求示例里面找到!
4 课后了解方向
- 接口签名及鉴权机制
- 简道云的公共接口的鉴权方式采用Api key,只需在POST请求的Header中加上 Authorization: Bearer YOUR_APIKEY,但是可能有部分接口采用非常复杂的鉴权方式,这里使用POSTMAN较难实现,需要后期使用代码开发实现;
- 例如百度云:https://cloud.baidu.com/doc/Reference/s/Njwvz1wot