华为云用户手册

区块链服务 BCS-申请数据集:请求示例

请求示例 { "orgID" : "ce0ac69b0c8648cd25b44a551780409767c8890b", "channelID" : "mychannel", "cryptoMethod" : "SW", "cert" : "-----BEGIN CERTIFICATE-----\\n...\\n-----END CERTIFICATE-----", "sk" : "-----BEGIN PRIVATE KEY-----\\n...\\n-----END PRIVATE KEY-----", "timestamp" : "2020-10-27T17:28:16+08:00", "consumer" : "did:example:3TMWx8owKHARgNwbj4ywmG", "orderSeq" : "1", "provider" : "did:example:DHkJjyD5wZwya6sd6BNBnG", "productID" : "product2", "reason" : "apply dataset for AI", "consumerName" : "user1" }

区块链服务 BCS
区块链服务 BCS-申请数据集:响应示例

响应示例状态码： 200 订单信息 { "consumer" : "did:example:3TMWx8owKHARgNwbj4ywmG", "consumerName" : "Tyler", "orderSeq" : "1", "provider" : "did:example:DHkJjyD5wZwya6sd6BNBnG", "providerName" : "hw", "productID" : "product1", "productName" : "prodname1", "price" : "0", "applyTime" : "1607332359", "encryptedAesKey" : "BNGhPwjaTgpM+V7czzw1i4mH21KKN+XLKXHLqVsRIfybUCncqZNfomkRfzX4WEHj+oty1X9oCd4h6xMnRvs8BWE5Tvg6BJ6QTW/km9EO/FSYqzJf2GqQzAleAcLJrTBZ3LRbPaF87CgJ114ae7R+VK9VvfXQ8exuH2KMRD305dXieGpM4VPVv9u1BbL15Jpd/g==", "status" : "ready", "reason" : "I want product1", "lockProof" : "" } 状态码： 500 失败响应 { "errorCode" : " BCS .5002046", "errorMsg" : "Incorrect number of arguments" }

区块链服务 BCS
区块链服务 BCS-申请数据集:请求参数

请求参数表1 请求Body参数参数是否必选参数类型描述 orgID 是 String 组织id channelID 是 String 通道id cryptoMethod 是 String 加密方法，目前固定为SW cert 是 String 证书 sk 是 String 私钥 timestamp 是 String 时间戳 consumer 是 String 订单申请者身份标识 orderSeq 是 String 订单序列号 provider 是 String 数据集发布者身份标识 productID 是 String 数据集产品id reason 否 String 申请原因 consumerName 否 String 数据集申请者名称

区块链服务 BCS
区块链服务 BCS-申请数据集:响应参数

响应参数状态码： 200 表2 响应Body参数参数参数类型描述 consumer String 订单消费者身份标识 consumerName String 订单消费者名称 orderSeq String 订单序列号 provider String 订单提供者身份标识 providerName String 订单提供者名称 productID String 数据集产品id productName String 数据集产品名称 price String 订单价钱 applyTime String 订单申请时间 encryptedAesKey String 密钥 status String 订单状态 reason String 订单申请原因 lockProof String 订单锁定证明 creatorDID String 流程创建者DID，如果没有加入任何流程，为“” processID String 当前订单所属流程ID，如果没有加入任何流程，为“” 状态码： 500 表3 响应Body参数参数参数类型描述 errorCode String 错误码 errorMsg String 错误描述

区块链服务 BCS
区块链服务 BCS-查询订单列表:响应示例

响应示例状态码： 200 订单分页信息 { "items" : [ { "consumer" : "did:example:3TMWx8owKHARgNwbj4ywmG", "consumerName" : "Tyler", "orderSeq" : "1", "provider" : "did:example:DHkJjyD5wZwya6sd6BNBnG", "providerName" : "hw", "productID" : "product1", "productName" : "prodname1", "price" : "0", "applyTime" : "1607332359", "encryptedAesKey" : "BNGhPwjaTgpM+V7czzw1i4mH21KKN+XLKXHLqVsRIfybUCncqZNfomkRfzX4WEHj+oty1X9oCd4h6xMnRvs8BWE5Tvg6BJ6QTW/km9EO/FSYqzJf2GqQzAleAcLJrTBZ3LRbPaF87CgJ114ae7R+VK9VvfXQ8exuH2KMRD305dXieGpM4VPVv9u1BbL15Jpd/g==", "status" : "ready", "reason" : "I want product1", "lockProof" : "" } ], "pagination" : { "currentPage" : 1, "pageSizeNum" : 100, "totalItems" : 10 } } 状态码： 500 失败响应 { "errorCode" : "B CS .5002046", "errorMsg" : "Incorrect number of arguments" }

