عميل REST API

أرسل طلبات HTTP وGraphQL وWebSocket مع البيئات والمجموعات والسجل.

في هذه الصفحة 8 قسم

أرسل طلبًا

  1. شغّل DevSnip Pro: REST API Client من لوحة الأوامر، أو انقره في الشريط الجانبي.
  2. اختر الطريقة، واكتب عنوان URL، واضغط Enter أو انقر Send.
  3. اقرأ الاستجابة: الحالة والوقت والحجم، وJSON منسّق قابل للبحث، والترويسات وملفات تعريف الارتباط. انسخها أو احفظها من شريط الأدوات.
نصيحة

الصق أمر cURL (مثلًا من أدوات المطوّر في متصفحك، Copy as cURL) في شريط العنوان: تُستورد الطريقة والترويسات والجسم.

استخدم البيئات بدلًا من المضيفين والرموز المكتوبة في الشيفرة

أنشئ بيئة لكل هدف، مثل local وstaging، فيها متغيرات مثل baseUrl وtoken. أشر إليها بـ {{name}} في أي مكان من الطلب، ثم بدّل البيئة لتشغيل الطلب نفسه على خادم آخر.

Request
GET {{baseUrl}}/users/42
Authorization: Bearer {{token}}

المصادقة

اختر Bearer أو Basic أو API key في علامة التبويب Auth. ويتوفر مساعد رموز OAuth 2.0 ضمن الأدوات المتقدمة.

المجموعات والسجل

  • احفظ الطلبات في مجموعات، مقسّمة إلى مجلدات تعكس بنية واجهتك (auth/ وusers/ وbilling/). المجموعات غير محدودة ومخزّنة محليًا.
  • يحتفظ السجل بكل طلب أرسلته؛ وتُخفى قيم عناوين URL التي تبدو كبيانات اعتماد، ولا تُكتب مفاتيح API في السجل أبدًا.

اختبر واجهة GraphQL API

  1. بدّل البروتوكول من HTTP إلى GraphQL (بجوار اسم الطلب). تصبح علامة التبويب Body علامة Query.
  2. اضبط الطريقة على POST وأدخل نقطة النهاية، مثل {{baseUrl}}/graphql.
  3. اكتب الاستعلام، وأضف Variables (JSON)، وإذا كان المستند يتضمن عدة عمليات، فأضف Operation name.
  4. اضغط Ctrl/Cmd+Enter أو Send، ثم افحص data وerrors كليهما في الاستجابة.
Query
query GetCountry($code: ID!) {
  country(code: $code) {
    name
    capital
  }
}
مثال: المتغيرات والاستجابة

ضع قيمة $code في Variables (JSON):

Variables
{
  "code": "GB"
}

يعكس data في الرد شكل الاستعلام. وكثيرًا ما تجيب خوادم GraphQL بـ 200 OK حتى عند فشل جزء من الاستعلام، وتذكر المشكلة في مصفوفة errors، لذا افحص كليهما:

Response
{
  "data": {
    "country": {
      "name": "United Kingdom",
      "capital": "London"
    }
  }
}

حوّل الطلبات إلى شيفرة

  • Generate code لـ JavaScript ‏(fetch وAxios) أو Python أو Go أو Java أو C#‎.
  • Export as cURL لملف README أو تقرير خطأ.
  • احصل على أنواع من الاستجابة باستخدام JSON to Types ‏(TypeScript وZod وPydantic وGo وKotlin وSwift وغيرها).

استدعِ مزوّدي الذكاء الاصطناعي

قوالب طلبات جاهزة لـ OpenAI وAnthropic وGemini وAzure OpenAI وOllama وأي نقطة نهاية متوافقة مع OpenAI. أرسل موجّهًا، واستقبل الرد مبثوثًا، وتحقق منه مقابل مخطط؛ يُستخدم مفتاح API للطلب ولا يُخزَّن أبدًا.

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

تكلّف التأكيدات وتسلسل الطلبات واختبارات الأداء الدفعية ومقارنة الاستجابات وخوادم المحاكاة وWebSocket ومساعد OAuth 2.0 وتصدير SDK بأنواع محددة من 8 إلى 35 نقطة لكل تشغيل ناجح. تُكسب النقاط باستخدام الإضافة — راجع النقاط والإنجازات والسمات.

ملاحظة

تنتهي مهلة الطلبات بعد devsnip.apiTimeout ‏(30 ث افتراضيًا). وتتجاوزها المهلة الخاصة بالطلب المضبوطة في العميل، ويوقف Cancel الطلب مبكرًا.