Method: projects.locations.endpoints.submitOperationalTransaction

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

בקשת HTTP


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

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

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

פרמטרים
endpoint

string

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

היקפי הרשאות

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

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

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