03-7440020+1 917-277-5362+44 203 146-8524
כניסת לקוחות
פתחו חשבון חינם
MESER 10 VERIFY

אימות טלפון ב-SMS בשתי קריאות API

Meser 10 Verify מייצר את הקוד, שולח אותו, בודק אותו ומגביל ניסיונות ושליחות חוזרות. אתם שולחים שתי קריאות, אחת לשליחה ואחת לבדיקה, ולא צריכים לשמור קודים אצלכם.

איך מתחילים

מה זה ולמי זה

מסר 10 Verify הוא שירות מוכן לאימות מספר טלפון. כשלקוח נרשם לאתר או לאפליקציה שלכם, מתחבר, או מבצע פעולה רגישה, אתם רוצים לוודא שהמספר באמת שלו. אנחנו שולחים לו קוד ב-SMS, בודקים שהקוד שהקליד נכון, ומחזירים לכם תשובה ברורה: כן או לא.

למי זה מתאים

לכל עסק עם אתר או אפליקציה שצריך לאמת מספר טלפון: בהרשמה, בכניסה, באיפוס סיסמה, או כאימות דו-שלבי (2FA) לפני פעולה רגישה.

מה אתם מרוויחים

במקום לבנות מערכת שלמה שמייצרת קוד, שומרת אותו, בודקת אותו, חוסמת ניחושים ומונעת ניצול לרעה, אתם שולחים שתי קריאות בלבד: אחת לשליחת הקוד ואחת לבדיקה. כל השאר נעשה אצלנו.

דוגמה

לקוח נרשם בחנות שלכם ומקליד מספר טלפון. אנחנו שולחים לו SMS עם קוד, הוא מקליד אותו באתר, אתם שואלים אותנו אם הקוד נכון, ומקבלים אישור שהמספר באמת שלו.

מה לא צריך לבנות לבד

יצירת קוד ושמירתו

קוד של 6 ספרות נוצר אצלנו ונשמר רק כגיבוב. הוא לא חוזר אליכם בשום תשובה.

תוקף

הקוד תקף 5 דקות כברירת מחדל. אפשר לקבוע בין דקה ל-15 דקות בכל שליחה.

הגבלת ניחושים

אחרי 5 ניסיונות שגויים הבקשה נחסמת, וכל תשובה שגויה מחזירה כמה ניסיונות נשארו.

הגבלת שליחות חוזרות

לאותו מספר: 30 שניות בין שליחות, עד 3 ב-10 דקות ועד 10 ביממה. לחשבון: עד 2,000 שליחות ביום.

נוסח בלי קישורים

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

מספרי טלפון

המספר נשמר אצלנו רק כגיבוב עם מפתח (HMAC) ועם מסיכה לתצוגה, ונמחק אחרי 48 שעות. לדוגמה: 050*****67.

התחלה מהירה

מדריך מלא עם קוד ב-Node.js וב-PHP ופתרון בעיות: מדריך התמיכה ל-Verify.

  1. פותחים חשבון במסר 10 ומנפיקים מפתח API בהגדרות המתקדמות.
  2. מאמתים שם שולח (2 עד 11 אותיות לטיניות, ספרות או רווחים) או מספר שולח.
  3. מבקשים מהתמיכה להפעיל את Verify לחשבון, ומקבלים אסימון גישה (X-Verify-Token). שומרים אותו בשרת בלבד, כמו את המפתח.
  4. שולחים קוד, ואחר כך בודקים את מה שהמשתמש הקליד.

שליחת קוד

curl -sS -X POST "https://verify.mesereser.com/v1/send" \
  -H "ApiKey: $MESER10_API_KEY" \
  -H "X-Verify-Token: $MESER10_VERIFY_TOKEN" \
  -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 "X-Verify-Token: $MESER10_VERIFY_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"id":"<request-id>","code":"481902","phone":"0501234567"}'

{"ok":true,"verified":true,"phone":"050*****67"}

השדה phone בבדיקה הוא חובה: הקוד מתקבל רק למספר שאליו נשלח, ומספר שלא תואם נספר כניסיון שגוי.

