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

Request():get()

ينفّذ طلب GET ويُعيد كائن Response. تُستخدم هذه الدالة لاسترجاع البيانات من عنوان محدد.

التوقيع​

get(): Response

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

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

الوصف​

ترسل الدالة get() طلب HTTP GET إلى العنوان المحدّد عند إنشاء كائن Request. تُستخدم طلبات GET عادةً لاسترجاع البيانات من الخادم دون تعديل أي بيانات موجودة.

أمثلة​

طلب GET أساسي​

-- Create a GET request to an API endpoint
local response = Request("https://api.example.com/users"):get()

طلب GET مع ترويسات مخصّصة​

-- GET request with authentication header
local response = Request("https://api.example.com/protected-data")
    :setHeader("Authorization", "Bearer your-token-here")
    :setHeader("Accept", "application/json")
    :get()

معالجة استجابة GET​

-- Make the request and handle the response
local response = Request("https://jsonplaceholder.typicode.com/posts/1"):get()

-- Get the response data as string
local data = response:getData()

-- Get the HTTP status code
local statusCode = response:getResponseCode()

if statusCode == 200 then
    print("Request successful!")
    print("Response data: " .. data)
else
    print("Request failed with status: " .. statusCode)
end

طلب GET مع معاملات الاستعلام​

-- For GET requests with query parameters, include them in the URL
local response = Request("https://api.example.com/search?q=lua&limit=10"):get()
local results = response:getData()

ملاحظات​

  • يجب ألا تحتوي طلبات GET على متن طلب. إذا احتجت إلى إرسال بيانات، استخدم POST() بدلاً من ذلك
  • تُعيد الدالة كائن Response يمكنك استخدامه للوصول إلى بيانات الاستجابة ورمز الحالة
  • تحقّق دائمًا من رمز حالة الاستجابة للتأكد من نجاح الطلب
  • طلبات GET تكرارية (idempotent)، مما يعني أن إرسال نفس الطلب عدة مرات يجب أن يكون له نفس الأثر