كيفية رفع ملف وبيانات JSON في Postman

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

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

دليل خطوة بخطوة لرفع ملف في Postman

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

الخطوة 1. اختر طلب POST في Postman

للرفع ملف في Postman، ابدأ بإنشاء طلب جديد أو فتح واجهة برمجة تطبيقات موجودة. هنا هو طلب POST كمثال.

الخطوة 2. اختر "form-data"

اختر علامة التبويب "Body" واختر "form-data" كنوع الجسم. بالإضافة إلى ذلك، يوفر Postman أيضًا رفع أجسام طلبات ثنائية.

الخطوة 3. انقر على "Files" وحدد نوع القيمة

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

الخطوة 4. ارفع ملفك إلى Postman

بمجرد رفع ملفك إلى Postman وتحديد المفتاح، يمكنك إرسال الطلب كالمعتاد. سيتم تضمين الملف في الطلب واضغط على زر "إرسال" إلى واجهة برمجة التطبيقات لرؤية النتيجة.

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

أفضل بديل لـ Postman: Apidog

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

في Apidog، يمكنك بسهولة رفع الملفات للاختبار عن طريق إنشاء طلب جديد والتنقل إلى علامة التبويب "Body". من هناك، يمكنك اختيار معلمات متنوعة، مثل from-data، ثنائي، JSON، إلخ. يمكنك بسهولة الانتقال من Postman إلى Apidog كمبتدئ.

كيفية رفع الملفات في Apidog بسرعة

الآن، سوف نقدم الدليل حول كيفية رفع ملف في Apidog بسرعة. أولاً، يمكنك البدء على ويب Apidog أو تنزيل مجاني لتسجيل الدخول عبر Google أو Github.

1. لفتح واجهة برمجة التطبيقات، انتقل إلى صفحة التحرير. إذا كنت مستخدمًا جديدًا، يمكنك بسرعة إنشاء طلب جديد بالنقر على أيقونة "+" في الشريط الجانبي الأيسر.
2. بعد ذلك، في "Body"، يمكنك اختيار نوع الوسائط أو نوع البيانات الذي ترغب في رفعه. اختر "raw"، وأدخل نصًا أو بيانات بسيطة أدناه.

Raw: هذا نوع بيانات يُستخدم لإرسال بيانات خام في جسم طلب HTTP. عند استخدام معامل RAW، يمكن للمستخدم تحديد البيانات التي سيتم إرسالها في جسم الطلب مباشرة دون استخدام ترميز أو تنسيق محدد. هذه الطريقة أكثر مرونة ويمكن استخدامها لإرسال أنواع مختلفة من البيانات، بما في ذلك النص العادي، JSON، XML، إلخ.

ملاحظة: عندما يتم تعيين نوع جسم الطلب إلى raw، يمكن تعيين نوع المحتوى يدويًا دون أي قيود.

اختياري: يدعم Apidog أيضًا رفع التطبيقات وتيار الثماني. يمكنك النقر على زر "رفع" لاختيار الملف الذي ترغب في رفعه في Apidog.

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

1. حدد مستند النص الذي تريد رفعه، الذي يدعم تنسيق Markdown. عند الانتهاء، انقر على زر حفظ.

2. أرسل الطلب وتحقق من صحة مخطط الاستجابة.

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

دليل مفصل لرفع بيانات JSON إلى Postman

عند العمل مع واجهات برمجة التطبيقات، فإن إرسال بيانات JSON هو متطلب شائع. يوفر Postman واجهة سهلة الاستخدام لتبسيط عملية رفع بيانات JSON. الآن، سنرشدك خلال الخطوات من خلال مثال عملي.

لرفع بيانات JSON في Postman، اتبع هذه الخطوات:

1. افتح Postman وأنشئ طلبًا جديدًا.
2. حدد طريقة HTTP التي ترغب في استخدامها (مثل POST).
3. ادخل عنوان URL الذي ترغب في إرسال الطلب إليه.

4. انقر على علامة التبويب "Body".

5. اختر "raw" من قائمة الخيارات.

6. اختر "JSON (application/json)" من القائمة المنسدلة.

7. أدخل بيانات JSON الخاصة بك في منطقة النص.

بمجرد إدخال بيانات JSON الخاصة بك، يمكنك إرسال الطلب ورؤية الاستجابة في علامة التبويب "الاستجابة".

أحد الأمور المهمة التي يجب مراعاتها هو أنه يمكنك استخدام المتغيرات في بيانات JSON الخاصة بك عن طريق وضعها في أقواس مزدوجة (مثل {{variable_name}}). هذه الميزة مفيدة بشكل خاص عندما تحتاج إلى إرسال بيانات ديناميكية إلى طلباتك.

دليل Postman: ارفع ملفًا وبيانات JSON معًا

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

لكن ماذا لو كنا بحاجة إلى رفع ملف وبيانات JSON معًا؟ في هذا القسم، سنتعلم كيفية القيام بذلك. لرفع ملف وبيانات JSON معًا في Postman، يجب علينا استخدام خيار form-data. اتبع الخطوات أدناه:

1. افتح Postman وأنشئ طلبًا جديدًا.
2. حدد طريقة HTTP (مثل POST) وأدخل عنوان URL لنقطة نهاية واجهة برمجة التطبيقات التي تريد اختبارها.
3. حدد علامة التبويب Body واختر خيار form-data.
4. أضف زوج مفتاح-قيمة للملف الذي تريد رفعه. عيّن المفتاح إلى "file" والقيمة إلى الملف الذي ترغب في رفعه.
5. أضف زوج مفتاح-قيمة آخر لبيانات JSON التي تريد رفعها. عيّن المفتاح إلى "data" والقيمة إلى بيانات JSON التي تريد رفعها.
6. انقر على زر الإرسال لإرسال الطلب.

لاحظ أنه عند استخدام خيار form-data، يجب علينا تعيين رأس نوع المحتوى إلى "multipart/form-data". سيقوم Postman تلقائيًا بتعيين هذا الرأس لنا عندما نختار خيار form-data.

الخاتمة

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