הקריאות נשלחות מהשרת שלכם בלבד. המפתח הוא מפתח מלא של החשבון ואסור לשים אותו בדפדפן או באפליקציה.

מדריך עיון: שדות, תשובות ושגיאות

גרסה למכונות: openapi.json (OpenAPI 3.1). קוד ב-Node.js, PHP, Python, cURL ו-C# נמצא במדריך התמיכה. מצב בדיקה: אסימון בדיקה לא שולח SMS ומחזיר test, test_code ו-message. מילוי אוטומטי: autofill הוא web או android. שגיאות: autofill_not_configured (עוד לא הוגדרו דומיין או hash לאסימון) ו-invalid_autofill.

שדות בשליחה (POST /v1/send): phone נייד ישראלי (05X, גם 972 או +972). from שם שולח מאומת (2 עד 11 אותיות לטיניות, ספרות או רווחים) או מספר שולח מאומת (0 ועוד 8 עד 9 ספרות). lang הוא he או en (כל ערך אחר נחשב he). ttl תוקף בשניות, 60 עד 900 (ערך מחוץ לטווח מתוקן לקצה הקרוב). template נוסח משלכם, רשות.

כללי הנוסח: {code} פעם אחת בדיוק. אותיות עבריות ולטיניות, ספרות, רווחים וסימני פיסוק בסיסיים בלבד. בלי קישורים או קיצורי קישורים, בלי מספרי טלפון, ובלי מילים כמו כרטיס, אשראי, סיסמה או בנק. עד 70 תווים בנוסח עם עברית ועד 160 בנוסח לטיני, כדי שייכנס במסרון אחד.

בבדיקה (POST /v1/check) שולחים את אותו ApiKey ואת אותו אסימון של השליחה. מפתח אחר יקבל not_found.

תשובת בדיקה מגיעה ב-200. רק קוד שאומת מחזיר "ok":true. כשהקוד לא אומת מגיע "ok":false ו-"verified":false, והסיבה בשדה error (וגם ב-reason), למשל:

{"ok":false,"verified":false,"error":"wrong_code","reason":"wrong_code","attempts_left":3}
error / reasonמה זה אומר ומה עושים
wrong_codeקוד שגוי, מצורף attempts_left. כשהוא 0 הבקשה נחסמה.
phone_mismatchהמספר בבדיקה אינו המספר שאליו נשלח הקוד. נספר כניסיון.
expiredעבר התוקף, או שנשלח מאז קוד חדש לאותו מספר. שולחים או בודקים את החדש.
blocked / too_many_attemptsנגמרו הניסיונות. שולחים קוד חדש.
already_usedהקוד כבר אומת פעם אחת.
not_foundאין בקשה כזו למפתח הזה.

שגיאות מגיעות עם "ok":false והשם בשדה error:

