这里主要是简单介绍下如何使用又拍云的接口,这里只是简单说下使用方法。
在看这个教程前,你应当是已经拿到了又拍云提供的账号级的 token 以及 api 文档
那么我这里以 postman 来进行演示,首先,你需要对某个接口做什么操作,应当先读一遍接口的文档和熟悉相关参数。
此外,你可以去后台打开控制台,创建与接口相对于的功能,看下调用的接口和传的数据是什么,这样更方便你熟悉接口的参数是如何传的。打个比方,我现在要创建一个又拍云源模式的直播服务。
可以先打开控制台,并且打开开发者模式,切换到network
,观察你每做一步所发起的请求中的 payload里的数据是什么。
那么我们创建一个直播服务,我们看下需要填写一些参数,把这些参数传入后点击创建,客户端会向API 接口发起请求,这个时候你看下都发了哪些数据就可以了。
那么我们可以看到,客户端先调用api/buckets接口创建一个直播类型的服务
数据如下
{
"bucket_name": "testzb2019",
"type": "ucdn",
"business_type": "live"
}
当创建完服务后,调用了 srs 接口
我们可以在 requests payload中查看
数据如下
{
"bucket_name": "testzb2019",
"transport": "push",
"domains": [
{
"domain": "play.zb2.v5linux.com",
"type": "down"
},
{
"domain": "push.zb2.v5linux.com",
"type": "up"
}
]
}
那么你直接复制过去改下就可以了,另外要注意的就是 api 接口不要填错,并且数据格式是要json 格式的
通常来说,你的请求头中需要包含
- Content-Type:application/json
- Authorization: Bearer token
创建成功会返回 true,失败会有详细的错误信息返回,比如我没有调用buckets 接口创建直播类型的服务而是直接调用了 srs 接口创建直播服务
会提示我需要先创建一个直播类型的服务
{
"type": "BucketNotFound",
"error_code": "21905",
"request": "PUT /srs",
"field": "undefined",
"message": "please create live type bucket first"
}