بلوک عملکرد HTTP_REQUEST

بلوک عملکرد HTTP_REQUEST یک درخواست RAW برای رابط HTTP ایجاد می‌کند.

مهم: متغیر ارسالی از طریق رابط HTTP باید نوع داده RAW داشته باشد.

URI به عنوان یک متغیر در سمت راست زیر ارتباط تعریف می‌شود. اگر با یک / شروع شود، اولین / حذف خواهد شد. برای انجام درخواست بر روی دایرکتوری پایین‌ترین سطح، فقط متغیر / را می‌توان تعریف کرد.

بعضی از سرورهای وب نیاز به هدر User-Agent دارند. در غیر این صورت صفحه بارگیری نمی‌شود. این یک خطا از طرف Antcas Control نیست، بلکه یک مکانیسم حفاظتی از سمت مرورگر وب درخواست شده است. از ورودی Header با محتویات زیر استفاده کنید:

User-Agent: Mozilla/5.0 (Windows; U; Windows NT 5.1; en-US; rv:1.8.1.13) Gecko/20080311 Firefox/2.0.0.13

ورودی Method

ورودی روش انتقال را به عنوان رشته کاراکتر تعریف می‌کند. این می‌تواند برای مثال "GET", "POST", "PUT" و غیره باشد. اگر هیچ روشی تعریف نشده باشد، GET به عنوان پیش‌فرض انتخاب می‌شود.

ورودی Type

ورودی نوع هدر Content-Type را به عنوان رشته کاراکتر تعریف می‌کند. اگر ورودی تعریف نشده باشد، این وارد به هدر اضافه نمی‌شود.

ورودی Header

واردهای هدر اضافی را به عنوان رشته کاراکتر تعریف می‌کند. چندین هدر با یک خط جدید جدا می‌شوند. هدر Content-Length خودکاراً تعریف شده و هدر Content-Type با مقدار ورودی Type تعریف می‌شود.

ورودی Query

ورودی Query را به عنوان رشته کاراکتر تعریف می‌کند. Query مقدار پس از نشانه سوال است و معمولاً در درخواست‌های GET استفاده می‌شود.

http://server/uri?query

ساختار یک Query به این صورت است:

var1=wert1&var2=wert2&va...

برای اینکه مقادیر به درستی منتقل شوند، توصیه می‌شود که هر کدام از مقادیر را با بلوک عملکرد URL_ENCODE یا QUERY_ENCODE کدگذاری کنید، زیرا داده‌ها ممکن است ناقص منتقل شوند.

توجه: در صورت نیاز به انتقال حجم‌های بزرگتر از داده‌ها، طول حداکثر یک URL را در نظر بگیرید. اگر لازم باشد، از روش POST استفاده کنید و Query را به عنوان Content ارسال کنید.

ورودی Content

ورودی Content مانند ورودی Query است. اما داده‌ها پس از هدر منتقل می‌شوند و حجم‌های بزرگتر از داده‌ها پشتیبانی می‌شوند. در برخی کاربردها، نوع Content ممکن است روش Query را نداشته باشد.

توجه: فقط داده‌هایی که با UTF-8 سازگار هستند پشتیبانی می‌شوند. هنگام انتقال داده‌های دودویی، توصیه می‌شود که آنها را با بلوک عملکرد BASE64_ENCODE کدگذاری کنید.

ورودی Timeout

ورودی زمان محدودیت درخواست را به عنوان زمان در فرمت T#30s به ثانیه تعریف می‌کند. توصیه می‌شود که یک زمان محدودیت بالا استفاده کنید. مقادیر کوچک ممکن است باعث شود که درخواست‌ها کامل انجام نشوند. با روش Keep-Alive، ممکن است کمی طول بکشد تا درخواست‌ها دوباره به طور طبیعی پردازش شوند.

ورودی DIS

اگر ورودی درست باشد، مقدار در خروجی Request برابر NULL خواهد بود.

ورودی SET

اگر ورودی درست باشد، این باعث می‌شود که خروجی Request تولید شود. این ورودی اولویت بیشتری نسبت به ورودی DIS دارد.

خروجی Request

خروجی یک رشته کاراکتر در فرمت JSON را بازمی‌گرداند. اگر غیر فعال شده باشد، مقدار NULL برگشت داده می‌شود. معمولاً به طور مستقیم با متغیر خروجی رابط متصل می‌شود.

خروجی Length

خروجی طول ورودی Content را در بایت بازمی‌گرداند.

خروجی ID

ID آخرین درخواست تولید شده را برگشت می‌دهد. این برای تأیید پاسخ با بلوک عملکرد HTTP_RESPONSE مفید است.