errorHTTPמה עושים
not_enabled403אסימון חסר, שגוי או שהתמיכה השביתה אותו. פונים לתמיכה.
invalid_api_key401הכותרת ApiKey חסרה או לא בפורמט.
auth_failed / send_failed401 / 400המפתח נדחה, השולח לא מאומת או שאין יתרה. לא שולחים שוב אוטומטית: בודקים את המפתח, השולח והיתרה.
sender_not_verified, no_credits, rejected502השולח לא מאומת, אין יתרת מסרונים, או שהשליחה נדחתה.
upstream_uncertain502לא ברור אם המסרון יצא. התשובה כוללת id: שומרים אותו, הקוד תקף ואפשר לבדוק אותו. לא שולחים שוב מיד.
upstream_blocked502תקלה זמנית בצד שלנו. מנסים שוב בעוד כמה דקות.
too_soon429פחות מ-30 שניות מהשליחה הקודמת לאותו מספר. ממתינים retry_after שניות.
phone_rate_limited429עד 3 שליחות ב-10 דקות ו-10 ביממה לאותו מספר מאותו חשבון, ועד 30 בשעה לאותו מספר מכל החשבונות יחד.
account_daily_limit429החשבון הגיע ל-2,000 שליחות היום. המונה מתאפס בחצות UTC.
too_many_requests429יותר מדי קריאות בדקה (בשליחה ובבדיקה). מאטים.
key_refused401ה-API של מסר 10 דחה את המפתח. השליחות נעצרות ל-15 דקות (יותר אם זה חוזר) וחוזרות לבד, והבדיקות ממשיכות לעבוד. מתקנים את המפתח.
token_daily_limit429האסימון הגיע למגבלת השליחות היומית שלו (2,000 אם התמיכה לא קבעה אחרת). מתאפס בחצות UTC.
phone_required400בבדיקה חסר phone. שולחים את המספר שאליו נשלח הקוד.
too_many_failures429הרבה שליחות שנדחו ב-10 דקות. בודקים את הסיבה לפני שממשיכים.
temporarily_unavailable503השירות עוצר שליחות כדי להגן על כל החשבונות, בין שנייה ל-15 דקות. ממתינים retry_after שניות.
invalid_phone, invalid_from, template_*, invalid_input, invalid_json400הבקשה לא תקינה. מתקנים את השדה.
payload_too_large413גוף הבקשה מעל 4KB.
forbidden, method_not_allowed, not_found403 / 405 / 404כתובת או שיטה לא נכונה. שולחים POST ל-/v1/send או ל-/v1/check.
internal_error500תקלה אצלנו. מנסים שוב מאוחר יותר.

כלל אצבע לניסיון חוזר: על 429 ו-503 ממתינים את retry_after. על 400, 401 ו-403 לא מנסים שוב לפני שמתקנים. על upstream_uncertain לא שולחים קוד חדש, אלא בודקים את הקוד לפי ה-id.

חשבון שהגביל את ה-API לכתובות IP מסוימות לא יכול להשתמש ב-Verify, כי השירות פונה מכתובות של Cloudflare. במקרה כזה פנו לתמיכה.

כמה זה עולה

המסרון נשלח דרך חשבון מסר 10 שלכם ומחויב שם כמו כל מסרון.

השירות נפתח בהדרגה. לקבלת גישה לחשבון שלכם פנו לתמיכה. יש גם תיעוד באנגלית.

שאלות נפוצות

מה ההבדל משליחת קוד דרך ה-API הרגיל?

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

אפשר לשנות את הנוסח?

כן, עם השדה template. הנוסח חייב לכלול את {code} פעם אחת, בלי קישורים, בלי מספרי טלפון ובלי מילים כמו כרטיס, אשראי, סיסמה או בנק, ולהיכנס במסרון אחד.

לאילו מספרים אפשר לשלוח?

מספרי נייד ישראליים בלבד (05X, גם בפורמט 972). ההגבלה מונעת ניצול של השירות לשליחה יקרה לחו"ל.

למה מסר 10

  • פועלים מאז 2009, ומאז נשלחו דרכנו מיליארדי מיילים.
  • את חימום הדומיין ואת ניקוי הרשימות אנחנו מבצעים עבורכם, לא רק מסבירים איך.
  • בתמיכה עונים אנשים שמכירים את המערכת מבפנים ויכולים לבדוק מה קרה בחשבון שלכם.
  • שרתים בישראל וממשק בעברית.
  • דירוג 4.9 בגוגל.

מי שולח דרכנו

דיוור מנוהלאתם שולחים תוכן, אנחנו בונים ושולחים שולח חדשהכנה וחימום לפני שמתחילים לשלוח עיתון יומי וגיליונותהקובץ מצורף למייל עצמו דברי תורה ועלוני פרשהמגיעים גם לתיבות מסוננות כנסים, אירועים והזמנותהזמנה במייל ותזכורת ב-SMS חנויות אונלייןהרוכשים מצטרפים לרשימה אוטומטית הודעות מערכת וחשבוניותנשלחות מהמערכת שלכם דרך ה-API קודי אימות (OTP)קוד חד-פעמי ב-SMS

עוד על הדרך שבה אנחנו עובדים: פלטפורמת דיוור לא מייצרים בלחיצה.