Method: projects.locations.endpoints.submitOperationalTransaction

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

בקשת HTTP


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

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

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

פרמטרים
endpoint

string

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

גוף הבקשה

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

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

string (bytes format)

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

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

גוף התשובה

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

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

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

string

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

היקפי הרשאות

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

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

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

הרשאות IAM

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

  • universalledger.endpoints.submit

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