هل تحتاج إلى اختبار واجهة برمجة التطبيقات الخاصة بك عن طريق إرسال بيانات JSON من ملف؟ فيما يلي أوامر الضفيرة.

نشر ملف JSON إلى المضيف المحلي

الأمر 
curl -X POST http://localhost:8080/api/endpoint \
  -H "Content-Type: application/json" \
  -d @data.json

استبدال:

  • 8080 بمنفذك
  • /api/endpoint مع مسار API الخاص بك
  • data.json مع مسار ملف JSON الخاص بك

ال @ الرمز يخبر الضفيرة بالقراءة من الملف. الرمز

ضع ملف JSON

الأمر 
curl -X PUT http://localhost:8080/api/endpoint \
  -H "Content-Type: application/json" \
  -d @data.json

مثل POST، فقط باستخدام طريقة PUT.

إصدار ذو بطانة واحدة

الأمر 
curl -X POST http://localhost:8080/api/endpoint -H "Content-Type: application/json" -d @data.json

كل شيء على سطر واحد.

إظهار رؤوس الاستجابة

الأمر 
curl -X POST http://localhost:8080/api/endpoint \
  -H "Content-Type: application/json" \
  -d @data.json \
  -i

-i يتضمن رؤوس الاستجابة في الإخراج.

إخراج مطول (تصحيح)

الأمر 
curl -X POST http://localhost:8080/api/endpoint \
  -H "Content-Type: application/json" \
  -d @data.json \
  -v

-v يعرض تفاصيل الطلب والاستجابة الكاملة.

مع التوثيق

المصادقة الأساسية:

الأمر 
curl -X POST http://localhost:8080/api/endpoint \
  -H "Content-Type: application/json" \
  -u username:password \
  -d @data.json

رمز حامل:

الأمر 
curl -X POST http://localhost:8080/api/endpoint \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer your-token-here" \
  -d @data.json

مفتاح واجهة برمجة التطبيقات:

الأمر 
curl -X POST http://localhost:8080/api/endpoint \
  -H "Content-Type: application/json" \
  -H "X-API-Key: your-api-key" \
  -d @data.json

إرسال JSON مضمن (بدون ملف)

الأمر 
curl -X POST http://localhost:8080/api/endpoint \
  -H "Content-Type: application/json" \
  -d '{"key":"value","number":123}'

علامات الاقتباس المفردة تمنع تفسير الصدفة.

ملف في دليل مختلف

الأمر 
curl -X POST http://localhost:8080/api/endpoint \
  -H "Content-Type: application/json" \
  -d @/path/to/data.json

استخدم المسار المطلق أو النسبي.

حفظ الرد على الملف

الأمر 
curl -X POST http://localhost:8080/api/endpoint \
  -H "Content-Type: application/json" \
  -d @data.json \
  -o response.json

تم حفظ الرد في response.json.

منافذ المضيف المحلي المشتركة

  • 3000: Node.js، خوادم React dev
  • 8000: خادم بايثون HTTP، جانغو
  • 8080: جافا المشتركة، التطوير العام
  • 5000: القارورة الافتراضية
  • 4200: خادم التطوير الزاوي
  • 3001: Node.js البديل

استكشاف الأخطاء وإصلاحها

خطأ "فشل الاتصال":

  • API لا يعمل
  • رقم المنفذ خاطئ
  • فحص http:// مقابل https://

الخطأ "الحليقة: لا يوجد مثل هذا الملف":

  • ملف JSON غير موجود
  • مسار الملف خاطئ
  • التحقق من الدليل الحالي مع pwd

رد غير متوقع:

  • تحقق من بناء جملة JSON باستخدام cat data.json
  • التحقق من صحة JSON على jsonlint.com
  • الاستخدام -v علم لرؤية الطلب كاملاً

مثال لملف JSON

إنشاء data.json:

الأمر 
{
  "name": "Test User",
  "email": "test@example.com",
  "active": true,
  "roles": ["admin", "user"]
}

ثم اركض:

الأمر 
curl -X POST http://localhost:8080/users -H "Content-Type: application/json" -d @data.json

خلاصة القول

أمر POST الأساسي:

الأمر 
curl -X POST http://localhost:8080/api/endpoint -H "Content-Type: application/json" -d @data.json

ال @ يقرأ الرمز من الملف. قم بتغيير POST إلى PUT لطلبات PUT. أضف -v لتصحيح الأخطاء. أضف -i لرؤوس الرد.

يعمل مع أي واجهة برمجة تطبيقات مضيف محلي أثناء التطوير.