الأدلة
استلام الطلبات بالإشعارات
أسرع طريقة: يصلك الطلب خلال ثوانٍ من وصوله إلى الفرع. تحتاج إلى عنوان HTTPS عام يتحقق من التوقيع. تعمل عندما تكون settings.orders.delivery تساوي webhooks.
سير العمل#
- ليتس بيتزا ← نظامكحدث موقّع لطلب جديد
POST <your URL> · order.created - نظامكيتحقق من التوقيع ويحفظ الطلب
- نظامك ← ليتس بيتزارد 2xx خلال 10 ثوانٍ
- نظامك ← ليتس بيتزاتأكيد الاستلام برقمك
POST /partner/v1/orders/{id}/ack
اشتراكاتك أنت#
بالصلاحية webhooks:manage تدير اشتراكاتك بنفسك عبر /partner/v1/webhooks: العنوان والأحداث، والسجل، وإعادة الإرسال، وحدث اختبار، وسرّ جديد. الفروع هي فروع مفتاحك، ويصلك من الأحداث ما يخصك فقط:
| الأحداث | الصلاحية اللازمة | ما يصلك |
|---|---|---|
order.* · invoice.issued | orders:read | الطلبات التي في سحب طلباتك فقط. |
payment.* | payments:read | مدفوعات طلباتك. |
catalog.published | catalog:read | كل نسخة منيو جديدة تُنشر. |
branch.* · availability.changed | branches:read | فروع مفتاحك. |
order.ack_overdue | orders: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
}'المستقبِل#
- اقرأ الجسم كما وصل (بايتات خام) قبل أي تحويل JSON.
- تحقق من التوقيع والوقت كما في التحقق من التوقيع.
- تجاهل الحدث إذا سبق أن عالجت معرّفه (id).
- احفظ وأجب بـ 2xx فوراً، ثم أكمل العمل بعد الرد.
إذا تعطل المستقبِل#
نعيد المحاولة 5 مرات بتباعد متزايد، ويمكن إعادة إرسال أي حدث من لوحة التحكم. جدول المحاولات. وللاحتياط اسحب الطلبات غير المؤكدة مرة كل بضع دقائق.
الطلبات المستخدمة#
ما يحمل «قريباً» ليس منشوراً بعد في الواجهة، ويُضاف إلى المرجع فور نشره.
- POST
/partner/v1/webhooksاشتراك جديدwebhooks:manageمتاح - GET
/partner/v1/webhooksاشتراكاتكwebhooks:manageمتاح - POST
/partner/v1/webhooks/{id}/testإرسال حدث اختبار موقّعwebhooks:manageمتاح - POST
/partner/v1/webhooks/{id}/deliveries/{deliveryId}/replayإعادة إرسال حدثwebhooks:manageمتاح - POST
/partner/v1/orders/{id}/ackتأكيد الاستلام برقمكorders:ackمتاح - GET
/partner/v1/orders/{id}طلب واحد وحالتهorders:readمتاح