نقاط النهاية والصلاحيات
| الطلب | الصلاحية |
|---|---|
PUT /places/{place_id}/offers/{offer_id} |
offers:write |
GET /places/{place_id}/offers |
offers:write |
DELETE /places/{place_id}/offers/{offer_id} |
offers:write |
ما هي العروض
العرض رسالة جذابة تظهر للعملاء: في صفحة المكان، وفي تبويب العروض، وعلى الخريطة. مثل «وجبة الغداء» أو «عصير مجاني مع كل برجر».
هذه المجموعة قريبا.
نشر عرض
PUT /places/{place_id}/offers/{offer_id} بصلاحية offers:write. offer_id معرفك أنت، حتى 64 حرفا من [A-Za-z0-9_.-]، بلا نقطتين :.
aurmap PUT /v1/places/plc_9q3w7e/offers/lunch-deal '{"title":{"ar":"وجبة الغداء","en":"Lunch deal"},"description":{"ar":"برجر دجاج مع عصير","en":"Chicken burger with a juice"},"image_url":"https://cdn.partner.example/offers/lunch.jpg","kind":"bundle_price","applies_to":{"item_ids":["chicken-burger","orange-juice"]},"bundle_price_minor":2900,"schedule":{"starts_at":"2026-10-15T09:00:00Z","ends_at":"2026-10-31T20:59:00Z","days":[0,1,2,3,4],"from":"12:00","to":"16:00"},"status":"active"}'{ "offer_id": "lunch-deal", "place_id": "plc_9q3w7e", "status": "active", "visible_now": false, "next_visible_at": "2026-10-15T09:00:00Z" }| الحقل | الوصف |
|---|---|
title، description |
خريطة لغات |
image_url |
صورة العرض، https |
kind |
amount_off أو bundle_price أو free_item أو display_only |
applies_to.item_ids |
الأصناف المشمولة من قائمتك |
amount_off_minor |
مع amount_off |
bundle_price_minor |
مع bundle_price |
free_item_id |
مع free_item |
schedule |
starts_at وends_at، ثم days وfrom وto اختيارية بقواعد جداول القائمة: 0 الأحد، وHH:MM بتوقيت المكان |
status |
active أو paused |
await aurmap('PUT', '/v1/places/plc_9q3w7e/offers/lunch-deal', offer, 'offer-lunch-deal-v1');aurmap('PUT', '/v1/places/plc_9q3w7e/offers/lunch-deal', $offer, 'offer-lunch-deal-v1');السعر الذي يدفعه العميل
العرض يظهر للعميل، لكن السعر عند الدفع يأتي من قائمتك أو من تسعير نظامك. إذا نشرت عرضا يغير السعر:
- أرسل أسعارا مؤقتة في
state.pricesعبر التوفر، وأزلها حين ينتهي العرض، أو - طبقه في رد التسعير إذا كنت تسعر من نظامك.
إدارة العروض
| الطلب | الوصف |
|---|---|
GET /places/{place_id}/offers |
كل عروض المكان |
DELETE /places/{place_id}/offers/{offer_id} |
حذف عرض |
العرض المنتهي يختفي تلقائيا، ويصلك offer.expired.