区块链服务 BCS
区块链服务 BCS-查询订单列表:响应参数

响应参数状态码： 200 表2 响应Body参数参数参数类型描述 items Array of DataOrderResponse objects 列表 pagination PaginationResp object 分页信息表3 DataOrderResponse 参数参数类型描述 consumer String 订单消费者身份标识 consumerName String 订单消费者名称 orderSeq String 订单序列号 provider String 订单提供者身份标识 providerName String 订单提供者名称 productID String 数据集产品id productName String 数据集产品名称 price String 订单价钱 applyTime String 订单申请时间 encryptedAesKey String 密钥 status String 订单状态 reason String 订单申请原因 lockProof String 订单锁定证明 creatorDID String 流程创建者DID，如果没有加入任何流程，为“” processID String 当前订单所属流程ID，如果没有加入任何流程，为“” 表4 PaginationResp 参数参数类型描述 currentPage Integer 当前页码 pageSizeNum Integer 每页条数 totalItems Integer 总条数状态码： 500 表5 响应Body参数参数参数类型描述 errorCode String 错误码 errorMsg String 错误描述

区块链服务 BCS
区块链服务 BCS-查询订单列表:请求参数

请求参数表1 请求Body参数参数是否必选参数类型描述 orgID 是 String 组织id channelID 是 String 通道id cryptoMethod 是 String 加密方法，目前固定为SW cert 是 String 证书 sk 是 String 私钥 timestamp 是 String 时间戳 currentPage 否 String 分页参数：当前页码（默认1） pageSizeNum 否 String 分页参数：每页条数(默认100) provider 否 String 过滤条件：订单中数据集发布者身份标识 searchText 否 String 过滤条件：匹配关键字（订单的产品名称） status 否 String 过滤条件：订单状态（ready、finished、failed、canceled） consumer 否 String 过滤条件：订单消费者身份标识

区块链服务 BCS
区块链服务 BCS-查询订单列表:请求示例

请求示例 { "orgID" : "ce0ac69b0c8648cd25b44a551780409767c8890b", "channelID" : "mychannel", "cryptoMethod" : "SW", "cert" : "-----BEGIN CERTIFICATE-----\\n...\\n-----END CERTIFICATE-----", "sk" : "-----BEGIN PRIVATE KEY-----\\n...\\n-----END PRIVATE KEY-----", "timestamp" : "2020-10-27T17:28:16+08:00", "currentPage" : "string", "pageSizeNum" : "string", "provider" : "string", "searchText" : "string", "status" : "string", "consumer" : "did:example:3TMWx8owKHARgNwbj4ywmG" }

区块链服务 BCS
区块链服务 BCS-查询文件操作记录

查询文件操作记录接口方法 func (bc *BsClient) GetFileOperation(fileName, startTime, endTime string) ([]*bstore.StorageEvent, error) 参数说明参数类型说明 fileName string 查询的链上文件名。 startTime string 查询记录的起始时间（秒时间戳）。 endTime string 查询记录的结束时间（秒时间戳）返回值类型说明 []*StorageEvent 文件操作记录列表，每条操作记录包含操作者、操作类型、时间数据。 error 查询成功返回类型为nil，反之返回error。父主题：其他查询

区块链服务 BCS
区块链服务 BCS-ABE用户密钥解密数据:请求参数

请求参数表1 请求Body参数参数是否必选参数类型描述 orgID 是 String 组织id channelID 是 String 通道id cryptoMethod 是 String 加密方法,目前固定为SW cert 是 String 证书 sk 是 String 私钥 timestamp 是 String 时间戳 encryptData 是 String 数据密文，当onChainStore设置为“true”时，可不输入 applyer 是 String 申请者的身份标识 provider 是 String 授权者的身份标识 orderSeq 否 String 订单序列号，当onChainStore为true时，订单序列号必填。 onChainStore 否 String 数据密文是否在链上存储，可设置为“true”或“false”，默认为“false”。如果设置为“true”，则不需要输入encryptData，可自动在链上获取数据密文

区块链服务 BCS
区块链服务 BCS-ABE用户密钥解密数据:请求示例

