Method: projects.locations.endpoints.submitOperationalTransaction

Invia una transazione operativa alla rete. Questo metodo restituisce un risultato solo dopo che la transazione è stata replicata nella maggior parte dei validator della rete o se la transazione non va a buon fine.

Richiesta HTTP


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

Gli URL utilizzano la sintassi di transcodifica gRPC.

Parametri di percorso

Parametri
endpoint

string

Obbligatorio. L'endpoint per gestire la richiesta. 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 
{
  "serializedSignedOperationalTransaction": string
}
Campi
serializedSignedOperationalTransaction

string (bytes format)

Obbligatorio. Un SignedTransaction serializzato protobuf da inviare al ledger. La transazione del cliente allegata deve essere una transazione operativa e il mittente deve essere l'operatore della piattaforma. L'utilizzo di un formato serializzato garantisce che tutti i validator calcolino lo stesso ID transazione del digest SHA-256 dei byte serializzati.

Una stringa con codifica in base64.

Corpo della risposta

Messaggio di risposta per endpoints.submitOperationalTransaction.

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 operativa inviata. È la rappresentazione esadecimale del digest SHA-256 di serializedSignedOperationalTransaction. 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.

Autorizzazioni IAM

Richiede la seguente autorizzazione IAM per la risorsa endpoint:

  • universalledger.endpoints.submit

Per saperne di più, consulta la documentazione di IAM.