94. تنظیمات ایجاد یا ویرایش Service Bus
تنظیمات اصلی شامل موارد زیر هستند:
| تنظیم | کاربرد |
|---|---|
| نام لاتین | نام Endpoint و شناسه قابل استفاده در URL |
| فعال | فعال/غیرفعال بودن سرویس |
| Anonymous | اجازه اجرای سرویس بدون Login/Token |
| کاربران مجاز | در حالت غیر Anonymous، فهرست Userهایی که Token آنها اجازه اجرای سرویس دارد |
| Request Method | انتخاب GET یا POST |
| Response Content Type | انتخاب application/json یا text/plain |
| توضیحات | متن توضیحی که در سند تولیدشده نمایش داده میشود |
| پارامترهای ورودی پیشفرض | مقدارهای ثابت Backend برای Parameterهای Provider |
95. GET و POST
Service Bus میتواند با Methodهای GET یا POST ساخته شود. انتخاب Method باید بر اساس قرارداد مصرف API انجام شود.
برای POST، سند سرویس ساختار Body را نمایش میدهد. نمونه Body میتواند به یکی از دو شکل زیر ارسال شود:
[
{ "Name": "FromUserId", "Value": "???" }
]
یا:
{
"FromUserId": "???"
}
در GET نیز پارامترهای قابل دریافت مطابق Contract همان سرویس در سند نهایی مشخص میشوند.
96. نوع خروجی JSON یا text/plain
برای هر Service Bus میتوان نوع محتوای پاسخ را انتخاب کرد:
application/json
text/plain
اگر application/json انتخاب شود، سند تولیدشده ساختار خروجی Provider را به شکل JSON نمایش میدهد.
نمونه:
[
{
"UserID": "(Int32)???",
"FullName": "(String)???"
}
]
اگر text/plain انتخاب شود، پاسخ بیرونی سرویس به شکل متن ارائه میشود و Consumer باید آن را مطابق Contract همان API تفسیر کند.