getTaskResult: meminta hasil tugas
Ketika tugas yang dimulai oleh createTask adalah tugas asinkron, dapatkan hasil tugas asinkron melalui getTaskResult.
- Jumlah maksimum permintaan kueri untuk setiap tugas adalah 120. Apabila jumlah permintaan kueri terlampaui, hasil tugas akan hilang.
- Setiap tugas dapat dikueri dalam waktu 5 menit setelah dibuat, dan akan hilang setelah waktu terlampaui.
- Hasil pengenalan yang diperoleh dengan metode ini, tergantung pada beban sistem, Anda akan mendapatkan hasilnya dalam interval waktu 1 detik hingga 30 detik.
PERINGATAN
Harap dicatat bahwa tidak semua tugas perlu mendapatkan hasil dengan cara ini. Dua tugas berikut perlu memeriksa dokumen.
- Tugas kelas identifikasi, ImageToText, dll., yang disinkronkan langsung melalui hasil pengembalian createTask
Contoh permintaan
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 created by the createTask method
}
Parameter Permintaan
Parameter | Tipe | Wajib | Deskripsi |
---|---|---|---|
clientKey | string | Yes | Kunci akun klien, dapat ditemukan di sini |
taskId | string | Yes | ID yang dibuat oleh metode createTask |
Contoh respons
{
"errorId": 0,
"taskId": "...",
"solution": {
"userAgent": "xxx",
"gRecaptchaResponse": "03AGdBq25SxXT-pmSeBXjzScW-EiocHwwpwqtk1QXlJnGnUJCZrgjwLLdt7cb0..."
},
"status": "ready"
}
Struktur Respons
Parameter | Tipe | Deskripsi |
---|---|---|
errorId | Integer | Pesan kesalahan: 0 - tidak ada kesalahan 1 - dengan kesalahan |
errorCode | String | errorCode: daftar lengkap kesalahan |
errorDescription | String | Deskripsi Kesalahan |
status | String | • idle - Menunggu • processing - Sedang diidentifikasi • ready - Identifikasi selesai dan hasilnya ditemukan di parameter solution |
solution | Object | Data hasil tugas. Berbeda untuk setiap jenis tugas |
Spesifikasi respons
-
Pengenalan berhasil: Ketika
errorId
sama dengan0
danstatus
sama denganready
, hasilnya ada disolution
. -
Mengidentifikasi: Ketika
errorId
sama dengan0
danstatus
sama denganprocessing
, silakan coba lagi dalam 3 detik. -
Kesalahan: Ketika
errorId
lebih besar dari0
, silakan ketahui informasi kesalahan sesuai denganerrorDescription
.