Method: projects.locations.endpoints.submitTransaction

Envoie une transaction au réseau. La requête est d'abord validée pour vérifier qu'elle est correcte. Si la validation échoue, la requête échoue immédiatement. Si la validation réussit, cette méthode ne renvoie une réponse qu'une fois la transaction répliquée sur la majorité des validateurs du réseau ou jusqu'à ce que la requête échoue.

Requête HTTP


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

Les URL utilisent la syntaxe de transcodage gRPC.

Paramètres de chemin d'accès

Paramètres
endpoint

string

Obligatoire. Point de terminaison auquel envoyer la transaction. Format : projects/{project}/locations/{location}/endpoints/{endpoint} L'emplacement est une région.

Corps de la requête

Le corps de la requête contient des données présentant la structure suivante :

Représentation JSON 
{
  "serializedSignedTransaction": string
}
Champs
serializedSignedTransaction

string (bytes format)

Obligatoire. Un SignedTransaction protobuf sérialisé à envoyer au grand livre. L'utilisation d'un format sérialisé garantit que tous les validateurs calculent le même ID de transaction que le condensé SHA-256 des octets sérialisés.

Chaîne encodée en base64.

Corps de la réponse

Message de réponse pour endpoints.submitTransaction.

Si la requête aboutit, le corps de la réponse contient des données qui ont la structure suivante :

Représentation JSON 
{
  "transactionDigestHex": string
}
Champs
transactionDigestHex

string

Identifiant qui représente de manière unique la transaction envoyée. Il s'agit de la représentation hexadécimale du condensé SHA-256 de serializedSignedTransaction. Cet ID de transaction est fourni pour qu'un client puisse suivre la transaction sans avoir à implémenter lui-même la logique de hachage. L'identifiant peut être utilisé directement dans les appels d'API ultérieurs, par exemple pour interroger l'état de la transaction.

Niveaux d'accès des autorisations

Requiert le niveau d'accès OAuth suivant :

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

Pour plus d'informations, consultez la Authentication Overview.