UNLOCK API
制限、タイミング、課金

制限、タイミング、課金

リクエスト制限、結果確認の頻度、制限時間、課金のタイミング。

リクエスト制限

1アカウントあたり毎分1,200リクエストまで(全キーの合計、結果確認を含む)、1つのIPアドレスからは毎分2,400リクエストまでです。超えるとERROR_TOO_MANY_REQUESTSが返ります。数秒待ってから続けてください。

確認の頻度

createTaskのあと約5秒待ち、その後5秒ごとにgetTaskResultを呼び出してください。フォームAPIで多数のタスクをまとめて確認するには、res.phpでidsを使います(1リクエストで最大100件のid)。確認を省くには、コールバックかgetTokenを使ってください。
res.php
curl -s "https://unlock-api.com/res.php?key=YOUR_API_KEY&action=get&ids=1001,1002,1003"
# 03AGdBq25SxXT...|CAPCHA_NOT_READY|ERROR_CAPTCHA_UNSOLVABLE

制限時間

5分以内に解決されないタスクはERROR_CAPTCHA_UNSOLVABLEで失敗します。トークンは対象サイトで短時間(reCAPTCHAでは約2分)で期限切れになるため、受け取ったらすぐに使ってください。

課金のタイミング

createTaskがタスクを受け付けた時点で、料金が残高から差し引かれます。タスクが失敗するか時間切れになると、全額が自動で残高に戻ります。エラーで拒否されたリクエストは無料です。getBalance、getTaskResultなどの読み取りメソッドも無料です。

保存するデータ

タスクと一緒に送られた画像、音声、プロキシ情報は、タスク終了時に削除されます。タスクの記録(種類、時刻、状態、料金)はタスク履歴に残ります。