פתרון reCAPTCHA v3 רגיל באמצעות ה-API
עבור reCAPTCHA v3 רגיל, הגדירו את recaptchaType ל־v3 בגוף המשימה. עבור reCAPTCHA Enterprise v3, השתמשו ב־enterprise-v3, שהוא גם ברירת המחדל כאשר משמיטים את השדה.
בדף הזה
הכנת הפרופיל, שם המארח, הפעולה והפרוקסי
גם v3 רגיל דורש פרופיל אתר פעיל שזמין לסביבת העבודה שלכם. הגדירו את אתר היעד במסוף לפני יצירת משימה; שליחת שם מארח ופעולה אינה יוצרת את הפרופיל.
site: שם המארח של היעד, כגוןaccounts.example.com, ולא כתובת URL מלאה של דף.action: הפעולה שבה משתמש שילוב ה־reCAPTCHA של היעד. החליפו אתloginשבדוגמה אם היעד משתמש בפעולה אחרת. ראו איך למצוא את הפעולה.proxyאוproxyCandidates: ספקו בדיוק אחד מהם. הדוגמה משתמשת בפרוקסי יחיד. אם אתם משתמשים במקום זאת ברשימת מועמדים, הרשימה מקבלת לכל היותר שתים עשרה כתובות URL שונות של פרוקסי HTTP או HTTPS, ללא נתיב, שאילתה או מקטע.
שליחת משימת v3 רגילה
שלחו את גוף ה־JSON הזה אל POST https://api.solvethree.com/v1/tasks. הזדהו באמצעות מפתח API של סביבת העבודה בכותרת Authorization, בסכמת Bearer. שמרו את המפתח בשרת שלכם.
{
"site": "accounts.example.com",
"action": "login",
"recaptchaType": "v3",
"proxy": "http://user:[email protected]:8080",
"requestId": "v3-login-001"
}recaptchaType שייך לרמה העליונה, לצד site, action ו־proxy. אל תוסיפו שדה type או url עבור reCAPTCHA.
החליפו את שם המארח, הפעולה והפרוקסי שבדוגמה בערכי היעד שלכם. השתמשו ב־requestId חדש לכל פתרון לוגי חדש. אם היצירה חורגת ממגבלת הזמן, שלחו שוב את אותו גוף משימה עם אותו מזהה כדי לשחזר את המשימה הקיימת במקום ליצור משימה נוספת. שימוש חוזר במזהה הזה עם קלט שונה יוצר התנגשות.
המתנה למוכנות ושליחת האסימון
- 1.
בדיקת תגובת ה־HTTP תחילה
טפלו בתגובת HTTP שאינה מציינת הצלחה לפני קריאת הגוף כתוצאת משימה. בדקו את הסטטוס ותקנו את שגיאת הבקשה שדווחה.
- 2.
אחזור המשימה עד לסיומה
היצירה ממתינה עד 15 שניות כברירת מחדל; הגדירו בלקוח מגבלת זמן ארוכה יותר כדי להביא בחשבון את תקורת הרשת. אם המצב הוא
pendingאוsolving, אחזרו את המשימה באמצעותGET /v1/tasks/:id. תשאול GET אינו ממתין כברירת מחדל; לתשאול ארוך, העבירוwaitMsבערך של עד 15000 כפרמטר שאילתה בכתובת ה־URL, ולא כשדה JSON. הפסיקו לתשאל במצבreadyאוfailed. במקרה שלfailed, בדקו אתerrorCodeואתerrorלפני שתחליטו אם יש טעם בניסיון נוסף. - 3.
שימוש בפתרון המוכן
שלחו את
solution.tokenליעד המיועד — לא את מזהה המשימה. השתמשו ב־userAgentוב־secChUaשהוחזרו, יחד עם הפרוקסי שבו הפתרון הצליח. אל תחליפו כתובות IP או תשתמשו בזהות דפדפן שאינה קשורה בין הפתרון לשליחה.
אסימון מוכן אינו הוכחה לציון reCAPTCHA מסוים או לקבלה מצד היעד. reCAPTCHA v3 מפיק ציון סיכון ופעולה שהיעד מעריך בצד השרת שלו; בדקו את תגובת היעד לבקשה ששולחת את האסימון.
מקורות ותיעוד API
הפעלת המשימה הראשונה שלך.
התחילו עם $5 בקרדיט לסביבת העבודה.