كيف تنشر بيانات JSON باستخدام HTTPie؟ (الأحدث في 2025)

هل تبحث عن طريقة بسيطة وفعالة لنشر بيانات JSON إلى واجهة برمجية للتطبيقات؟ لا تبحث بعيدًا عن HTTPie! هذه الأداة القوية من سطر الأوامر مصممة لجعل التفاعل مع خدمات الويب سهل الفهم قدر الإمكان. في هذا الدليل، سنوضح لك كيفية استخدام HTTPie لنشر بيانات JSON وسنقدم لك Apidog، أداة أسهل للاستخدام لإرسال طلبات HTTP بشكل أكثر بديهية وسهولة.

زر

ما هو HTTPie

HTTPie هو عميل HTTP من سطر الأوامر يتيح لك التفاعل مع خوادم HTTP وواجهات برمجة التطبيقات من سطر الأوامر. تم تصميمه ليكون سهل الاستخدام وبديهيًا، مع ميزات مثل المخرجات المنسقة والملونة، ودعم JSON المدمج، وصياغة بديهية. إنها أداة مفتوحة المصدر خفيفة الوزن وقوية تستخدمها المطورون للاختبار وتصحيح الأخطاء واستكشاف نقاط النهاية المختلفة لواجهات برمجة التطبيقات. يتوفر HTTPie لكل من بيئات الطرفية والويب / سطح المكتب. تم تصميم HTTPie للاختبار وتصحيح الأخطاء والتفاعل عمومًا مع واجهات برمجة التطبيقات وخوادم HTTP.

بعض الميزات الرئيسية لـ HTTPie تشمل:

صياغة تعبيرية وبديهية
مخرجات طرفية منسقة وملونة
دعم JSON مدمج
النماذج وتحميل الملفات
HTTPS، الوكلاء، والمصادقة
بيانات طلب عشوائية
رؤوس مخصصة
جلسات دائمة
تنزيلات شبيهة بـ Wget
دعم Linux و macOS و Windows و FreeBSD
الإضافات

كيفية تثبيت HTTPie

قبل أن نغوص في تفاصيل نشر بيانات JSON باستخدام HTTPie، دعنا نأخذ لحظة للبدء باستخدام الأداة. في هذا القسم، سنوضح لك كيفية تثبيت HTTPie على نظامك ونقدم لمحة عامة عن الصياغة الأساسية.

يمكن تثبيت HTTPie على مجموعة متنوعة من المنصات، بما في ذلك macOS و Windows و Linux. إليك بعض تعليمات التثبيت للمنصات المختلفة:

كيفية تثبيت HTTPie على macOS

يمكنك تثبيت HTTPie باستخدام Homebrew عبر تشغيل الأوامر التالية في الطرفية الخاصة بك:

brew update
brew install httpie

بدلاً من ذلك، يمكنك تثبيته باستخدام pip:

pip install httpie

تثبيت HTTPie على Windows

يمكنك تنزيل المثبت من الموقع الرسمي. بمجرد التنزيل، قم بتشغيل ملف التنفيذ واتبع التعليمات لتثبيت HTTPie.

تثبيت HTTPie على Linux

تختلف عملية التثبيت اعتمادًا على التوزيعة التي تستخدمها. على سبيل المثال، على Debian و Ubuntu، يمكنك تثبيت HTTPie باستخدام الأمر التالي:

sudo apt-get install httpie

على Fedora و CentOS و RHEL، يمكنك استخدام الأمر التالي:

sudo dnf install httpie

للحصول على مزيد من المعلومات حول HTTPie وميزاته، يرجى الرجوع إلى الوثائق الرسمية:

ماذا تحتاج إلى معرفته قبل البدء؟

JSON (JavaScript Object Notation) هو تنسيق خفيف لتمرير البيانات يسهل قراءته وكتابته من قبل البشر ويسهل على الآلات تحليله وتوليده. إنه تنسيق قائم على النص يُستخدم غالبًا لنقل البيانات بين الخادم وتطبيق ويب. تُكتب بيانات JSON كأزواج اسم/قيمة، مشابهة لخصائص كائنات JavaScript. يتكون زوج الاسم/القيمة من اسم الحقل (داخل علامات الاقتباس المزدوجة) يتبعه نقطتان، يتبعه قيمة. تُكتب الكائنات JSON داخل أقواس معقوفة، وتُكتب المصفوفات داخل أقواس مربعة.

طلب HTTP POST

طريقة POST هي طريقة طلب HTTP تُستخدم لتقديم بيانات ليتم معالجتها إلى مورد محدد. غالبًا ما يتم استخدامها لإنشاء أو تحديث مورد على الخادم. البيانات المرسلة إلى الخادم باستخدام POST تُخزن في جسم الطلب في طلب HTTP.

إرسال طلب POST مع بيانات JSON

الآن بعد أن قمت بتثبيت httpie، دعنا نلقي نظرة على كيفية إرسال طلب POST مع بيانات JSON. سنستخدم الأمر http لإرسال الطلب. إليك مثال:

$ http POST http://example.com/api/v1/users name=John email=john@example.com

في هذا المثال، نحن نرسل طلب POST إلى http://example.com/api/v1/users مع بيانات JSON تتضمن اسمًا وعنوان بريد إلكتروني. يتبع الأمر http طريقة HTTP (POST)، وURL (http://example.com/api/v1/users)، والبيانات (name=John email=john@example.com).

نشر بيانات JSON باستخدام HTTPie

الآن بعد أن أصبحت مألوفًا مع HTTPie، حان الوقت لبدء نشر بيانات JSON! في هذا القسم، سنوضح لك كيفية استخدام HTTPie لنشر بيانات JSON إلى واجهة برمجة التطبيقات. سنقدم أمثلة على كيفية استخدام HTTPie لنشر بيانات JSON مع أنواع مختلفة من الحقول، بما في ذلك الحقول غير النصية للـ JSON والبيانات المتداخلة لـ JSON.

إليك مثال على استخدام HTTPie لإرسال حمولة JSON في طلب POST:

http POST http://example.com/api/data name=John age:=30

في هذا المثال، نحن نرسل طلب POST إلى http://example.com/api/data مع حمولة JSON تتضمن حقلين: name و age. حقل name هو نص، بينما حقل age هو رقم. يتم استخدام عامل التشغيل := للإشارة إلى أن قيمة age يجب أن تُعالج كرقم وليس كنص.

يقوم HTTPie تلقائيًا بضبط رأس Content-Type إلى application/json عند إرسال بيانات JSON، لذا لا تحتاج إلى تحديده بشكل صريح. إذا كنت تريد إرسال حمولة JSON من ملف، يمكنك استخدام صيغة @:

http POST http://example.com/api/data < data.json

في هذا المثال، نحن نرسل محتويات ملف data.json كحمولة JSON في طلب POST.

استخدام HTTPie لنشر بيانات JSON مع معلمات الاستعلام

httpie يمكن أيضًا استخدامه مع معلمات الاستعلام.

http POST http://example.com/api/v1/data?param1=value1&param2=value2 < data.json

هنا، http هو الأمر لإرسال طلبات HTTP، POST هو طريقة HTTP، http://example.com/api/v1/data هو URL نقطة النهاية لواجهة برمجة التطبيقات، و param1=value1&param2=value2 هي معلمات الاستعلام. الجزء < data.json يحدد أن بيانات JSON يجب أن تُقرأ من ملف data.json.

يمكنك استبدال POST بطرق HTTP أخرى مثل GET، PUT، PATCH، أو DELETE اعتمادًا على متطلبات نقطة النهاية لـ API.

استخدام HTTPie مع طرق HTTP الأخرى

httpie يمكن استخدامه أيضًا مع طرق HTTP الأخرى. إليك بعض الأمثلة:

يدعم HTTPie جميع طرق HTTP القياسية مثل GET و POST و PUT و DELETE، إلخ. يمكنك استخدام الأمر التالي لإرسال طلب بطريقة HTTP معينة:

http METHOD URL [OPTIONS] [REQUEST_ITEMS]

استبدل METHOD بطريقة HTTP المطلوبة، وURL بـ URL نقطة النهاية لواجهة برمجة التطبيقات التي تريد التفاعل معها. على سبيل المثال، لإرسال طلب PUT إلى http://example.com/api/data، يمكنك استخدام الأمر التالي:

http PUT http://example.com/api/data name=John age:=30

في هذا المثال، نحن نرسل طلب PUT إلى http://example.com/api/data مع حمولة JSON تتضمن حقلين: name وage. حقل name هو نص، بينما حقل age هو رقم. يتم استخدام عامل التشغيل := للإشارة إلى أن قيمة age يجب أن تُعالج كرقم وليس كنص.

ما هي بعض الاستخدامات الشائعة لـ HTTPie؟

HTTPie هو عميل HTTP متعدد الاستخدامات من سطر الأوامر يمكن استخدامه لأغراض متنوعة. إليك بعض الاستخدامات الشائعة لـ HTTPie:

اختبار واجهات برمجة التطبيقات والتطوير: يُبسط HTTPie عملية اختبار وتطوير واجهات برمجة التطبيقات RESTful من خلال السماح للمطورين باختبار نقاط نهاية واجهات برمجة التطبيقات بسرعة، وفحص الردود، وتكرار التنفيذ الخاص بهم.
تصحيح الشبكة: يعتبر HTTPie أداة لا تقدر بثمن لتشخيص المشكلات المتعلقة بالشبكة.
برمجة نصية مخصصة: يمكن استخدام HTTPie لإنشاء برامج نصية مخصصة لأتمتة المهام المتكررة، مثل إرسال طلبات HTTP إلى خادم.
استكشاف البيانات: يمكن استخدام HTTPie لاستكشاف البيانات من واجهات برمجة التطبيقات وخدمات الويب من خلال إرسال طلبات HTTP واستقبال الردود بشكل يمكن قراءته من قبل البشر.

