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.
X-Verify-Token). שומרים אותו בשרת בלבד, כמו את המפתח.שליחת קוד
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:
| error | HTTP | מה עושים |
|---|---|---|
not_enabled | 403 | אסימון חסר, שגוי או שהתמיכה השביתה אותו. פונים לתמיכה. |
invalid_api_key | 401 | הכותרת ApiKey חסרה או לא בפורמט. |
auth_failed / send_failed | 401 / 400 | המפתח נדחה, השולח לא מאומת או שאין יתרה. לא שולחים שוב אוטומטית: בודקים את המפתח, השולח והיתרה. |
sender_not_verified, no_credits, rejected | 502 | השולח לא מאומת, אין יתרת מסרונים, או שהשליחה נדחתה. |
upstream_uncertain | 502 | לא ברור אם המסרון יצא. התשובה כוללת id: שומרים אותו, הקוד תקף ואפשר לבדוק אותו. לא שולחים שוב מיד. |
upstream_blocked | 502 | תקלה זמנית בצד שלנו. מנסים שוב בעוד כמה דקות. |
too_soon | 429 | פחות מ-30 שניות מהשליחה הקודמת לאותו מספר. ממתינים retry_after שניות. |
phone_rate_limited | 429 | עד 3 שליחות ב-10 דקות ו-10 ביממה לאותו מספר מאותו חשבון, ועד 30 בשעה לאותו מספר מכל החשבונות יחד. |
account_daily_limit | 429 | החשבון הגיע ל-2,000 שליחות היום. המונה מתאפס בחצות UTC. |
too_many_requests | 429 | יותר מדי קריאות בדקה (בשליחה ובבדיקה). מאטים. |
key_refused | 401 | ה-API של מסר 10 דחה את המפתח. השליחות נעצרות ל-15 דקות (יותר אם זה חוזר) וחוזרות לבד, והבדיקות ממשיכות לעבוד. מתקנים את המפתח. |
token_daily_limit | 429 | האסימון הגיע למגבלת השליחות היומית שלו (2,000 אם התמיכה לא קבעה אחרת). מתאפס בחצות UTC. |
phone_required | 400 | בבדיקה חסר phone. שולחים את המספר שאליו נשלח הקוד. |
too_many_failures | 429 | הרבה שליחות שנדחו ב-10 דקות. בודקים את הסיבה לפני שממשיכים. |
temporarily_unavailable | 503 | השירות עוצר שליחות כדי להגן על כל החשבונות, בין שנייה ל-15 דקות. ממתינים retry_after שניות. |
invalid_phone, invalid_from, template_*, invalid_input, invalid_json | 400 | הבקשה לא תקינה. מתקנים את השדה. |
payload_too_large | 413 | גוף הבקשה מעל 4KB. |
forbidden, method_not_allowed, not_found | 403 / 405 / 404 | כתובת או שיטה לא נכונה. שולחים POST ל-/v1/send או ל-/v1/check. |
internal_error | 500 | תקלה אצלנו. מנסים שוב מאוחר יותר. |
כלל אצבע לניסיון חוזר: על 429 ו-503 ממתינים את retry_after. על 400, 401 ו-403 לא מנסים שוב לפני שמתקנים. על upstream_uncertain לא שולחים קוד חדש, אלא בודקים את הקוד לפי ה-id.
חשבון שהגביל את ה-API לכתובות IP מסוימות לא יכול להשתמש ב-Verify, כי השירות פונה מכתובות של Cloudflare. במקרה כזה פנו לתמיכה.
המסרון נשלח דרך חשבון מסר 10 שלכם ומחויב שם כמו כל מסרון.
השירות נפתח בהדרגה. לקבלת גישה לחשבון שלכם פנו לתמיכה. יש גם תיעוד באנגלית.
ב-API הרגיל אתם מייצרים את הקוד, שומרים אותו, בודקים אותו ומגבילים ניסיונות בעצמכם. כאן כל זה נעשה אצלנו, ואתם מקבלים רק כן או לא.
כן, עם השדה template. הנוסח חייב לכלול את {code} פעם אחת, בלי קישורים, בלי מספרי טלפון ובלי מילים כמו כרטיס, אשראי, סיסמה או בנק, ולהיכנס במסרון אחד.
מספרי נייד ישראליים בלבד (05X, גם בפורמט 972). ההגבלה מונעת ניצול של השירות לשליחה יקרה לחו"ל.
עוד על הדרך שבה אנחנו עובדים: פלטפורמת דיוור לא מייצרים בלחיצה.