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. מזהה העסקה הזה מסופק כדי שהלקוח יוכל לעקוב אחרי העסקה בלי להטמיע את לוגיקת הגיבוב (hashing) בעצמו. אפשר להשתמש במזהה ישירות בקריאות הבאות ל-API, למשל כדי לשלוח שאילתה לגבי מצב העסקה.

היקפי הרשאות

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

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

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

הרשאות IAM

נדרשת הרשאת IAM הבאה במשאב endpoint:

  • universalledger.endpoints.submit

מידע נוסף זמין במאמרי העזרה בנושא IAM.