مطوّرو ليتس بيتزاv1.0.0

الأدلة

استلام الطلبات بالإشعارات

أسرع طريقة: يصلك الطلب خلال ثوانٍ من وصوله إلى الفرع. تحتاج إلى عنوان HTTPS عام يتحقق من التوقيع. تعمل عندما تكون settings.orders.delivery تساوي webhooks.

سير العمل#

  1. ليتس بيتزا ← نظامكحدث موقّع لطلب جديدPOST <your URL> · order.created
  2. نظامكيتحقق من التوقيع ويحفظ الطلب
  3. نظامك ← ليتس بيتزارد 2xx خلال 10 ثوانٍ
  4. نظامك ← ليتس بيتزاتأكيد الاستلام برقمكPOST /partner/v1/orders/{id}/ack

اشتراكاتك أنت#

بالصلاحية webhooks:manage تدير اشتراكاتك بنفسك عبر /partner/v1/webhooks: العنوان والأحداث، والسجل، وإعادة الإرسال، وحدث اختبار، وسرّ جديد. الفروع هي فروع مفتاحك، ويصلك من الأحداث ما يخصك فقط:

الأحداثالصلاحية اللازمةما يصلك
order.* · invoice.issuedorders:readالطلبات التي في سحب طلباتك فقط.
payment.*payments:readمدفوعات طلباتك.
catalog.publishedcatalog:readكل نسخة منيو جديدة تُنشر.
branch.* · availability.changedbranches:readفروع مفتاحك.
order.ack_overdueorders:readعن طلباتك أنت فقط: طلب لم تؤكد استلامه في المهلة.

وتصل بيانات العميل كاملة أو مختصرة بحسب إعداد settings.customerData الحالي لدى ليتس بيتزا، لا بحسب طلب الاشتراك. يظهر سرّ التوقيع مرة واحدة عند الإنشاء؛ إن ضاع فاطلب سرّاً جديداً.

curl -sS -X POST "$LP_BASE_URL/partner/v1/webhooks" \
  -H "Authorization: Bearer $LP_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  --data '{
  "name": "string",
  "url": "string",
  "events": [
    "order.created"
  ],
  "branches": [
    "string"
  ],
  "pii": true,
  "active": true
}'

المستقبِل#

  1. اقرأ الجسم كما وصل (بايتات خام) قبل أي تحويل JSON.
  2. تحقق من التوقيع والوقت كما في التحقق من التوقيع.
  3. تجاهل الحدث إذا سبق أن عالجت معرّفه (id).
  4. احفظ وأجب بـ 2xx فوراً، ثم أكمل العمل بعد الرد.

إذا تعطل المستقبِل#

نعيد المحاولة 5 مرات بتباعد متزايد، ويمكن إعادة إرسال أي حدث من لوحة التحكم. جدول المحاولات. وللاحتياط اسحب الطلبات غير المؤكدة مرة كل بضع دقائق.

الطلبات المستخدمة#

ما يحمل «قريباً» ليس منشوراً بعد في الواجهة، ويُضاف إلى المرجع فور نشره.