RequestHeader
با مجموعهها، منظم بمانید
ذخیره و طبقهبندی محتوا براساس اولویتهای شما.
شی هدر که روی تمام درخواست های ارسال شده به سرور تعریف می شود.
نمایندگی JSON |
---|
{
"requestId": string,
"requestTimestamp": string,
"userLocale": string,
"protocolVersion": {
object (Version )
}
} |
فیلدها |
---|
requestId | string مورد نیاز : شناسه منحصر به فرد این درخواست. این رشته ای است که حداکثر طول آن 100 کاراکتر است و فقط شامل کاراکترهای "az"، "AZ"، "0-9"، ":"، "-"، و "_" است. |
requestTimestamp | string ( int64 format) الزامی است : مهر زمانی این درخواست به عنوان میلی ثانیه از آن دوره نشان داده شده است. گیرنده باید تأیید کند که این مُهر زمانی ± 60 ثانیه «اکنون» است. این مهر زمانی درخواست پس از تلاش مجدد بی تاثیر نیست. |
userLocale (deprecated) | string منسوخ شده : کد زبان ISO 639-2 آلفا 3 دو یا سه حرفی که به صورت اختیاری با خط فاصله و کد کشور ISO 3166-1 آلفا-2، به عنوان مثال، «pt-BR»، «fil» یا 'fil-PH'. از این برای کمک به هدایت فیلدهای userMessage در پاسخ استفاده کنید. |
protocolVersion | object ( Version ) مورد نیاز : نسخه این درخواست. |
نسخه
شئ نسخه که شکلی ساختار یافته از ساختار نسخه کلاسیک abc
است. نسخههای اصلی همین تعداد تضمین میشوند که سازگار باشند. توجه داشته باشید که اصلاحات جزئی و جزئی می توانند اغلب و بدون اطلاع قبلی تغییر کنند. یکپارچه کننده باید از همه درخواست ها برای یک نسخه اصلی پشتیبانی کند.
نمایندگی JSON |
---|
{
"major": integer,
"minor": integer,
"revision": integer
} |
فیلدها |
---|
major | integer مورد نیاز : نسخه اصلی. این برای درخواستهای سازگاری با نسخههای مختلف علامتگذاری شده است و تضمین نمیشود که سازگار باشند. |
minor | integer مورد نیاز : نسخه کوچک. این نشان دهنده رفع اشکال قابل توجه است. |
revision | integer مورد نیاز : نسخه کوچک. این نشان دهنده رفع اشکال جزئی است. |
کلیه حقوق محفوظ است. Java علامت تجاری ثبتشده Oracle و/یا شرکتهای وابسته به آن است.
تاریخ آخرین بهروزرسانی 2025-07-25 بهوقت ساعت هماهنگ جهانی.
[[["درک آسان","easyToUnderstand","thumb-up"],["مشکلم را برطرف کرد","solvedMyProblem","thumb-up"],["غیره","otherUp","thumb-up"]],[["اطلاعاتی که نیاز دارم وجود ندارد","missingTheInformationINeed","thumb-down"],["بیشازحد پیچیده/ مراحل بسیار زیاد","tooComplicatedTooManySteps","thumb-down"],["قدیمی","outOfDate","thumb-down"],["مشکل ترجمه","translationIssue","thumb-down"],["مشکل کد / نمونهها","samplesCodeIssue","thumb-down"],["غیره","otherDown","thumb-down"]],["تاریخ آخرین بهروزرسانی 2025-07-25 بهوقت ساعت هماهنگ جهانی."],[[["The RequestHeader object, present in all server requests, includes crucial details like request ID, timestamp, and protocol version."],["`requestId` is a unique alphanumeric identifier, limited to 100 characters, using \"a-z\", \"A-Z\", \"0-9\", \":\", \"-\", and \"_\"."],["`requestTimestamp`, in milliseconds since epoch, must be within ± 60 seconds of the current time for server acceptance."],["The `protocolVersion` object uses a structured format (`major.minor.revision`) to ensure compatibility across major versions while acknowledging potential changes in minor and revision numbers."],["While `userLocale` was initially intended for language preferences, it's deprecated and no longer functional."]]],["Requests to the server require a header object, including a `requestId` (unique string identifier), `requestTimestamp` (milliseconds since epoch, within 60s of current time), and `protocolVersion`. The `userLocale` field is deprecated and ignored. The `protocolVersion` is a structured `major.minor.revision` version number. Major versions guarantee compatibility, while minor and revision changes can happen without notice. All requests must support the same major version.\n"]]