İlk çözümünüz

Tek bir istekte token, üstbilgi kümesi veya çerez oluşturun ve oluşturulduğu kimlikle birlikte gönderin.

REST · v1

hızlı başlangıç

  1. 01Token oluşturun
  2. 02Kasada oluşturun
  3. 03TMPT oluşturun
  4. 04Asenkron yedek akış
  5. 05Hataları ele alın

temel URL

https://api.solvethree.com/v1

kimlik doğrulama

Authorization: Bearer <key>

Eksiksiz Markdown entegrasyon referansı.

Token oluşturun

POST /v1/tasks · 201

curl https://api.solvethree.com/v1/tasks \
  -H "Authorization: Bearer $SOLVETHREE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "site": "accounts.example.com",
    "action": "login",
    "proxy": "http://user:[email protected]:8080",
    "requestId": "login_20260910_0001"
  }'
{
  "id": "login_20260910_0001",
  "status": "ready",
  "solution": {
    "token": "03AFcWeA5…kQ2b",
    "userAgent": "Mozilla/5.0 (Windows NT 10.0; Win64; x64) …",
    "secChUa": "\"Chromium\";v=\"140\", \"Not=A?Brand\";v=\"24\""
  },
  "durationMs": 1742
}

Oluşturma isteği en fazla 15 saniye bekler ve normalde tamamlanmış tokenı döndürür. Sitenin bu çalışma alanında etkin bir profili olmalıdır. Sınırsız planınıza atanmış bir site plana dahildir; diğer her site için bir kullandıkça öde kredisi ayrılır.

İsteğe bağlı alanlar (proxy veya proxyCandidates gereklidir)

recaptchaType
Standart v3 için "v3" kullanın. Geriye uyumlu "enterprise-v3" varsayılanı için bu alanı göndermeyin.
requestId
Size ait, 1–64 karakterlik idempotency anahtarı. Tekrar gönderildiğinde aynı görevi döndürür.
proxyCandidates
En fazla altı farklı HTTP(S) proxy. solution.egressAttempts, başarılı adayın 1 tabanlı dizinidir. Oturumlar tek bir proxy gerektirir.
userAgent, secChUa
Tokenla kullanacağınız tarayıcı kimliğini sabitleyin.
timezoneOffsetMinutes
Tokenı gönderen istemcinin saat dilimiyle eşleştirin.
session
Birden fazla adımlı akışlarda görevler arasında aynı oturumu koruyun.

Kasada üstbilgileri oluşturun

Her 1,000 için $1.25 · başarısız işlerin ücreti iade edilir

curl https://api.solvethree.com/v1/tasks \
  -H "Authorization: Bearer $SOLVETHREE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "type": "KasadaTask",
    "url": "https://www.ticketmaster.com/discovery/v2/events",
    "proxy": "http://user:[email protected]:8080"
  }'
{
  "id": "req_92ad…",
  "status": "ready",
  "solution": {
    "userAgent": "Mozilla/5.0 (Windows NT 10.0; Win64; x64) …",
    "secChUa": "\"Chromium\";v=\"151\", \"Google Chrome\";v=\"151\"",
    "headers": {
      "x-kpsdk-ct": "…",
      "x-kpsdk-cd": "…",
      "x-kpsdk-h": "…",
      "x-kpsdk-v": "…"
    },
    "egressAttempts": 1
  }
}

Bağımsız Kasada şu anda www.ticketmaster.com üzerindeki HTTPS hedeflerini destekler. Döndürülen tüm üstbilgileri, döndürülen tarayıcı kimliği ve başarılı proxy ile hemen uygulayın. Üstbilgi kümeleri hedefe, kimliğe ve çıkışa bağlıdır. Bu görevleri planınıza dahil etmek için Kasada'yı sınırsız plan kontenjanına atayın.

Ticketmaster TMPT oluşturun

Her 1,000 için $0.99 · başarısız işlerin ücreti iade edilir

