פתרון ה-CAPTCHA הראשון שלכם ב-solvethree

1. 1.

   הרשמה והגדרת סביבת העבודה

   התחילו בהרשמה. השתמשו באותה סביבת עבודה עבור מפתח ה-API, פרופיל האתר והיתרה.

2. 2.

   יצירת מפתח

   פתחו את מפתחות API במסוף. בחרו ביצירת מפתח API, הזינו שם מפתח ואז בחרו ביצירת מפתח.

3. 3.

   שמירת הסוד

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

יתרת ההצטרפות היא $5. אם תצטרכו להוסיף כספים, ההפקדה המינימלית היא $10. עלות reCAPTCHA היא $2.00 לכל 1,000 פתרונות; משימה במצב ready מחויבת בתשלום, ועל פתרון שנכשל ניתן החזר.

1. 1.

   הוספת דף היעד

   פתחו את פרופילי אתרים ובחרו בהוספת אתר. הזינו את כתובת ה-URL של דף היעד ב-HTTPS ובחרו ב-Enterprise v3.

2. 2.

   הגדרת פעולת הלכידה

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

3. 3.

   המתנה למצב פעיל

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

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

שלחו את גוף הבקשה הבא אל POST https://api.solvethree.com/v1/tasks. בצעו אימות באמצעות הכותרת Authorization, עם Bearer ואחריו מפתח ה-API של סביבת העבודה שלכם.

{
  "site": "accounts.example.com",
  "action": "login",
  "proxy": "http://user:[email protected]:8080",
  "requestId": "example_login_001"
}

• החליפו את site בשם המארח של היעד, ולא בכתובת ה-URL המלאה של הדף שלו. החליפו את action בפעולה שנבחרה לפתרון הראשון שלכם.
• החליפו את proxy בכתובת ה-URL ובפרטי ההזדהות של פרוקסי ה-HTTP שלכם. הבקשה הזו משתמשת בפרוקסי אחד; אל תשלחו גם proxyCandidates.
• בחרו requestId עבור הבקשה הלוגית הזו ושמרו אותו עם נתוני הקלט שנשלחו. הוא מקבל 1–64 תווים: אותיות ASCII, ספרות, קווים תחתונים או מקפים.
• אל תכללו את type ואת url. כאשר recaptchaType אינו נכלל, ברירת המחדל של הבקשה היא Enterprise v3.

למימוש מלא ב-Python, השתמשו בreCAPTCHA Enterprise ב-Python. הבקשה כאן מציגה את הערכים שעליכם להכין תחילה.

שמרו את מזהה המשימה שהוחזר בעת היצירה. אחזרו אותה באמצעות GET https://api.solvethree.com/v1/tasks/:id, תוך החלפת :id במזהה הזה ושימוש באותו אימות Bearer.

• בדקו אם התקבלה תגובת HTTP שאינה מציינת הצלחה לפני שתקראו את גוף התגובה כתגובת משימה מוצלחת.
• כל עוד המצב הוא pending או solving, המשיכו בתשאול. אף אחד מהמצבים האלה אינו מכיל פתרון שמיש.
• כשהמצב הוא ready, הפסיקו את התשאול וקראו את solution.
• כשהמצב הוא failed, הפסיקו את התשאול ובדקו את errorCode ואת error. על הפתרון שנכשל ניתן החזר.

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

{
  "id": "example-task",
  "status": "ready",
  "solution": {
    "token": "EXAMPLE_TOKEN",
    "userAgent": "EXAMPLE_USER_AGENT",
    "secChUa": "EXAMPLE_CLIENT_HINTS"
  }
}

1. 1.

   שלחו את הטוקן, ולא את מזהה המשימה

   הכניסו את solution.token למקום שבו היעד המיועד מצפה לקבל את טוקן ה-reCAPTCHA שלו. בדקו את הבקשה היוצאת כדי לוודא שאינה שולחת את מזהה המשימה או טוקן ישן.

2. 2.

   השתמשו בזהות הדפדפן שהוחזרה

   השתמשו ב-solution.userAgent וב-solution.secChUa בבקשה ליעד, יחד עם אותו פרוקסי שסופק לפתרון הזה. אל תשלבו אותם עם זהות דפדפן לא קשורה ואל תשלחו את הטוקן לכתובת URL אחרת של היעד.

3. 3.

   בדקו את תגובת היעד

   ודאו שהיעד קיבל את הפעולה המיועדת. משימה במצב ready פירושה ש-solvethree יצרה פתרון; היא אינה מבטיחה שהיעד יקבל את הבקשה שתשלחו לאחר מכן.

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