请求示例 { "orgID" : "ce0ac69b0c8648cd25b44a551780409767c8890b", "channelID" : "mychannel", "cryptoMethod" : "SW", "cert" : "-----BEGIN CERTIFICATE-----\\n...\\n-----END CERTIFICATE-----", "sk" : "-----BEGIN PRIVATE KEY-----\\n...\\n-----END PRIVATE KEY-----", "timestamp" : "2020-10-27T17:28:16+08:00", "encryptData" : "string", "onChainStore" : "false", "applyer" : "did:example:Mb4SshJeN5ukWXkbMJK8xC", "provider" : "did:example:Mb4SshJeN5ukWXkbMJK8xC" }

区块链服务 BCS
区块链服务 BCS-查询区块块高

查询区块块高消息构建。接口方法 func (msg *QueryRawMessage) BuildLatestChainStateRawMessage(chainID string) (*common.RawMessage, error) 参数说明参数类型说明 chainID string 链ID。返回值类型说明 *common.RawMessage 查询链状态需要发送的消息 error 查询成功返回类型为nil，反之返回error。消息发送。接口方法 QueryAction.class func (action *QueryAction) GetLatestChainState(rawMsg *common.RawMessage) (*common.RawMessage, error) 参数说明参数类型说明 rawMsg *common.RawMessage 上述查询链状态消息。返回值类型说明 *common.RawMessage 用于获取包含发送结果的消息。 error 发送成功返回类型为nil，反之返回error。父主题：其他查询

区块链服务 BCS
区块链服务 BCS-授权数据集:响应示例

响应示例状态码： 200 订单信息 { "consumer" : "did:example:3TMWx8owKHARgNwbj4ywmG", "consumerName" : "Tyler", "orderSeq" : "1", "provider" : "did:example:DHkJjyD5wZwya6sd6BNBnG", "providerName" : "hw", "productID" : "product1", "productName" : "prodname1", "price" : "0", "applyTime" : "1607332359", "encryptedAesKey" : "BNGhPwjaTgpM+V7czzw1i4mH21KKN+XLKXHLqVsRIfybUCncqZNfomkRfzX4WEHj+oty1X9oCd4h6xMnRvs8BWE5Tvg6BJ6QTW/km9EO/FSYqzJf2GqQzAleAcLJrTBZ3LRbPaF87CgJ114ae7R+VK9VvfXQ8exuH2KMRD305dXieGpM4VPVv9u1BbL15Jpd/g==", "status" : "ready", "reason" : "I want product1", "lockProof" : "" } 状态码： 500 失败响应 { "errorCode" : "BCS.5002046", "errorMsg" : "Incorrect number of arguments" }

区块链服务 BCS
区块链服务 BCS-授权数据集:请求示例

请求示例 { "orgID" : "ce0ac69b0c8648cd25b44a551780409767c8890b", "channelID" : "mychannel", "cryptoMethod" : "SW", "cert" : "-----BEGIN CERTIFICATE-----\\n...\\n-----END CERTIFICATE-----", "sk" : "-----BEGIN PRIVATE KEY-----\\n...\\n-----END PRIVATE KEY-----", "timestamp" : "2020-10-27T17:28:16+08:00", "consumer" : "did:example:3TMWx8owKHARgNwbj4ywmG", "orderSeq" : "1" }

区块链服务 BCS
区块链服务 BCS-授权数据集:请求参数

请求参数表1 请求Body参数参数是否必选参数类型描述 orgID 是 String 组织id channelID 是 String 通道id cryptoMethod 是 String 加密方法，目前固定为SW cert 是 String 证书 sk 是 String 私钥 timestamp 是 String 时间戳 consumer 是 String 订单申请者身份标识 orderSeq 是 String 订单序列号

区块链服务 BCS
区块链服务 BCS-授权数据集:响应参数

响应参数状态码： 200 表2 响应Body参数参数参数类型描述 consumer String 订单消费者身份标识 consumerName String 订单消费者名称 orderSeq String 订单序列号 provider String 订单提供者身份标识 providerName String 订单提供者名称 productID String 数据集产品id productName String 数据集产品名称 price String 订单价钱 applyTime String 订单申请时间 encryptedAesKey String 密钥 status String 订单状态 reason String 订单申请原因 lockProof String 订单锁定证明 creatorDID String 流程创建者DID，如果没有加入任何流程，为“” processID String 当前订单所属流程ID，如果没有加入任何流程，为“” 状态码： 500 表3 响应Body参数参数参数类型描述 errorCode String 错误码 errorMsg String 错误描述

