solvethree API anahtarınızı oluşturun ve kullanın
Anahtarınızı çözüm için kullanacağınız çalışma alanında oluşturun. Gizli değerin tamamını sunucunuzda tutun; görüntülenen anahtar öneki, kimlik doğrulamak için yeterli değildir.
Bu sayfada
Anahtarınızı oluşturun ve kaydedin
- 1.
API anahtarlarını açın
Konsolda, amaçlanan çalışma alanında
/api-keysyolundaki API anahtarlarını açın. - 2.
Anahtara ad verin
API anahtarı oluştur'u seçin. Anahtar adı alanına, nerede kullanacağınızı hatırlamanıza yardımcı olacak bir ad girin, ardından Anahtar oluştur'u seçin.
- 3.
Gizli değerin tamamını kopyalayın
API anahtarınızı kaydedin bölümünün altındaki gizli değeri kopyalayın ve sunucu uygulamanız için güvenli bir yerde saklayın. Yalnızca bir kez gösterilir.
- 4.
İletişim kutusunu kapatın
Bu anahtarı kaydettim seçeneğini yalnızca gizli değeri sakladıktan sonra seçin.
Anahtarı sunucunuzdan gönderin
İsteklerin kimliğini, Authorization: Bearer ifadesinin ardından çalışma alanı anahtarının tamamını kullanarak doğrulayın. Anahtarı tarayıcı tarafındaki kodda bulundurmayın.
Aşağıdaki örnek için sunucu ortamında SOLVETHREE_API_KEY değerini gizli değerinize, SOLVETHREE_PROXY değerini ise proxy URL'nize ayarlayın. accounts.example.com ve login değerlerini hedefinizin ana makine adı ve eylemiyle değiştirin. Hedef sitenin, bu çalışma alanının erişebildiği etkin bir profili zaten bulunmalıdır; ana makine adını göndermek profil oluşturmaz. Henüz yapılandırmadıysanız site profili kurulumu sayfasına bakın.
# Set SOLVETHREE_API_KEY and SOLVETHREE_PROXY in your environment first.
# Replace the hostname and action with your active site profile.
jq -n \
--arg proxy "$SOLVETHREE_PROXY" \
--arg requestId "login-$(date +%s)-$$" \
'{site:"accounts.example.com", action:"login", proxy:$proxy, requestId:$requestId}' \
| curl --fail-with-body --max-time 30 \
'https://api.solvethree.com/v1/tasks?waitMs=15000' \
-H "Authorization: Bearer $SOLVETHREE_API_KEY" \
-H 'Content-Type: application/json' \
--data-binary @-Bu, herkese açık API'ye bir görev oluşturma isteği gönderir. Yalnızca kimlik doğrulama kontrolü değil, gerçek bir çözüm oluşturur: hazır duruma gelen görev ücretlendirilir. Başarılı bir HTTP yanıtı tek başına görevin hazır olduğu veya hedef web sitesinin çözümü kabul edeceği anlamına gelmez.
Kimlik doğrulama hatalarını görev hatalarından ayırın
- API, HTTP 401 döndürüyor.
Sunucunun Authorization üstbilgisini kontrol edin. Anahtar adı veya gösterilen bir önek değil, Bearer ifadesinin ardından gizli değerin tamamı gerekir. Anahtarın iptal edilip edilmediğini kontrol edin.
Şunu deneyin: Üstbilgiyi düzeltin veya iptal edilen anahtarı değiştirip sunucu yapılandırmanızı güncelleyin. Görev verisini okumaya çalışmadan önce başarısız HTTP yanıtını işleyin.
- Anahtarın kimliği doğrulanıyor ancak amaçlanan site profili kullanılamıyor.
Anahtarın hangi çalışma alanına ait olduğunu ve o çalışma alanında hedef site için etkin bir profil bulunup bulunmadığını doğrulayın. Başka bir çalışma alanına ait geçerli bir anahtar, genel geçer bir kimlik bilgisi değildir.
Şunu deneyin: Amaçlanan profilin bulunduğu çalışma alanına ait bir anahtar kullanın veya profili kullandığınız çalışma alanında kurun. İstekteki ana makine adını değiştirmek profili oluşturmaz.
Diğer istek ve görev başarısızlıkları için CAPTCHA API hataları sayfasına bakın.
Kaynaklar ve API referansı
İlk görevinizi çalıştırın.
$5 çalışma alanı kredisiyle başlayın.