תהליכי עבודה של API

איך מקבלים רשימה של חבילות למכירה פומבית

קוראים ל-LIST API. תמיכה בסינון לפי external_deal_id

יצירת חבילת מכרז חדשה

  1. המזהה החיצוני של המבצע [external_deal_id] חייב להיות ייחודי. מתקשרים אל LIST עם external_deal_id כדי לראות אם המזהה כבר נמצא בשימוש.
  2. מבצעים קריאה ל-Create API. יוקצה שם ייחודי, שאפשר להשתמש בו כדי לאחזר את החבילה שנוצרה.
  3. כדי לראות את הפרטים של חבילת המכרז שנוצרה, שולחים קריאה ל-API של Get.
  4. אופציונלי: מעלים לוגו לחבילה שנוצרה.

עדכון חבילה למכירה פומבית

  1. אם לא שמרתם את השם של חבילת המכרז שנוצרה, תוכלו להתקשר אל LIST API ולסנן לפי external_deal_id כדי לקבל את חבילת המכרז שאתם רוצים לעדכן.
  2. מעדכנים את השדות על סמך התוצאות של LIST API.
  3. שולחים קריאה ל-Patch API כדי לעדכן את חבילת המכרז. השדה updateMask הוא שדה חובה, והוא מציין לאילו שדות רוצים להחיל את העדכון. אפשר להגדיר ב-updateMask רק שדות שאפשר לעדכן.

תהליך הבטא

ההבדל היחיד בין גרסת הבטא לבין הגרסה הזמינה לכולם הוא שבמהלך תקופת הבטא, כשיוצרים חבילות של מכרזים צריך להגדיר את הסטטוס שלהן כ-DISCOVERY_OBJECT_STATUS_PAUSED, ואי אפשר לעדכן את הסטטוס. חבילות שהושהות לא מוצגות בממשק המשתמש של DV3. המטרה היא לספק לבורסות דרך לבדוק שילוב API בלי להציג את חבילות הבדיקה.

מקובל ליצור את כל החבילות ה'אמיתיות' בגרסת בטא כחבילות 'מושהות', ואז להפוך אותן ל'פעילות' אחרי ההשקה הרשמית.

מכסה

‫2,000 חבילות פעילות לכל בורסת פרסום.

‫2,000 חבילות מושהות לכל בורסה.