curl 'https://api.solvethree.com/v1/tasks?waitMs=75000' \
  -H "Authorization: Bearer $SOLVETHREE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "type": "TicketmasterTmptTask",
    "url": "https://www.ticketmaster.com/example/event/1A2B3C4D5E6F7A8B",
    "action": "Event",
    "proxy": "http://user:[email protected]:8080"
  }'
{
  "id": "req_7f4c…",
  "status": "ready",
  "solution": {
    "token": "tmpt-cookie-value…",
    "userAgent": "Mozilla/5.0 (Windows NT 10.0; Win64; x64) …",
    "secChUa": "\"Chromium\";v=\"151\", \"Google Chrome\";v=\"151\"",
    "egressAttempts": 1
  },
  "durationMs": 2310
}

Ticketmaster URL'si gereklidir; istek kimliği gerekli değildir. Tam etkinlik URL'siyle action Event, oturum açma giriş URL'siyle Login kullanın. TMPT oluşturma, hazır bir çözümün doğrudan dönebilmesi için varsayılan olarak en fazla 1.5 saniye bekler; yeni işlem gerektiğinde bekleyen bir göreve geçilir. Tamamen asenkron oluşturma için URL sorgu parametresini waitMs=0, daha uzun ama sınırlı bir bekleme için en fazla waitMs=75000 olarak ayarlayın; ardından görev durumunu inceleyin ve son duruma ulaşmadıysa sorgulamaya devam edin. Token, ham tmpt çerez değeridir. Bu görevleri planınıza dahil etmek için Ticketmaster TMPT'yi sınırsız plan kontenjanına atayın.

Asenkron yedek akış

GET /v1/tasks/:id · 200

curl https://api.solvethree.com/v1/tasks/login_20260910_0001 \
  -H "Authorization: Bearer $SOLVETHREE_API_KEY"
pendingGörev kabul edildi, henüz işleme alınmadı.
solvingBir işleyici tokenı oluşturuyor.
readyToken solution alanında mevcut. Ücretlendirildi.
failederrorCode alanına bakın. Kredi iade edilir.
{
  "id": "login_20260910_0001",
  "status": "ready",
  "solution": {
    "token": "03AFcWeA5…kQ2b",
    "userAgent": "Mozilla/5.0 (Windows NT 10.0; Win64; x64) …",
    "secChUa": "\"Chromium\";v=\"140\", \"Not=A?Brand\";v=\"24\""
  },
  "durationMs": 1742
}

Çoğu entegrasyon bu isteğe hiç ihtiyaç duymaz. Yalnızca oluşturma yanıtı senkron bekleme süresinden sonra pending veya solving durumunda kalırsa ya da bağlantı kesintisinden sonra idempotent bir görevi geri almak için kullanın. Kasada en fazla 75 saniye bekler, reCAPTCHA ise 15 saniye kullanır. TMPT varsayılan olarak en fazla 1.5 saniye bekler; tamamen asenkron oluşturma için waitMs=0 veya TMPT için açıkça belirtilmiş, en fazla 75 saniyelik bir waitMs kullanın.

Hataları ele alın

status · failed

{
  "id": "login_20260910_0001",
  "status": "failed",
  "errorCode": "site-unreachable",
  "error": "target page did not respond",
  "durationMs": 9210
}
401geçersiz API anahtarı
402yetersiz kredi
403site profili etkin değil
409istek kimliği çakışması
429hız sınırı aşıldı · retry-after: 60
502oluşturma hizmeti kullanılamıyor · iade edildi
503oluşturma hizmeti kapasitesi dolu · iade edildi · retry-after: 1

Kimlik dahil

Token, oluşturulduğu userAgent ve secChUa değerleriyle birlikte gelir. Bunları birlikte gönderin.

Başarısız çözümler ücretsizdir

failed durumuyla sonlanan bir görevin ücreti otomatik olarak bakiyenize iade edilir.

Gizli bilgiler güvende

Tokenlar, çerezler, proxy'ler ve parmak izleri görev listelerine ve günlüklere dahil edilmez.

API dokümantasyonu · solvethree