百度区块链引擎BBE

    申请创建通道

    申请创建通道

    接口描述:申请创建通道,发起申请后会发送审批,全部审批通过后不会立即创建,需要用户再点击“创建”按钮进行实际创建

    权限说明:请求发起人需要具有合法的AccessKeyID和SecretAccessKey才能发起请求。

    注意事项:如果请求中没有用户验证信息(即匿名访问),返回403 Forbidden,错误信息:AccessDenied

    请求(Request)

    • 请求语法

      POST /v1/fabric/consortiums/channels/create/apply HTTP/1.1
      Host: bbe.bj.baidubce.com
      x-bce-date: <x-bce-date>
      x-bce-request-id: <x-bce-request-id>
      Authorization: <Authorization>
    • 请求头域:除公共头域外,无其它特殊头域。
    • 请求参数

      名称 类型 位置 描述 是否必须
      consortiumUuid string Body参数 联盟链uuid 必须
      orgUuid string Body参数 创建通道的组织uuid 必须
      name string Body参数 通道名称
      支持大小写字母、数字、中文以及-_ /.特殊字符,不能以特殊字符开头,长度1-20
      必须
      englishName string Body参数 通道英文名称
      支持小写字母、数字以及-。必须以字母开头,长度1-16
      必须
      description string Body参数 通道描述 必须
      orgs []string Body参数 邀请加入组织uuid列表 必须

    响应(Response)

    • 响应头域:除公共头域外,无其它特殊头域。
    • 响应参数:
    名称 类型 描述
    channelUuid string 通道Uuid
    applicationUuid string 申请Uuid

    失败响应参考错误码部分。

    示例

    • 请求示例

      POST /v1/fabric/consortiums/channels/create/apply HTTP/1.1
      Host: bbe.bj.baidubce.com
      x-bce-date: 2019-10-29T08:25:20Z
      Authorization: bce-auth-v1/e38d78f7b74841ec92727531369834d8/2019-10-29T08:25:20Z/1800/host/56a2a8096f99d5b0fb38f7815b61f43f28b662f0bb49c3407386f932ab6550af
      
      {
      		"consortiumUuid": "6167a91e-0409-4038-a74c-22d6bad61f91",
      		"orgUuid":"bc197ef9-0c47-403a-829a-d537c7ee1fa4",
      		"name":"贸易通道",
      "englishName":"test-channel-liuxiong",
      		"description":"open api test",
      		"orgs": ["bc197ef9-0c47-403a-829a-d537c7ee1fa4"]
      }
    • 响应示例

      200
      Content-Length: 3153
      Content-Type: application/json; charset=utf-8
      Date: Fri, 04 Jan 2019 07:24:02 GMT
      
      {
          "data": {
              "channelUuid": "1206a499-14c2-4dbf-b0ba-e6716b46c169",
              "applicationUuid": "1206a499-14c2-4dbf-b0ba-e6716b46c169"
          }
      }
    上一篇
    联盟管理
    下一篇
    创建通道