又拍云代理接口使用简明教程

这里主要是简单介绍下如何使用又拍云的接口，这里只是简单说下使用方法。

在看这个教程前，你应当是已经拿到了又拍云提供的账号级的 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"
}