Method: projects.locations.endpoints.submitTransaction

Envía una transacción a la red. Primero, se valida la solicitud para verificar su corrección básica. Si falla la validación, 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 haya replicado en la mayoría de los validadores de la red o hasta que falle 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 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. Es 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.

String codificada en base64.

Cuerpo de la respuesta

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

Identificador que representa de forma única la transacción enviada. Es la representación hexadecimal del resumen SHA-256 de serializedSignedTransaction. Se proporciona este ID de transacción 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.