Method: projects.locations.endpoints.submitOperationalTransaction

Mengirimkan transaksi operasional ke jaringan. Metode ini hanya ditampilkan setelah transaksi direplikasi di sebagian besar validator dalam jaringan, atau jika transaksi gagal.

Permintaan HTTP


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

URL ini menggunakan sintaksis gRPC Transcoding.

Parameter jalur

Parameter
endpoint

string

Wajib. Endpoint untuk menyajikan permintaan. Format: projects/{project}/locations/{location}/endpoints/{endpoint} Lokasi adalah region.

Isi permintaan

Isi permintaan memuat data dengan struktur berikut:

Representasi JSON 
{
  "serializedSignedOperationalTransaction": string
}
Kolom
serializedSignedOperationalTransaction

string (bytes format)

Wajib. SignedTransaction yang diserialisasi protobuf untuk dikirim ke ledger. Transaksi klien yang disertakan harus berupa transaksi operasional, dan pengirimnya harus merupakan operator platform. Menggunakan format serial memastikan bahwa semua validator menghitung ID transaksi yang sama dengan ringkasan SHA-256 dari byte yang diserialisasi.

String berenkode base64.

Isi respons

Pesan respons untuk endpoints.submitOperationalTransaction.

Jika berhasil, isi respons memuat data dengan struktur berikut:

Representasi JSON 
{
  "transactionDigestHex": string
}
Kolom
transactionDigestHex

string

ID yang secara unik mewakili transaksi operasional yang dikirimkan. Ini adalah representasi heksadesimal dari ringkasan SHA-256 serializedSignedOperationalTransaction. ID transaksi ini disediakan agar klien dapat melacak transaksi tanpa perlu menerapkan logika hashing itu sendiri. ID dapat langsung digunakan dalam panggilan API berikutnya, misalnya untuk mengkueri status transaksi.

Cakupan otorisasi

Memerlukan cakupan OAuth berikut:

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

Untuk mengetahui informasi selengkapnya, lihat Authentication Overview.

Izin IAM

Memerlukan izin IAM berikut pada resource endpoint:

  • universalledger.endpoints.submit

Untuk mengetahui informasi selengkapnya, baca dokumentasi IAM.