الأرق API العميل

Insomnia هو عميل API مفتوح المصدر ومتعدد المنصات لـ GraphQL وREST وWebSockets والأحداث المرسلة من الخادم (SSE) وgRPC وأي بروتوكول آخر متوافق مع HTTP.

مع الأرق يمكنك:

تصحيح أخطاء واجهات برمجة التطبيقات باستخدام البروتوكولات والتنسيقات الأكثر شيوعًا.
تصميم واجهات برمجة التطبيقات باستخدام محرر OpenAPI الأصلي والمعاينة المرئية.
اختبار واجهات برمجة التطبيقات باستخدام مجموعات الاختبار الأصلية ومشغل التجميع.
واجهات برمجة التطبيقات الوهمية باستخدام خادم وهمي سحابي أو مستضاف ذاتيًا.
قم ببناء خطوط أنابيب CI/CD باستخدام Insomnia CLI الأصلي لإجراء الفحص والاختبار.
تعاون مع الآخرين باستخدام ميزات التعاون العديدة.
والمزيد بما في ذلك القدرة على استخدام المكونات الإضافية التابعة لجهات خارجية.

خيارات التخزين التالية مدعومة لمشاريع Insomnia ومجموعاتها ومواصفات التصميم وجميع الموارد الأخرى:

Local Vault : للتخزين المحلي بنسبة 100% للمجموعات ومواصفات التصميم وكل الموارد الأخرى.
Git Sync : لتخزين Git باستخدام أي مستودع Git تابع لجهة خارجية، دون المرور عبر السحابة.
المزامنة السحابية : للتعاون السحابي، تشفير اختياري من طرف إلى طرف (E2EE) في السحابة.

ابدأ مجانًا

يتوفر Insomnia لأنظمة التشغيل Mac وWindows وLinux ويمكن تنزيله من الموقع الإلكتروني:

https://insomnia.rest

الحساب والاشتراكات

يمكنك استخدام Insomnia بدون حساب في Scratch Pad المحلي، أو يمكنك إنشاء حساب مجانًا للوصول إلى الإمكانات الكاملة للمنتج.

حتى مع وجود حساب، يقوم Insomnia بتخزين مشاريعك وملفاتك فقط وفقًا لواجهة التخزين الخلفية التي حددتها، والتي يمكن أن تكون Local Vault أو Cloud Sync أو Git Sync أو أي مجموعة منها. على هذا النحو - على سبيل المثال - لديك حرية اختيار تخزين المشروعات الحساسة بنسبة 100% محليًا أو في مستودع Git، مع الاستمرار في القدرة على التعاون مع الآخرين في السحابة. إنه أفضل ما في العالمين.

لمزيد من الأمان، يوفر Insomnia أيضًا ميزة البيئات الخاصة ، حيث يتم دائمًا تخزين تكوين بيئاتك محليًا وليس في السحابة أبدًا، بشكل مستقل عن خيار التخزين الذي اخترته لمشروعك.

الميزات والدعم المتميز

لدى Insomnia خطة مجانية سخية للغاية ستكون مرضية لمعظم المستخدمين، ولكن إذا كنت بحاجة إلى الوصول إلى إمكانات متميزة مثل التعاون غير المحدود، وميزة Git Sync، والقدرة على إنشاء مؤسسات لمشاريعك، باستخدام IDP لجهة خارجية لتسجيلات الدخول (SAML، OIDC) والعديد من الميزات الأخرى، ثم يمكنك استكشاف خطط الاشتراك الأخرى.

يمكنك مقارنة جميع خطط الاشتراك والبدء مجانًا.

لماذا يتطلب الأرق حسابا؟

لا يتطلب Insomnia حسابًا إذا قررت استخدام Scratch Pad المحلي، ولكن للوصول إلى معظم إمكانيات المنتج، نحتاج إلى حساب. يتم تخزين بيانات حسابك بشكل آمن وفقًا للوائح ISO27001 وSOC 2 Type II وISO27018 وGold CSA STAR ووفقًا لشروط الخدمة وسياسة الخصوصية الخاصة بنا.

نحن بحاجة إلى حساب لبناء المنتج وتحسينه بشكل مستدام، وللتأكد من قدرتنا على الاستمرار في تقديم العديد من الإمكانات الأساسية في توزيع مجاني ومفتوح المصدر. على الرغم من أن استخدام البرامج مفتوحة المصدر مجاني، إلا أنه للأسف ليس مجانيًا للإنشاء، وتعتمد قدرتنا على مواصلة العمل على Insomnia على قدرتنا على تحويل مجموعة فرعية من المستخدمين المجانيين (الذين يحتاجون إلى ميزات متميزة) ليصبحوا عملاء يدفعون لمنتجنا .

