الأدوات العامة

request

يرسل طلب HTTP مع خيارات الطريقة والرؤوس والنص والمهلة.

الصيغة

request(options: RequestOptions): Response | string
أسماء بديلة http_requesthttp.request

الوسائط

الاسمالنوعالوصف
optionsRequestOptionsجدول الإعدادات الاختياري الذي يتحكم في كيفية تصرف العملية.

القيم الراجعة

الاسمالنوعالوصف
responseResponse | stringجدول استجابة HTTP أو سلسلة التوافق.

الوصف

يرسل طلب HTTP مع خيارات الطريقة والرؤوس والنص والمهلة.

استدعه مع 1 parameter: options. يوضح جدول arguments القيم المطلوبة والقيم التي تضبط السلوك.

يعيد response (Response | string). استخدم جدول returns للفصل بين قيم النجاح ونتائج nil والأخطاء القابلة للمعالجة.

مثال

أرسل طلب JSON وافحص حقول الاستجابة العامة.

local response = request({
    Url = "https://example.com/api/status",
    Method = "GET",
    Headers = {
        ["Accept"] = "application/json",
    },
})

if type(response) == "table" then
    if response.Success then
        print(response.StatusCode, response.Body)
    else
        warn(response.StatusMessage)
    end
else
    warn(response)
end

الأنواع

RequestOptions

يحدد طلب HTTP.

Url string عنوان URL المقصود لـ HTTP أو HTTPS.Method? "GET" | "POST" | "PUT" | "PATCH" | "DELETE" طريقة HTTP المستخدمة للطلب.Headers? {[string]: string} رؤوس الطلبات الإضافية.Cookies? {[string]: string} تمت إضافة ملفات تعريف الارتباط إلى الطلب الصادر.Body? string نص الطلب الخام.