إنشاء طلب جديد (POST /api/orders)
تتيح لك نقطة النهاية هذه إنشاء طلبات جديدة في متجر Shopify الخاص بك.
يجب أن تكون مصادقًا باستخدام مفتاح API الخاص بك.
نقطة النهاية (Endpoint)
POST /api/orders
المصادقة (Authentication)
يجب توفير مفتاح API الخاص بك في رأس الطلب (Header) باسم X-API-Key.
X-API-Key: your-secure-api-key-here
مثال على الحمولة (Request Body Example)
يجب أن تكون الحمولة بتنسيق JSON وتحتوي على تفاصيل الطلب.
تأكد من استبدال variant_id بـ ID منتج حقيقي من متجرك.
{
"line_items": [
{
"variant_id": 44765452902718,
"quantity": 1
}
],
"customer": {
"first_name": "John",
"last_name": "Doe",
"email": "john.doe@example.com"
},
"billing_address": {
"first_name": "John",
"last_name": "Doe",
"address1": "123 Fake Street",
"phone": "555-555-5555",
"city": "Faketown",
"province": "ON",
"country": "CA",
"zip": "K1A 0B1"
},
"shipping_address": {
"first_name": "John",
"last_name": "Doe",
"address1": "123 Fake Street",
"phone": "555-555-5555",
"city": "Faketown",
"province": "ON",
"country": "CA",
"zip": "K1A 0B1"
},
"financial_status": "paid",
"note": "هذه ملاحظة إضافية للطلب من النظام الخارجي.",
"tags": "External, API"
}
مثال على أمر Curl
يمكنك استخدام الأمر التالي لاختبار نقطة النهاية:
curl -X POST http://localhost:3000/api/orders \
-H "Content-Type: application/json" \
-H "X-API-Key: your-api-key-here" \
-d '{
"line_items": [
{
"variant_id": 44765452902718,
"quantity": 1
}
],
"customer": {
"first_name": "John",
"last_name": "Doe",
"email": "john.doe@example.com"
},
"billing_address": {
"first_name": "John",
"last_name": "Doe",
"address1": "123 Fake Street",
"phone": "555-555-5555",
"city": "Faketown",
"province": "ON",
"country": "CA",
"zip": "K1A 0B1"
},
"shipping_address": {
"first_name": "John",
"last_name": "Doe",
"address1": "123 Fake Street",
"phone": "555-555-5555",
"city": "Faketown",
"province": "ON",
"country": "CA",
"zip": "K1A 0B1"
},
"financial_status": "paid",
"note": "هذه ملاحظة إضافية للطلب من النظام الخارجي.",
"tags": "External, API"
}'