عميل REST API
أرسل طلبات HTTP وGraphQL وWebSocket مع البيئات والمجموعات والسجل.
في هذه الصفحة 8 قسم
- شغّل DevSnip Pro: REST API Client من لوحة الأوامر، أو انقره في الشريط الجانبي.
- اختر الطريقة، واكتب عنوان URL، واضغط Enter أو انقر Send.
- اقرأ الاستجابة: الحالة والوقت والحجم، وJSON منسّق قابل للبحث، والترويسات وملفات تعريف الارتباط. انسخها أو احفظها من شريط الأدوات.
الصق أمر cURL (مثلًا من أدوات المطوّر في متصفحك، Copy as cURL) في شريط العنوان: تُستورد الطريقة والترويسات والجسم.
أنشئ بيئة لكل هدف، مثل local وstaging، فيها متغيرات مثل baseUrl وtoken. أشر إليها بـ {{name}} في أي مكان من الطلب، ثم بدّل البيئة لتشغيل الطلب نفسه على خادم آخر.
GET {{baseUrl}}/users/42
Authorization: Bearer {{token}}اختر Bearer أو Basic أو API key في علامة التبويب Auth. ويتوفر مساعد رموز OAuth 2.0 ضمن الأدوات المتقدمة.
- احفظ الطلبات في مجموعات، مقسّمة إلى مجلدات تعكس بنية واجهتك (
auth/وusers/وbilling/). المجموعات غير محدودة ومخزّنة محليًا. - يحتفظ السجل بكل طلب أرسلته؛ وتُخفى قيم عناوين URL التي تبدو كبيانات اعتماد، ولا تُكتب مفاتيح API في السجل أبدًا.
- بدّل البروتوكول من HTTP إلى GraphQL (بجوار اسم الطلب). تصبح علامة التبويب Body علامة Query.
- اضبط الطريقة على POST وأدخل نقطة النهاية، مثل
{{baseUrl}}/.graphql - اكتب الاستعلام، وأضف Variables (JSON)، وإذا كان المستند يتضمن عدة عمليات، فأضف Operation name.
- اضغط Ctrl/Cmd+Enter أو Send، ثم افحص
dataوerrorsكليهما في الاستجابة.
query GetCountry($code: ID!) {
country(code: $code) {
name
capital
}
}مثال: المتغيرات والاستجابة
ضع قيمة $code في Variables (JSON):
{
"code": "GB"
}يعكس data في الرد شكل الاستعلام. وكثيرًا ما تجيب خوادم GraphQL بـ 200 OK حتى عند فشل جزء من الاستعلام، وتذكر المشكلة في مصفوفة errors، لذا افحص كليهما:
{
"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. (30 ث افتراضيًا). وتتجاوزها المهلة الخاصة بالطلب المضبوطة في العميل، ويوقف Cancel الطلب مبكرًا.