Method: projects.locations.endpoints.submitTransaction

Invia una transazione alla rete. La richiesta viene prima convalidata per verificarne la correttezza di base. Se la convalida non va a buon fine, la richiesta non verrà eseguita immediatamente. Se la convalida va a buon fine, questo metodo restituisce un valore solo dopo che la transazione è stata replicata nella maggior parte dei validatori della rete o fino a quando la richiesta non va a buon fine.

Richiesta HTTP


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

Gli URL utilizzano la sintassi della transcodifica gRPC.

Parametri del percorso

Parametri
endpoint

string

Obbligatorio. L'endpoint a cui inviare la transazione. Formato: projects/{project}/locations/{location}/endpoints/{endpoint} La località è una regione.

Corpo della richiesta

Il corpo della richiesta contiene dati con la seguente struttura:

Rappresentazione JSON 
{
  "serializedSignedTransaction": string
}
Campi
serializedSignedTransaction

string (bytes format)

Obbligatorio. Un SignedTransaction serializzato in protobuf da inviare al ledger. L'utilizzo di un formato serializzato garantisce che tutti i validatori calcolino lo stesso ID transazione come digest SHA-256 dei byte serializzati.

Una stringa con codifica in base64.

Corpo della risposta

Messaggio di risposta per endpoints.submitTransaction.

In caso di esito positivo, il corpo della risposta contiene dati con la seguente struttura:

Rappresentazione JSON 
{
  "transactionDigestHex": string
}
Campi
transactionDigestHex

string

Identificatore che rappresenta in modo univoco la transazione inviata. È la rappresentazione esadecimale del digest SHA-256 di serializedSignedTransaction. Questo ID transazione viene fornito in modo che un client possa monitorare la transazione senza dover implementare la logica di hashing. L'identificatore può essere utilizzato direttamente nelle chiamate API successive, ad esempio per eseguire query sullo stato della transazione.

Ambiti di autorizzazione

Richiede il seguente ambito OAuth:

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

Per saperne di più, consulta la Authentication Overview.