למה solvethree משתמש בפרופיל אתר במקום בשדה websiteKey
solvethree שומר את מפתח האתר של reCAPTCHA ואת הגדרות הדף בפרופיל אתר. בקשת המשימה מספקת את שם המארח ב-site, את פעולת הביצוע ב-action ופרוקסי — לא websiteKey או websiteURL.
אם אתם עוברים מ-API אחר, לא מדובר רק בשינוי שמות של שדות. הגדירו תחילה פרופיל פעיל בסביבת העבודה שלכם; שליחת שם מארח, פעולה או מפתח אתר אינה יוצרת פרופיל.
בדף הזה
הגדירו את מפתח האתר והדף במסוף
- 1.
פתחו את הוספת אתר
עברו אל פרופילי אתרים ובחרו בהוספת אתר. הזינו את כתובת ה-URL של דף היעד ב-HTTPS. המשימה תשתמש בשם המארח שלו, ולא בכתובת ה-URL המלאה הזו. ספקו את כתובת ה-URL האופציונלית לניווט ואת ערך Referer אם הם נחוצים להגדרת הדף.
- 2.
בחרו את הסוג ובדקו את מפתח האתר
בחרו Enterprise v3 לאינטגרציית reCAPTCHA Enterprise, או Regular v3 ל-reCAPTCHA v3 רגיל. הטופס יכול לזהות אוטומטית את מפתח האתר; אפשר להזין ערך חלופי בשדה האופציונלי של מפתח האתר.
- 3.
הגדירו את פעולת הלכידה
פעולת הלכידה היא שדה חובה. עבור הבקשה שלהלן, הגדירו פרופיל עם פעולת הלכידה
login. פרופילי מערכת שנבדקו יכולים למלא את הגדרות הדף ופעולת הלכידה הידועות ללא שליפה בזמן אמת; קראו את ההסבר בטופס על הפעולה שנבחרה. - 4.
שלחו והמתינו להפעלה
בחרו בהוספת אתר. בקשות עשויות לעבור במצבי תור, לכידה, אימות או בדיקה לפני שיהפכו לפעילות; אין משך לכידה מובטח. בחלק מהחשבונות מוצגת האפשרות להוסיף זיכוי כדי להמשיך. אם הלכידה נכשלת, בדקו את הסיבה לפני ניסיון חוזר.
השתמשו בפרופיל אחד לכל שילוב של שם מארח, פעולת לכידה וסוג reCAPTCHA. התאמה מדויקת של פעולת הביצוע בוחרת את הפרופיל שלה. פעולות ביצוע אחרות דורשות יעד לכידה חד-משמעי אחד, ולכן אל תניחו שפרופיל יחיד לשם מארח מכסה כל פעולה.
שלחו את בקשת המשימה השטוחה
לאחר שהפרופיל פעיל, שלחו את האובייקט הזה ישירות כגוף JSON אל POST /v1/tasks. בצעו אימות באמצעות Authorization: Bearer ואחריו מפתח ה-API של סביבת העבודה שלכם, ושמרו את המפתח בשרת.
{
"site": "accounts.example.com",
"action": "login",
"proxy": "http://user:[email protected]:8080",
"requestId": "example_login_001"
}siteהוא שם המארח: ללא סכימה, נתיב או שאילתה. כתובת ה-URL המלאה של הדף שייכת לפרופיל במסוף.actionהיא פעולת הביצוע של המשימה הזו. כאן,loginתואמת לפעולת הלכידה שהוגדרה לעיל.proxyמספק את הפרוקסי לפתרון. נדרש בדיוק אחד מהשדותproxyאוproxyCandidates; אל תשלחו את שניהם.requestIdהוא אופציונלי. אם יצירת המשימה מסתיימת בחריגה מזמן ההמתנה, שליחה חוזרת של אותה בקשה עם אותו מזהה מחזירה את המשימה הקיימת. שינוי קלטי המשימה תוך שימוש חוזר באותו מזהה יוצר התנגשות.
אל תעבירו את websiteKey, websiteURL, type או url ממבנה הבקשה של ה-API הקודם. ב-reCAPTCHA, ברירת המחדל של recaptchaType היא enterprise-v3, ולכן השדה אינו נכלל בדוגמה. ב-Regular v3 משתמשים ב-recaptchaType עם הערך v3.
מקורות ותיעוד API
הפעלת המשימה הראשונה שלך.
התחילו עם $5 בקרדיט לסביבת העבודה.