Skip to content
On this page
Home
>API
>getTaskResult: Hasil Tugas

getTaskResult: meminta hasil tugas

Ketika tugas yang dimulai oleh createTask adalah tugas asinkron, dapatkan hasil tugas asinkron melalui getTaskResult.

  1. Jumlah maksimum permintaan kueri untuk setiap tugas adalah 120. Ketika jumlah permintaan kueri melebihi batas tersebut, hasil tugas akan hilang.
  2. Setiap tugas dapat dikueri dalam 5 menit setelah dibuat, dan akan hilang setelah waktu tersebut berlalu.
  3. Hasil pengenalan yang diperoleh dengan metode ini, tergantung pada beban sistem, Anda akan mendapatkan hasil dalam interval waktu 1 detik hingga 30 detik.

WARNING

Perlu diperhatikan bahwa tidak semua tugas perlu mendapatkan hasil dengan cara ini. Dua tugas berikut perlu memeriksa dokumen.

  • Tugas kelas pengenalan, ImageToText, dsb, yang langsung disinkronkan melalui createTask mengembalikan hasil.

Contoh permintaan

json
POST https://api.capsolver.com/getTaskResult
Host: api.capsolver.com
Content-Type: application/json

{
    "clientKey":"YOUR_API_KEY",
    "taskId": "37223a89-06ed-442c-a0b8-22067b79c5b4" //ID yang dibuat oleh metode createTask
}

Parameter Permintaan

ParameterTipeDiperlukanDeskripsi
clientKeystringYesKunci akun klien, dapat ditemukan di sini
taskIdstringYesID yang dibuat oleh metode createTask

Contoh respons

json
{
    "errorId": 0,
    "solution": {
        "userAgent": "xxx",
        "gRecaptchaResponse": "03AGdBq25SxXT-pmSeBXjzScW-EiocHwwpwqtk1QXlJnGnUJCZrgjwLLdt7cb0..."
    },
    "status": "ready"
}

Struktur Respons

ParametersTipeDeskripsi
errorIdIntegerPesan kesalahan:
0 - tanpa kesalahan
1 - dengan kesalahan
errorCodeStringerrorCode: daftar lengkap kesalahan
errorDescriptionStringDeskripsi Kesalahan
statusString• idle - Menunggu
• processing - Dalam proses identifikasi
• ready - Identifikasinya selesai dan hasilnya ditemukan dalam parameter solusi
solutionObjectData hasil tugas. Berbeda untuk setiap jenis tugas

Spesifikasi Respons

  • Sukses pengenalan: Ketika errorId sama dengan 0 dan status sama dengan ready, hasilnya ada di solusi.

  • Sedang Mengidentifikasi: Ketika errorId sama dengan 0 dan status sama dengan processing, harap coba lagi dalam 3 detik.

  • Kesalahan: Ketika errorId lebih besar dari 0, harap ketahui informasi kesalahan sesuai dengan errorDescription.

    errorCode: daftar lengkap kesalahan