https://quickdl.appQuickDL でビルドダウンロード
QuickDL は、開発者がアクティベーション前にコンパクトなリクエストモデルを検査できるようにします。 プライベートキーとクォータが使用可能になる前にサポートが製品を検証する必要があります。
クイックスタート
QuickDL では、API ホストを説明するときにサポートが有効化された証明書が最初に来ます。そのコンパクトなユーティリティは、割り当てられたテナントエンドポイントとともに続き、サーバのみの呼び出しパスで閉じます。
X-API-Key: pending_activation_…QuickDlJobsv1# Available only after support activation
export QUICKDL_JOB_KEY="issued-after-review"
curl -X POST https://quickdl.app/v1/resolve \
-H "X-API-Key: $QUICKDL_JOB_KEY" \
-H "Content-Type: application/json" \
-d '{"public_link":"https://www.youtube.com/watch?v=VIDEO_ID"}'QuickDL は、まずサーバー側の秘密ストレージを識別することで Credential safety を処理します。 クライアントバンドルの埋め込みなしで続き、パブリック ログやリポジトリを視覚化しません。
リンクを解決する
QuickDLでは、ソース検出は、解決操作を説明するときに最初に来ます。そのコンパクトなユーティリティは、1つの提出されたURLからのフォーマットで続き、発明された出力がないときに閉じます。
/v1/resolve範囲:解決| フィールド | タイプ | 必須 | 説明 |
|---|---|---|---|
public_link | HTTPS URL | はい | 分析する公開または認可されたメディアページ。 |
tenant | 文字列 | いいえ | 割り当てられたテナント ドメイン 通常は省略されます。 |
{
"success": true,
"platform": "youtube",
"title": "Example video",
"formats": [
{"id":"18","type":"video","quality":"360p","container":"mp4"}
],
"cached": false
}QuickDL は、返された値を変更せずに最初に識別することで、Format 識別子を処理します。それはリンクごとの利用可能性とともに続き、見通しの中に推測された品質ラベルを保持しません。
ダウンロードジョブを作成して追跡する
QuickDLのコンパクトなユーティリティは、ジョブ作成のための非同期準備をレビューします。それは次に短いHTTPリクエストを示し、境界付きワーカー実行を隠蔽しません。
/v1/jobs範囲:仕事| フィールド | タイプ | 必須 | 説明 |
|---|---|---|---|
public_link | HTTPS URL | はい | 解決するために提出された同じ正規化されたソース。 |
download_option | 文字列 | はい | 解決応答からの正確な ID。 |
tenant | 文字列 | いいえ | 割り当てられたテナント ドメイン 通常は省略されます。 |
curl -X POST https://quickdl.app/v1/jobs \
-H "X-API-Key: $QUICKDL_JOB_KEY" \
-H "Content-Type: application/json" \
-d '{"public_link":"https://www.youtube.com/watch?v=VIDEO_ID","download_option":"18"}'quick_job.GET /v1/jobs/{quick_job} 同じ鍵で| ステータス | 意味 | クライアントアクション |
|---|---|---|
queued | 制限付きキューに受け入れられました。 | バックオフで再度ポールします。 |
extracting | ソースメタデータまたはルートを更新しています。 | 投票を続けてください。 |
processing | ダウンロード、リマスタリングまたはマージ。 | サーバー処理の進行状況を表示します。 |
ready | 署名付きダウンロードが利用可能です。 | URL をユーザーに送信します。 |
failed | ターミナル構造化エラー。 | 読み込み error_code. 勧められた場合のみ再試行してください。 |
expired | 一時的な出力は削除された。 | 新しいジョブを作成します。 |
curl https://quickdl.app/v1/jobs/QUICK_JOB \
-H "X-API-Key: $QUICKDL_JOB_KEY"QuickDLは、ジョブポリングのための3つの実用的なポイントを提示します。最初に1秒の初期待ちが来ます。コンパクトなユーティリティは、次にキャップドバックオフをカバーします。その最後のポイントは、一時的に署名されたデリバリーです。
予測可能な誤り
QuickDL は、1 つの非 2xx 封筒、次にサポート リクエスト ID を介してエラー コントラクトにアプローチします。コンパクトなユーティリティは、予測可能なクライアントの処理を明示的に保持します。
{
"success": false,
"error": {
"code": "RATE_LIMITED",
"category": "rate_limited",
"message": "Too many requests. Please try again shortly.",
"retryable": true,
"details": {"retry_after_seconds": 20}
},
"request_id": "…"
}| 超高速トランザクション処理 | 典型的な意味 | アクション |
|---|---|---|
| 400 | 無効な URL、本体または利用できないフォーマット。 | リクエストを修正します。フォーマットについて再度解決します。 |
| 401 | 欠落、無効、有効期限切れ、またはスコープの間違ったキー。 | サーバ側の認証情報を確認します。 |
| 403 | テナントまたはソースポリシーが要求を拒否しました。 | ポリシーをバイパスしないでください サポートに連絡してください。 |
| 404 | 未知または期限切れのジョブ。 | 適切な場合は新しいジョブを作成します。 |
| 429 | リクエストまたはアクティブジョブの制限に達しました。 | 栄誉 retry_after_seconds. |
| 503 | キュー/容量または上流が一時的に利用できません。 | 指数関数的なバックオフとジッターで再試行します。 |
運用契約
QuickDL は、ソース サービスを不安定にすることなく統合をサポートするコンパクトなクライアント特有のクォータを格納します。
- idempotent アプリケーションロジックを使用し、同じユーザークリックに対して重複ジョブを開始しないでください。
- キャッシュはメタデータを簡単に解決しますが、署名されたダウンロード URL は常に有効期限切れとみなします。
- ジッター付き有界指数バックオフを使用する
429,503再試行可能なエラーを 見つけることができます - パブリックメディアまたはアクセス権限があるメディアのみを処理します。DRMやアクセス制御はバイパスされません。
- リクエスト ID とジョブ ID をプライベートの操作ログに保持します。送信された URL を不必要にログに記録しないでください。
QuickDLでは、Schemas アクセスを説明するとき、探索前のアクティベーションが最初に来ます。そのコンパクトなユーティリティは、割り当てられた認証とともに続き、文書化されたリクエスト形状に閉じます。
サポートを通じてアクティベート
QuickDL に統合名、予想される月間ボリューム、必要なソースを提供します。 サーバが実行する操作を識別するため、承認は狭い範囲の一時キーを生成します。
アクティベーションを要求する キーはテナントスコープであり、撤回可能であり、コンタクトフォームを通じて発行されます。 匿名スクリプトはダウンロードアーの作業を実行できません。