区块链服务 BCS
区块链服务 BCS-修改订单状态:请求示例

请求示例 { "orgID" : "ce0ac69b0c8648cd25b44a551780409767c8890b", "channelID" : "mychannel", "cryptoMethod" : "SW", "cert" : "-----BEGIN CERTIFICATE-----\\n...\\n-----END CERTIFICATE-----", "sk" : "-----BEGIN PRIVATE KEY-----\\n...\\n-----END PRIVATE KEY-----", "timestamp" : "2020-10-27T17:28:16+08:00", "consumer" : "did:example:3TMWx8owKHARgNwbj4ywmG", "orderSeq" : "1", "orderStatus" : 0, "reason" : "string" }

区块链服务 BCS
区块链服务 BCS-修改订单状态:请求参数

请求参数表1 请求Body参数参数是否必选参数类型描述 orgID 是 String 组织id channelID 是 String 通道id cryptoMethod 是 String 加密方法，目前固定为SW cert 是 String 证书 sk 是 String 私钥 timestamp 是 String 时间戳 consumer 是 String 订单申请者身份标识 orderSeq 是 String 订单序列号 orderStatus 是 Integer 设置订单状态（0完成，1失败，2取消） reason 否 String 原因

区块链服务 BCS
区块链服务 BCS-SDK配置

SDK配置 linux环境，SDK的编译、运行，需要手动下载并配置openssl，单击链接下载openssl[链接] 解压openssl，复制openssl文件夹到目录/usr/local/include/下执行库的导入命令：export LD_LIBRARY_PATH=/usr/local/include/openssl 引用SDK的步骤如下：单击链接下载Go SDK[链接]。解压到应用程序所在目录，具体可参考Go应用程序开发的示例Demo。父主题： Go SDK介绍

区块链服务 BCS
区块链服务 BCS-根据索引查询可验证凭证:响应参数

响应参数状态码： 200 表2 响应Body参数参数参数类型描述 context String 内容 sequence String 颁发机构对应凭证的序列号 type Array of strings 可验证凭证类型 issuer String 签发者身份标识 issuanceDate String 签发日期 expirationDate String 凭证有效期 credentialSubject CredentialSubject object 凭证主题 revocation Revocation object 撤销表3 CredentialSubject 参数参数类型描述 owner String 申请者的身份标识 type String 凭证类型 schemaID String schema ID dataURI String 数据URI encryptedAeskey String 加密对称密钥 uriType String 数据索引类型 dataHash String 数据hash值表4 Revocation 参数参数类型描述 id String 撤销API或者撤销列表的url type String 撤销类型状态码： 500 表5 响应Body参数参数参数类型描述 errorCode String 错误码最小长度：8 最大长度：36 errorMsg String 错误描述最小长度：2 最大长度：512

区块链服务 BCS
区块链服务 BCS-根据索引查询可验证凭证:请求示例

请求示例 { "orgID" : "4f1439758ebb41f7411b5f684b67713c08b89198", "channelID" : "mychannel", "cryptoMethod" : "SW", "cert" : "-----BEGIN CERTIFICATE-----\n...\n...\n-----END CERTIFICATE-----", "sk" : "------BEGIN PRIVATE KEY-----\n...\n...\n-----END PRIVATE KEY-----", "timestamp" : "2020-10-27T17:28:16+08:00", "vcIndex" : 0 }

区块链服务 BCS
区块链服务 BCS-根据索引查询可验证凭证:响应示例

响应示例状态码： 200 VerifiableCredential Information { "context" : "https://www.w3.org/2018/credentials/v1", "sequence" : "x00123456", "type" : [ "VerifiableCredential", "AlumniCredential" ], "issuer" : "https://example.edu/issuers/565049", "issuanceDate" : "1606720551", "expirationDate" : "1606720551", "credentialSubject" : { "owner" : "did:example:ebfeb1f712ebc6f1c276e12ec21", "type" : "professional", "schemaID" : "did:example:ebfeb1f712ebc6f1c276e12ec21_IDCard", "dataURI" : "string", "encryptedAeskey" : "string", "uriType" : "index", "dataHash" : "e3b0c44298fc1c149afbf4c8996fb92427ae41e4649b934ca495991b7852b85" }, "revocation" : { "id" : "string", "type" : "string" } } 状态码： 500 失败响应 { "errorCode" : "stringst", "errorMsg" : "string" }

