הגדרת פרופיל אתר ל-reCAPTCHA

1. 1.

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

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

2. 2.

   פתחו את הוספת אתר

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

3. 3.

   הגדירו את נתוני הקלט ללכידה

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

4. 4.

   שלחו את הטופס

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

בדקו את הסטטוס של הפרופיל שנוצר. ACTIVE מוצג כ-active, וזה המצב הנדרש לפתרון. אם הלכידה נכשלת, המסוף מציג סיבה ומאפשר לנסות שוב.

גוף המשימה הזה משתמש בשם המארח ובפעולה מהפרופיל:

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

• site הוא שם המארח מתוך כתובת ה-URL של הדף, ללא הסכמה או הנתיב.
• action היא הפעולה של הבקשה המוגנת. התאימו אותה לפרופיל שבו בכוונתכם להשתמש.
• ברירת המחדל של recaptchaType היא enterprise-v3. עבור פרופיל v3 רגיל, הגדירו אותו במפורש ל-v3.
• החליפו את מציין המיקום של הפרוקסי בפרוקסי HTTP(S) שבו תשתמשו גם לבקשת היעד.

מדריך ההתחלה המהירה ל-Python ומדריך ההתחלה המהירה ל-Node.js מראים איך לשלוח את הבקשה ולהשתמש בתוצאה.

אין פרופיל זמין למשימה.

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

כדאי לנסות: הוסיפו את פרופיל האתר המיועד בסביבת העבודה שתיצור את המשימה. יצירה חוזרת של משימה לא תיצור את הפרופיל החסר.

הפרופיל ממתין בתור, בלכידה, באימות או בבדיקה.

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

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

הלכידה נכשלה.

קראו את סיבת הכשל המוצגת במסוף.

כדאי לנסות: תקנו את הבעיה שצוינה בסיבה, ואז נסו ללכוד שוב.

פרופיל פעיל, אך עדיין לא נמצא פרופיל מתאים לפעולה המיועדת.

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

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