Meser 10 Verify מייצר את הקוד, שולח אותו, בודק אותו ומגביל ניסיונות ושליחות חוזרות. אתם שולחים שתי קריאות, אחת לשליחה ואחת לבדיקה, ולא צריכים לשמור קודים אצלכם.
איך מתחיליםקוד של 6 ספרות נוצר אצלנו ונשמר רק כגיבוב. הוא לא חוזר אליכם בשום תשובה.
הקוד תקף 5 דקות כברירת מחדל. אפשר לקבוע בין דקה ל-15 דקות בכל שליחה.
אחרי 5 ניסיונות שגויים הבקשה נחסמת, וכל תשובה שגויה מחזירה כמה ניסיונות נשארו.
לאותו מספר: 30 שניות בין שליחות, עד 3 ב-10 דקות ועד 10 ביממה. לחשבון: עד 2,000 שליחות ביום.
יש נוסח מוכן בעברית ובאנגלית. אפשר לכתוב נוסח משלכם, אבל הוא חייב לכלול את הקוד פעם אחת ולא יכול לכלול קישור או מספר טלפון. כך קשה יותר לנצל את השירות לשליחת הודעות מתחזות.
המספר נשמר אצלנו רק כגיבוב עם מפתח (HMAC) ועם מסיכה לתצוגה, ונמחק אחרי 48 שעות. לדוגמה: 050*****67.
שליחת קוד
curl -sS -X POST "https://verify.mesereser.com/v1/send" \
-H "ApiKey: $MESER10_API_KEY" \
-H "Content-Type: application/json" \
-d '{"phone":"0501234567","from":"MyShop","lang":"he"}'
{"ok":true,"id":"<request-id>","expires_in":300,"phone":"050*****67"}
בדיקת הקוד שהמשתמש הקליד
curl -sS -X POST "https://verify.mesereser.com/v1/check" \
-H "ApiKey: $MESER10_API_KEY" \
-H "Content-Type: application/json" \
-d '{"id":"<request-id>","code":"481902","phone":"0501234567"}'
{"ok":true,"verified":true,"phone":"050*****67"}
השדה phone בבדיקה הוא רשות. כששולחים אותו, הקוד מתקבל רק אם הוא שייך לאותו מספר, ומספר שלא תואם נספר כניסיון שגוי.
הקריאות נשלחות מהשרת שלכם בלבד. המפתח הוא מפתח מלא של החשבון ואסור לשים אותו בדפדפן או באפליקציה.
| תשובה | מה זה אומר |
|---|---|
verified: true | הקוד נכון. אפשר לסמן את המספר כמאומת. |
wrong_code | קוד שגוי. מצורף attempts_left. כשהוא 0, זה היה הניסיון החמישי והבקשה נחסמה. |
expired | עבר התוקף, או שנשלח מאז קוד חדש לאותו מספר. שולחים או בודקים את הקוד החדש. |
too_many_attempts | לא נשארו ניסיונות (קורה כשכמה בדיקות נשלחות במקביל). שולחים קוד חדש. |
blocked | הבקשה כבר נחסמה קודם. שולחים קוד חדש. |
not_found | אין בקשה עם ה-id הזה. |
already_used | הקוד כבר אומת פעם אחת ולא יתקבל שוב. |
phone_mismatch | המספר שנשלח בבדיקה אינו המספר שאליו נשלח הקוד. |
בשליחה: too_soon (עם retry_after) אם עברו פחות מ-30 שניות, phone_rate_limited אם עברתם את המגבלה לאותו מספר, account_daily_limit אם החשבון הגיע ל-2,000 ביום, ו-too_many_requests על יותר מדי קריאות בדקה. תשובת upstream_uncertain אומרת שלא ברור אם המסרון יצא, ואז הקוד עדיין תקף ואפשר לבדוק אותו לפי ה-id.
המסרון נשלח דרך חשבון מסר 10 שלכם ומחויב שם כמו כל מסרון.
השירות נפתח בהדרגה. לקבלת גישה לחשבון שלכם פנו לתמיכה. יש גם תיעוד באנגלית.
ב-API הרגיל אתם מייצרים את הקוד, שומרים אותו, בודקים אותו ומגבילים ניסיונות בעצמכם. כאן כל זה נעשה אצלנו, ואתם מקבלים רק כן או לא.
כן, עם השדה template. הנוסח חייב לכלול את {code} פעם אחת, בלי קישורים ובלי מספרי טלפון, ולהיכנס במסרון אחד.
מספרי נייד ישראליים בלבד (05X, גם בפורמט 972). ההגבלה מונעת ניצול של השירות לשליחה יקרה לחו"ל.