Method: projects.locations.endpoints.submitOperationalTransaction

向网络提交操作事务。只有在交易已复制到网络中的大多数验证节点，或者交易失败后，此方法才会返回。

HTTP 请求


POST https://universalledger.googleapis.com/v1/{endpoint=projects/*/locations/*/endpoints/*}:submitOperationalTransaction

网址使用 gRPC 转码语法。

路径参数

参数
endpoint

string

必需。用于处理请求的端点。格式：projects/{project}/locations/{location}/endpoints/{endpoint} 位置是一个区域。

请求正文

请求正文中包含结构如下的数据：

JSON 表示法 
{
  "serializedSignedOperationalTransaction": string
}
字段
serializedSignedOperationalTransaction

string (bytes format)

必需。要提交到账本的 protobuf 序列化 SignedTransaction。随附的客户端交易必须是运营交易，并且发送方必须是平台运营商。使用序列化格式可确保所有验证器计算出的交易 ID 与序列化字节的 SHA-256 摘要相同。

使用 base64 编码的字符串。

响应正文

针对 endpoints.submitOperationalTransaction 的响应消息。

如果成功，响应正文将包含结构如下的数据：

JSON 表示法 
{
  "transactionDigestHex": string
}
字段
transactionDigestHex

string

唯一标识所提交的操作交易的标识符。它是 serializedSignedOperationalTransaction 的 SHA-256 摘要的十六进制表示形式。提供此交易 ID 是为了让客户端能够跟踪交易，而无需自行实现哈希逻辑。该标识符可直接用于后续 API 调用，例如查询交易状态。

授权范围

需要以下 OAuth 范围：

  • https://www.googleapis.com/auth/cloud-platform

如需了解详情，请参阅 Authentication Overview。

IAM 权限

需要拥有 endpoint 资源的以下 IAM 权限：

  • universalledger.endpoints.submit

如需了解详情，请参阅 IAM 文档。