Method: projects.locations.endpoints.submitOperationalTransaction

Envía una transacción operativa a la red. Este método solo devuelve un resultado después de que la transacción se haya replicado 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. Un SignedTransaction serializado de protobuf para enviar al libro mayor. La transacción del cliente adjunta debe ser una transacción 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 inequívoca la transacción operativa enviada. Es la representación hexadecimal del resumen SHA-256 del 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.

Permisos de IAM

Se requiere el siguiente permiso de IAM en el recurso endpoint:

  • universalledger.endpoints.submit

Para obtener más información, consulta la documentación de IAM.