Method: projects.locations.endpoints.submitOperationalTransaction

Envía una transacción operativa a la red. Este método solo devuelve un valor después de que la transacción se replicó en la mayoría de los validadores de la red o si la transacción falla.

Solicitud HTTP


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

Las URL usan la sintaxis de transcodificación gRPC.

Parámetros de ruta de acceso

Parámetros
endpoint

string

Obligatorio. Es el extremo para entregar la solicitud. Formato: projects/{project}/locations/{location}/endpoints/{endpoint} La ubicación es una región.

Cuerpo de la solicitud

El cuerpo de la solicitud contiene datos con la siguiente estructura:

Representación JSON 
{
  "serializedSignedOperationalTransaction": string
}
Campos
serializedSignedOperationalTransaction

string (bytes format)

Obligatorio. Es un SignedTransaction serializado en protobuf que se enviará al libro de registros. La transacción del cliente incluida debe ser operativa, y el remitente debe ser el operador de la plataforma. El uso de un formato serializado garantiza que todos los validadores calculen el mismo ID de transacción que el resumen SHA-256 de los bytes serializados.

Es una cadena codificada en Base64.

Cuerpo de la respuesta

Es el mensaje de respuesta para endpoints.submitOperationalTransaction.

Si se ejecuta correctamente, el cuerpo de la respuesta contiene datos con la siguiente estructura:

Representación JSON 
{
  "transactionDigestHex": string
}
Campos
transactionDigestHex

string

Es el identificador que representa de forma única la transacción operativa enviada. Es la representación hexadecimal del resumen SHA-256 de serializedSignedOperationalTransaction. Este ID de transacción se proporciona para que un cliente pueda hacer un seguimiento de la transacción sin necesidad de implementar la lógica de hash por sí mismo. El identificador se puede usar directamente en llamadas posteriores a la API, por ejemplo, para consultar el estado de la transacción.

Permisos de autorización

Requiere el siguiente permiso de OAuth:

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

Para obtener más información, consulta Authentication Overview.