هذه مجرد بعض الأمثلة على كيفية استخدام HTTPie. تجعل صياغته البسيطة والبديهية، إلى جانب دعمه المدمج لـ JSON ومخرجاته الملونة، خيارًا شائعًا بين المطورين للاختبار وتصحيح الأخطاء واستكشاف نقاط النهاية المختلفة لواجهات برمجة التطبيقات.

الاستخدام المتقدم لـ HTTPie

HTTPie هي أداة قوية يمكن استخدامها لأكثر بكثير من مجرد نشر بيانات JSON. يمكن استخدامها لأغراض متنوعة. إليك بعض الميزات المتقدمة لـ HTTPie:

تنسيقات المخرجات القابلة للتخصيص: يتيح لك HTTPie تخصيص تنسيق المخرجات للرد. يمكنك استخدام الخيار --format لتحديد تنسيق المخرجات. تشمل التنسيقات المدعومة JSON و XML و HTML والمزيد ¹.
قوالب الطلبات: يسمح لك HTTPie بإنشاء قوالب طلبات يمكنك إعادة استخدامها ومشاركتها. يمكنك استخدام الخيار --template لتحديد ملف القالب. يمكن أن يحتوي ملف القالب على عناصر نائب سيتم استبدالها بالقيم الفعلية عند إرسال الطلب.
الوضع التفاعلي: يحتوي HTTPie على وضع تفاعلي يتيح لك استكشاف واجهة برمجة التطبيقات من خلال تنفيذ طلبات ومعاينة الردود في الوقت الحقيقي. يمكنك إدخال الأوامر ورؤية النتائج على الفور. هذه ميزة مفيدة لاختبار وتصحيح واجهات برمجة التطبيقات.
الجلسات الدائمة: يتيح لك HTTPie إنشاء جلسات دائمة يمكن إعادة استخدامها عبر طلبات متعددة. هذه ميزة مفيدة للحفاظ على الحالة عبر الطلبات، مثل رموز المصادقة أو ملفات تعريف الارتباط ¹.
الرؤوس المخصصة: يتيح لك HTTPie تحديد رؤوس مخصصة لطلباتك. يمكنك استخدام الخيار -h أو --headers لتحديد رؤوس. يمكنك أيضًا استخدام الخيار --auth لتحديد بيانات اعتماد المصادقة ¹.
HTTPS، الوكلاء، والمصادقة: يدعم HTTPie HTTPS والوكلاء والمصادقة بشكل افتراضي. يمكنك استخدام الخيار --auth لتحديد بيانات اعتماد المصادقة. يمكنك استخدام الخيار --proxy لتحديد خادم وكيل. يمكنك استخدام الخيار --verify لتحديد حزمة CA مخصصة للتحقق من SSL ¹.
بيانات الطلب العشوائية: يتيح لك HTTPie إرسال بيانات عشوائية في طلباتك، مثل JSON أو بيانات النموذج أو البيانات الثنائية. يمكنك استخدام الخيار -d أو --data لتحديد البيانات. يمكنك أيضًا استخدام صيغة @ لإرسال البيانات من ملف.

نشر بيانات JSON بشكل أكثر سهولة مع Apidog

Apidog هي أداة قوية لتصميم وإصلاح واجهات برمجة التطبيقات تسمح للمطورين بوصف وتصحيح واجهات برمجة التطبيقات في محرر مرئي يدعم مخطط JSON. إنها مجموعة كاملة من الأدوات التي تربط دورة حياة واجهة برمجة التطبيقات بالكامل، مما يساعد فرق البحث والتطوير على تنفيذ أفضل الممارسات لتطوير الواجهات أولاً.

زر

يدعم Apidog جميع طرق HTTP مثل GET و POST و PUT، ويسمح لك باختبار واجهات برمجة التطبيقات بنقرة واحدة فقط من خلال واجهة مستخدم بديهية.

الخطوة 1. افتح Apidog وانقر على "API جديدة" لإنشاء واجهة برمجة تطبيقات جديدة للاختبار.

الخطوة 2. اختر طريقة HTTP التي ستستخدمها للواجهة وأدخل عنوان URL لنقطة النهاية.

الخطوة 3. أدخل المعلومات الضرورية مثل المعلمات وفقًا لمواصفات الواجهة وانقر على زر "إرسال" لإرسال طلب واجهة برمجة التطبيقات والحصول على الرد.

باتباع هذه الخطوات، يمكنك بسهولة نشر بيانات JSON الخاصة بك باستخدام Apidog.

زر

الاستنتاج

HTTPie هي أداة قوية لنشر بيانات JSON إلى واجهات برمجة التطبيقات. في هذا الدليل، لقد أوضحنا لك كيفية استخدام HTTPie لنشر بيانات JSON وقدمنا لك Apidog، وهي أداة توفر ميزات اختبار عالية الجودة يمكنها التعامل مع مشروعات واجهات برمجة التطبيقات في مراحل مختلفة، وهي ميزة رئيسية تختلف عن HTTPie، والتي هي أداة أوامر بسيطة. أوصي باستخدام Apidog عند تطوير/اختبار واجهات برمجة التطبيقات.