UNLOCK API
APIキーを取得
getTaskResult
MarkdownOpenAPI

getTaskResult

タスクの状態を返します。解決中はstatusがprocessingです。完了するとstatusがreadyになり、solutionに答えが入ります。失敗したタスクはerrorId 1と理由を返し、料金はすでに残高に戻っています。
POSThttps://unlock-api.com/getTaskResult
タスク作成後は約5秒待ち、その後5秒ごとに確認してください。5分以内に解決されないタスクはERROR_CAPTCHA_UNSOLVABLEで失敗します。

リクエストパラメータ

clientKey
String必須
アカウントページにある32文字のAPIキーです。
taskId
Integer必須
createTaskが返したIDです。

リクエスト

POST /getTaskResult
{
  "clientKey": "YOUR_API_KEY",
  "taskId": 1001
}

レスポンス

{
  "errorId": 0,
  "status": "processing",
  "taskId": 1001
}

レスポンスフィールド

errorId
Integer
リクエストが成功した場合は0、失敗した場合は1です。
taskId
Integer
タスクIDです。
status
String
解決中はprocessing、完了するとreadyです。
solution
Object
答えです。フィールドはタスクの種類によって異なります。
cost
String
このタスクの料金(米ドル)です。
createTime
Integer
タスクが作成されたUnix時刻です。
endTime
Integer
タスクが解決されたUnix時刻です。
solveCount
Integer
タスクが解決された回数です。常に1です。
errorCode
String
errorIdが1のときのエラー名です。
errorDescription
String
エラーの短い説明(英語)です。

コードサンプル

curl -s https://unlock-api.com/getTaskResult \
  -H "Content-Type: application/json" \
  -d '{"clientKey":"YOUR_API_KEY","taskId":1001}'

このメソッドが返すエラー

  • ERROR_KEY_DOES_NOT_EXIST

    キーが間違っています。アカウントページからもう一度コピーしてください。(in.phpとres.php: ERROR_WRONG_USER_KEY)

  • ERROR_IP_NOT_ALLOWED

    アカウントの許可リストにないIPからのリクエストです。アカウントページでIPを追加してください。

  • ERROR_IP_BANNED

    このアカウントはブロックされています。アカウントページからサポートにお問い合わせください。

  • ERROR_TOO_MANY_REQUESTS

    リクエストが多すぎます。結果確認の間隔を5秒ごとにしてください。

  • ERROR_WRONG_CAPTCHA_ID

    このIDのタスクはお客様のアカウントにありません。

  • ERROR_CAPTCHA_UNSOLVABLE

    時間内にタスクを解決できませんでした。料金は残高に戻っています。