Method: projects.locations.endpoints.submitTransaction

Envía una transacción a la red. Primero, se valida que la solicitud sea correcta en términos básicos. Si la validación falla, la solicitud fallará de inmediato. Si la validación se realiza correctamente, este método solo se muestra después de que la transacción se replicó en la mayoría de los validadores de la red o hasta que falla la solicitud.

Solicitud HTTP


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

Las URL usan la sintaxis de transcodificación gRPC.

Parámetros de ruta de acceso

Parámetros
endpoint

string

Obligatorio. Es el extremo al que se envía la transacción. 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 
{
  "serializedSignedTransaction": string
}
Campos
serializedSignedTransaction

string (bytes format)

Obligatorio. Es un SignedTransaction serializado en protobuf que se enviará al libro de registros. 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 el endpoint de endpoints.submitTransaction.

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 enviada. Es la representación hexadecimal del resumen SHA-256 de serializedSignedTransaction. 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.