إنتقل إلى المحتوى الرئيسي

Request()

وحدة لإجراء طلبات شبكية إلى الإنترنت تم تقديمها في الإصدار 1.0.0.31

المُنشئ​

Request(url: string)

المعاملات​

المعاملاتالنوعالوصف
urlstringعنوان الموقع، يمكن أن يكون https أو http

الدوال​

setHeader(key: string, value: string): Request​

تضيف ترويسة (header) مخصّصة لطلب HTTP.

المعاملات​

المعاملاتالنوعالوصف
keystringاسم الترويسة
valuestringقيمة الترويسة

القيمة المعادة​

Request - يُعيد كائن Request لاستخدامه في تسلسل الدوال (method chaining)

setParameter(key: string, value: string): Request​

تضيف معاملاً لمتن الطلب (يُستخدم مع طلبات POST/PUT).

المعاملات​

المعاملاتالنوعالوصف
keystringاسم المعامل
valuestringقيمة المعامل

القيمة المعادة​

Request - يُعيد كائن Request لاستخدامه في تسلسل الدوال (method chaining)

get(): Response​

ينفّذ طلب GET ويُعيد كائن Response.

القيمة المعادة​

Response - كائن الاستجابة الذي يحتوي على رد الخادم

post(): Response​

ينفّذ طلب POST ويُعيد كائن Response.

القيمة المعادة​

Response - كائن الاستجابة الذي يحتوي على رد الخادم

put(): Response​

ينفّذ طلب PUT ويُعيد كائن Response.

القيمة المعادة​

Response - كائن الاستجابة الذي يحتوي على رد الخادم

delete(): Response​

ينفّذ طلب DELETE ويُعيد كائن Response.

القيمة المعادة​

Response - كائن الاستجابة الذي يحتوي على رد الخادم

أمثلة​

طلب GET أساسي​

local response = Request("https://api.example.com/data"):get()
local data = response:getData()
local statusCode = response:getResponseCode()

طلب POST مع الترويسات والمعاملات​

local response = Request("https://api.example.com/users")
    :setHeader("Content-Type", "application/json")
    :setHeader("Authorization", "Bearer token123")
    :setParameter("name", "John Doe")
    :setParameter("email", "john@example.com")
    :post()

تسلسل عدة دوال​

-- Request objects support method chaining for fluent API
local response = Request("https://api.example.com/data")
    :setHeader("API-Key", "your-api-key")
    :setParameter("query", "search term")
    :setParameter("limit", "10")
    :get()