Quickstart: أول طلب محكوم

قبل أن تبدأ

احصل على عنوان بيئة صادر من FoodTech ومفتاح مخصص لنفس البيئة. لا تنقل مفتاح sandbox إلى staging أو production، ولا تضعه في تطبيق العميل أو مستودع Git.

• معرّف نشاط مصرح له.
• فرع مصرح له إن كان العقد branch-scoped.
• مفتاح أو token قصير الصلاحية حسب العقد.
• Idempotency key جديد لكل عملية منطقية.

قالب الطلب

هذا المثال تعليمي ولا يثبت اسم مسار أو ترويسة إنتاجية. استبدل placeholders فقط من عقد موثّق في مرجع API.

curl --request POST '<environment-base-url>/<verified-path>' \
  --header 'Authorization: Bearer <server-side-token>' \
  --header 'Content-Type: application/json' \
  --header 'Idempotency-Key: <uuid-v4>' \
  --data '{"business_id":"<authorized-business>","branch_id":"<authorized-branch>"}'

تحقق من النتيجة

نجاح HTTP وحده لا يثبت نجاح التكامل. طابق correlation_id، راقب إعادة الطلب بنفس idempotency key، وتأكد أن النتيجة لم تنشئ أثرًا مزدوجًا.