Method: projects.locations.endpoints.submitOperationalTransaction

Envoie une transaction opérationnelle au réseau. Cette méthode ne renvoie une valeur que lorsque la transaction a été répliquée sur la majorité des validateurs du réseau ou si elle échoue.

Requête HTTP


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

Les URL utilisent la syntaxe de transcodage gRPC.

Paramètres de chemin d'accès

Paramètres
endpoint

string

Obligatoire. Point de terminaison pour traiter la requête. 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 
{
  "serializedSignedOperationalTransaction": string
}
Champs
serializedSignedOperationalTransaction

string (bytes format)

Obligatoire. Un SignedTransaction protobuf sérialisé à envoyer au grand livre. La transaction client incluse doit être une transaction opérationnelle, et l'expéditeur doit être l'opérateur de la plate-forme. 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.submitOperationalTransaction.

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 opérationnelle envoyée. Il s'agit de la représentation hexadécimale du condensé SHA-256 de serializedSignedOperationalTransaction. 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.