השתמשו במותג הודעות שבבעלות החשבון
השתמשו בחשבון API פעיל באמצעות HTTPS, מכתובת מקור מורשית בפרוטוקול האינטרנט. נתמכות שיטות האימות Basic ו־Bearer. מזהה המותג חייב להיות שייך לאותו חשבון. שמרו בסוד את אסימוני הספק, נתוני זהות המותג והדוחות שהוחזרו.
הזמינו בדיקה חיצונית חדשה
השתמשו ב־POST כאשר נדרשת בדיקה חדשה של המותג בידי ספק בדיקות. אם כבר יש בידיכם תוצאה מספק, השתמשו באפשרות ייבוא במקום זאת. פעולה זו נפרדת מתהליך אימות מחדש של זהות המותג.
תחילה קראו את רשומת המותג הנוכחית ואמתו את פרטי הזהות שלו. בחרו ספק וסוג בדיקה נתמכים מתוך הקטלוגים העדכניים ובדקו את דרישות הספק שנבחר. לא כל ספק תומך בכל סוג בדיקה. הפרטים הנוספים לבדיקה פוליטית חייבים לתאר את הארגון או הקמפיין בפועל, ולא להכיל נתונים לדוגמה.
הכינו את הבקשה לספק
| שדה | ערך |
|---|---|
| evpId | מזהה ספק נדרש מתוך הקטלוג העדכני של ספקי בדיקות חיצוניות, באורך 1–10 תווים. |
| vettingClass | סוג הבדיקה הנתמך שבכוונתכם לרכוש; בחרו בו במפורש ואמתו את מחירו. |
| additionalRequestPayload | מחרוזת המקודדת ב־JSON ובה פרטים ייעודיים לספק, הנדרשת לבדיקה פוליטית. זוהי מחרוזת בתוך אובייקט ה־JSON החיצוני, ולא אובייקט מקונן. אמתו את כל הפרטים הנדרשים מול הספק שנבחר. |
אמתו את החיובים במקרה של הצלחה וכישלון
התעריפים הקמעונאיים הנוכחיים בדולר ארה״ב, כפי שנקראו ב־24 באוקטובר 2026. אמתו את הסכום העדכני לפני ביצוע הזמנה אמיתית. יתרת המימון ששולמה מראש נבדקת מול המחיר להצלחה; יש לאפשר רכישות.
| סוג בדיקה | תוצאה פעילה | תוצאת כישלון |
|---|---|---|
| STANDARD | $46.12 | $5.56 |
| ENHANCED | $112.78 | $6.67 |
| POLITICAL | $73.34 | $24.45 |
| POLITICAL עם בקשת Express | $106.67 | $24.45 |
| AUTHPLUS | $13.89 | $13.89 |
| RCS | $83.34 | $83.34 |
בהזמנות ממתינות נשמרים סכומי החיוב להצלחה ולכישלון, והחיוב מוסדר כאשר מסונכרנת תוצאה מסוג ACTIVE או FAILED. בשני סוגי הבדיקה האחרונים חל אותו תעריף מוגדר בשתי התוצאות הסופיות. תוצאה סופית מיידית עשויה להביא לחיוב במהלך המענה להזמנה. סנכרון סטטוס מאוחר יותר עשוי להסדיר חיוב ממתין.
אל תסתמכו על mock:true כהבטחה לבדיקה חיצונית ללא תשלום. תהליך הסדרת החיוב הנוכחי של בדיקות חיצוניות עדיין עשוי לרשום את ההזמנה ולחייב בגינה. הוראות אלה אינן מחייבות רכישה אמיתית לצורכי בדיקה; השתמשו בנתוני בדיקה מוכנים מראש ללא חיבור לרשת עד שתתכוונו לאשר בדיקה בתשלום.
שלחו הזמנה אחת לאחר בדיקתה
הכינו את vetting-order.json עם מזהה הספק, סוג הבדיקה וכל מידע נוסף שנדרש. הקובץ מכיל את הבקשה שבכוונתכם לבצע בפועל. שמרו אותו בסוד.
curl --silent --show-error --fail-with-body --user "$API_USER:$API_PASSWORD" \
--request POST \
--header 'Content-Type: application/json' \
--header "Idempotency-Key: $IDEMPOTENCY_KEY" \
--data-binary @vetting-order.json \
"https://api.multitel.net/tcr/v2/brand/$BRAND_ID/externalVetting"עקבו אחר התוצאה בפועל
תגובת HTTP מוצלחת עשויה להכיל רשומת בדיקה ממתינה. שמרו את ה־vettingId שלה ובדקו את vettingStatus, הנימוקים, הציון ותאריכי תחילת התוקף ופקיעתו, ככל שהם זמינים. המצבים PENDING ו־UNSCORE דורשים המשך מעקב; המצבים ACTIVE, FAILED ו־EXPIRED מתארים תוצאות שונות. קבלה ברמת HTTP בלבד אינה מוכיחה ציון חיובי או זכאות של הקמפיין.
השתמשו באפשרות סטטוס בדיקה חיצונית כדי לעקוב אחר הרשומה. קריאה או ייבוא של תוצאה סופית עשויים להסדיר את החיוב בגין הזמנה קודמת בתשלום; אין פירוש הדבר בהכרח שהפעולה פטורה מחיוב קיים שטרם הוסדר.
נסו שוב את אותה בקשה מתוכננת
השתמשו ב־Idempotency-Key אחד לכל פעולה מתוכננת ושמרו במדויק את השיטה, הנתיב, מחרוזת השאילתה והבתים של גוף הבקשה. המפתחות תומכים ב־1–128 תווי ASCII ניתנים להדפסה, ללא רווחים. בקשה כפולה בזמן שהפעולה מתבצעת עשויה להחזיר 409 עם Retry-After. בקשות שהושלמו מחזירות מחדש את התגובה השמורה שלהן, לרבות שגיאות. הקפידו על מגבלות קצב הבקשות.
תגובת 502 שנשמרה במטמון עשויה להופיע בעקבות כשל בתעבורה. תגובת 500 שנשמרה במטמון וכוללת requestId עשויה להעיד שהמרשם קיבל את הפעולה אך שמירת הנתונים המקומית או החיוב נכשלו. שמרו את מזהה הבקשה, בדקו את הרשומות הנוכחיות ובררו והסדירו את המצב מול התמיכה לפני שימוש במפתח חדש. אל תניחו שהשגיאה פירושה שלא קיימת הזמנה.