Method: projects.locations.endpoints.submitTransaction

Mengirimkan transaksi ke jaringan. Permintaan divalidasi terlebih dahulu untuk memastikan kebenaran dasarnya. Jika validasi gagal, permintaan akan langsung gagal. Jika validasi berhasil, metode ini hanya akan ditampilkan setelah transaksi direplikasi di sebagian besar validator dalam jaringan, atau hingga permintaan gagal.

Permintaan HTTP


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

URL menggunakan sintaksis gRPC Transcoding.

Parameter jalur

Parameter
endpoint

string

Wajib. Endpoint untuk mengirimkan transaksi. Format: projects/{project}/locations/{location}/endpoints/{endpoint} Lokasinya adalah wilayah.

Isi permintaan

Isi permintaan memuat data dengan struktur berikut:

Representasi JSON 
{
  "serializedSignedTransaction": string
}
Kolom
serializedSignedTransaction

string (bytes format)

Wajib. SignedTransaction yang diserialisasi protobuf untuk dikirimkan ke buku besar. Menggunakan format berserial memastikan bahwa semua validator menghitung ID transaksi yang sama sebagai ringkasan SHA-256 dari byte berserial.

String berenkode base64.

Isi respons

Pesan respons untuk endpoints.submitTransaction.

Jika berhasil, isi respons memuat data dengan struktur berikut:

Representasi JSON 
{
  "transactionDigestHex": string
}
Kolom
transactionDigestHex

string

ID yang secara unik merepresentasikan transaksi yang dikirimkan. Nilai ini adalah representasi heksadesimal ringkasan SHA-256 dari serializedSignedTransaction. ID transaksi ini diberikan 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.