文档首页/ 可信跨链服务 TCS/ 开发指南/ 跨链交易/ 跨链查账本交易
更新时间：2021-12-30 GMT+08:00
查看PDF
分享

跨链查账本交易

功能介绍

跨链查询目标区块链的账本信息

URI

POST /v1/cross/ledger/query

请求参数

表1 请求Body参数

参数

是否必选

参数类型

描述

from_chaincode_id

是

String

源端链码名称

最小长度：1

最大长度：64

to_chain

是

String

目标端区块链ID

最小长度：1

最大长度：64

to_query_func_name

是

String

目标端查询函数，如:QueryBlock

最小长度：1

最大长度：64

args

是

Array of strings

查询账本所需要的参数列表。为数字字符串形式，如：[“1”]。

响应参数

状态码： 200

表2 响应Body参数

参数

参数类型

描述

code

String

成功响应码

data

DataPlayload object

响应链上数据
表3 DataPlayload

参数

参数类型

描述

message

String

响应信息

payload

String

链上信息

状态码： 400

表4 响应Body参数

参数

参数类型

描述

error_code

String

错误码

error_msg

String

错误信息

状态码： 500

表5 响应Body参数

参数

参数类型

描述

error_code

String

错误码

error_msg

String

错误信息

请求示例

{
  "from_chaincode_id" : "tcsexample",
  "to_chain" : "cexxaxef-1475-11xx-b225-0255xx10043x",
  "to_query_func_name" : "QueryBlock",
  "args" : [ "1" ]
}

响应示例

状态码： 200

请求成功

{
  "code" : "TCS.2000000",
  "data" : {
    "message" : "SUCCESS!",
    "payload" : "... -----BEGIN CERTIFICATE-----\n ... \n-----END CERTIFICATE-----\n ... "
  }
}

状态码： 400

请求不合法

{
  "error_code" : "TCS.4000001",
  "error_message" : "Invalid request args"
}

状态码： 500

请求失败

{
  "error_code" : "TCS.5000002",
  "error_message" : "Failed to send cross tx : Failed to sendPreCrossTransaction: Failed to preCrossRequest: Failed to Generate PreCrossRequest: Failed to get VerificationResponse from relay: rpc error: code = Unknown desc = Permission not granted: %!s(<nil>) "
}

状态码

状态码

描述

200

请求成功

400

请求不合法

500

请求失败
父主题： 跨链交易

相关文档