Method: projects.locations.endpoints.submitTransaction

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

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 enviará 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. Un SignedTransaction serializado de protobuf para enviar al libro mayor. 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.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 del 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.

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.