Method: projects.locations.endpoints.submitTransaction

שליחת עסקה לרשת. קודם כל, המערכת בודקת שהבקשה תקינה. אם האימות נכשל, הבקשה תיכשל באופן מיידי. אם האימות מצליח, השיטה הזו מחזירה ערך רק אחרי שהעסקה משוכפלת ברוב מאמתים ברשת, או עד שהבקשה נכשלת.

בקשת HTTP


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

כתובות ה-URL כתובות בתחביר של gRPC Transcoding.

פרמטרים של נתיב

פרמטרים
endpoint

string

חובה. נקודת הקצה שאליה שולחים את העסקה. פורמט: projects/{project}/locations/{location}/endpoints/{endpoint} המיקום הוא אזור.

גוף הבקשה

גוף הבקשה מכיל נתונים במבנה הבא:

ייצוג ב-JSON 
{
  "serializedSignedTransaction": string
}
שדות
serializedSignedTransaction

string (bytes format)

חובה. ‫SignedTransaction שעבר סריאליזציה של protobuf כדי לשלוח אותו לספר החשבונות. שימוש בפורמט סדרתי מבטיח שכל כלי האימות יחשבו את אותו מזהה עסקה כגיבוב SHA-256 של הבייטים הסדרתיים.

מחרוזת בקידוד Base64.

גוף התשובה

הודעת תגובה ל-endpoints.submitTransaction.

אם הפעולה בוצעה ללא שגיאות, גוף התגובה יכיל נתונים במבנה הבא:

ייצוג ב-JSON 
{
  "transactionDigestHex": string
}
שדות
transactionDigestHex

string

מזהה שמייצג באופן ייחודי את העסקה שנשלחה. זהו הייצוג ההקסדצימלי של תקציר SHA-256 של serializedSignedTransaction. מזהה העסקה הזה מסופק כדי שהלקוח יוכל לעקוב אחרי העסקה בלי להטמיע בעצמו את לוגיקת הגיבוב. אפשר להשתמש במזהה ישירות בקריאות API הבאות, למשל כדי לשלוח שאילתה לגבי מצב העסקה.

היקפי הרשאות

נדרש היקף ההרשאות הבא של OAuth:

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

ניתן למצוא מידע נוסף כאן: Authentication Overview.