区块链服务 BCS
区块链服务 BCS-根据索引查询可验证凭证:请求参数

请求参数表1 请求Body参数参数是否必选参数类型描述 orgID 是 String 组织id channelID 是 String 通道id cryptoMethod 是 String 加密方法，目前固定为SW cert 是 String 用户证书，每行末尾均需要增加显式换行符\n sk 是 String 用户私钥，每行末尾均需要增加显式换行符\n timestamp 是 String 时间戳 vcIndex 是 String 凭证索引

区块链服务 BCS
区块链服务 BCS-查询凭证模板:响应示例

响应示例状态码： 200 CredentialSchema Information { "creator" : "string", "title" : "string", "identifier" : "string", "attributes" : [ { "name" : "name", "type" : "someType", "description" : "Identity number" } ], "version" : 0 } 状态码： 500 失败响应 { "errorCode" : "stringst", "errorMsg" : "string" }

区块链服务 BCS
区块链服务 BCS-查询凭证模板:请求参数

请求参数表1 请求Body参数参数是否必选参数类型描述 orgID 是 String 组织id channelID 是 String 通道id cryptoMethod 是 String 加密方法，目前固定为SW cert 是 String 用户证书，每行末尾均需要增加显式换行符\n sk 是 String 用户私钥，每行末尾均需要增加显式换行符\n timestamp 是 String 时间戳 schemaIndex 是 String schema索引

区块链服务 BCS
区块链服务 BCS-查询凭证模板:请求示例

请求示例 { "orgID" : "4f1439758ebb41f7411b5f684b67713c08b89198", "channelID" : "mychannel", "cryptoMethod" : "SW", "cert" : "-----BEGIN CERTIFICATE-----\n...\n...\n-----END CERTIFICATE-----", "sk" : "------BEGIN PRIVATE KEY-----\n...\n...\n-----END PRIVATE KEY-----", "timestamp" : "2020-10-27T17:28:16+08:00", "schemaIndex" : "1" }

区块链服务 BCS
区块链服务 BCS-查询凭证模板:响应参数

响应参数状态码： 200 表2 响应Body参数参数参数类型描述 creator String 创建者身份标识 title String 名称 identifier String 凭证模板标识 attributes Array of Attribute objects 属性信息 version Integer 版本表3 Attribute 参数参数类型描述 name String 名称 type String 类型 description String 描述信息状态码： 500 表4 响应Body参数参数参数类型描述 errorCode String 错误码最小长度：8 最大长度：36 errorMsg String 错误描述最小长度：2 最大长度：512

区块链服务 BCS
区块链服务 BCS-注册DID:请求参数

请求参数表1 请求Body参数参数是否必选参数类型描述 orgID 是 String 组织id channelID 是 String 通道id cryptoMethod 是 String 加密方法，目前固定为SW cert 是 String 用户证书，每行末尾均需要增加显式换行符\n sk 是 String 用户私钥，每行末尾均需要增加显式换行符\n timestamp 是 String 时间戳

区块链服务 BCS
区块链服务 BCS-注册DID:请求示例

请求示例 { "orgID" : "4f1439758ebb41f7411b5f684b67713c08b89198", "channelID" : "channel", "cryptoMethod" : "SW", "cert" : "-----BEGIN CERTIFICATE-----\n...\n...\n-----END CERTIFICATE-----", "sk" : "------BEGIN PUBLIC KEY-----\n...\n...\n-----END PUBLIC KEY-----", "timestamp" : "2020-10-27T17:28:16+08:00" }

区块链服务 BCS
区块链服务 BCS-文件上链

文件上链接口方法 func (bc *BsClient) UploadFile(filePath, fileName string) (*UploadFileResponse, error) 参数说明参数类型说明 filePath string 待上链文件在本地的路径。当前支持不大于100MB的任意格式文件。 fileName string 文件在链上的名称。不允许包含 "/"。返回值类型说明 *UploadFileResponse 文件上链返回信息。 error 上链成功返回类型为nil，反之返回error。父主题： Go SDK介绍

区块链服务 BCS

共100000条

undefined

意见反馈

0/200

提交取消

提交成功！非常感谢您的反馈，我们会继续努力做到更好反馈提交失败！请稍后重试！

华为云用户手册

7*24

备案

专业服务

退订

建议反馈

售前咨询热线