إذا كنت مستخدمًا لا يمكنه مشاركة بيانات واجهة برمجة التطبيقات (API) مثل المجموعات ومواصفات التصميم مع السحابة، فلا يزال هذا ممكنًا عن طريق تحديد "Local Vault" كمخزن لمشاريع Insomnia الخاصة بك: لا يرتبط امتلاك حساب Insomnia بالطريقة التي ترغب في تخزينها بيانات API الحساسة الخاصة بك (والتي يمكن تخزينها محليًا بنسبة 100% عبر Local Vault، أو في مستودع Git لجهة خارجية دون أي تخزين سحابي عبر Git Sync، أو في السحابة لسهولة التعاون عبر Cloud Sync).

الأخطاء وطلبات الميزات

هل لديك خطأ أو طلب ميزة؟ أولاً، اقرأ إرشادات المشكلات وابحث عن المشكلات الموجودة والمغلقة. إذا لم تتم معالجة مشكلتك أو فكرتك بعد، يرجى فتح عدد جديد.

لمزيد من الأسئلة والتعليقات العامة حول المنتج، انضم إلى فريق Slack.

المساهمة

يرجى قراءة إرشادات المساهمة ومدونة قواعد السلوك الخاصة بنا. تتضمن توجيهات لفتح القضايا، ومعايير الترميز، وملاحظات حول التطوير.

التوثيق

تحقق من وثائق الأرق الرسمية لدينا.

تطوير الأرق

يمكن إجراء التطوير على Insomnia على أنظمة Mac، أو Windows، أو Linux طالما أن لديك Node.js وGit. راجع ملف .nvmrc الموجود في المشروع للحصول على إصدار العقدة الصحيح.

الإعداد الأولي للتطوير

تم تصميم هذا المستودع باعتباره monorepo ويحتوي على العديد من حزم Node.JS. تحتوي كل حزمة على مجموعتها الخاصة من الأوامر، ولكن الأوامر الأكثر شيوعًا متاحة من package.json root.json ويمكن الوصول إليها باستخدام الأمر npm run … فيما يلي الأوامر الثلاثة الوحيدة التي يجب أن تحتاجها لبدء تطوير التطبيق.

 # تثبيت وربط التبعياتnpm i# تشغيل Lintnpm run lint# تشغيل نوع التحققnpm تشغيل type-check# تشغيل اختبار Testsnpm# بدء التطبيق باستخدام Live Reloadnpm run dev

لينكس

إذا كنت تستخدم نظام التشغيل Linux، فقد تحتاج إلى تثبيت الحزم الداعمة التالية:

أوبونتو/ديبيان

 # تحديث المكتبةsudo apt-get update# تثبيت مكتبة تكوين الخط ودعمsudo apt-get install libfontconfig-dev

فيدورا

 # تثبيت libcurl لـ Node-libcurlsudo dnf install libcurl-devel

أيضًا على نظام التشغيل Linux، إذا فشل Electron أثناء عملية التثبيت، فقم بتشغيل ما يلي

 # مسح تعارضات تثبيت الإلكترونrm -rf ~/.cache/electron

ويندوز

إذا كنت تستخدم نظام التشغيل Windows وتواجه مشكلات، فقد تحتاج إلى تثبيت Windows Build Tools

متطلبات المحرر

يمكنك استخدام أي محرر تريده، ولكن تأكد من توفر الدعم/المكونات الإضافية للأدوات التالية:

ESLint - لاكتشاف مشاكل بناء الجملة والأخطاء الشائعة
بناء جملة JSX - لمكونات React

تطوير Inso CLI

npm i
ابدأ تشغيل المترجم في وضع المراقبة: npm run inso-start
تشغيل: ./packages/insomnia-inso/bin/inso -v

الإضافات

ابحث عن المكونات الإضافية واكتشفها وقم بتثبيتها من Insomnia Plugin Hub!

المشاريع المجتمعية

Insomnia Documenter - قم بإنشاء صفحات وثائق API جميلة باستخدام البرنامج المساعد للموثق أو ملف تصدير Insomnia الخاص بك.
GitHub API Spec Importer - مجموعة كاملة من مواصفات مسار GitHub REST API التي يمكن استيرادها مباشرة إلى Insomnia.
Swaggymnia - إنشاء وثائق Swagger لواجهة برمجة التطبيقات (API) الموجودة لديك في Insomnia.