Method: projects.locations.endpoints.submitTransaction

Mengirimkan transaksi ke jaringan. Permintaan pertama-tama divalidasi 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 Transcoding gRPC.

Parameter jalur

Parameter
endpoint

string

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

Isi permintaan

Isi permintaan memuat data dengan struktur berikut:

Representasi JSON 
{
  "serializedSignedTransaction": string
}
Kolom
serializedSignedTransaction

string (bytes format)

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

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 mewakili transaksi yang dikirimkan. ID ini adalah representasi heksadesimal dari ringkasan SHA-256 serializedSignedTransaction. 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.