プレビュー版のみ - アクティベーションが必要

QuickT でビルドダウンロード

QuickT は、モバイル クライアントがサービスと通信する方法を文書化します。サポートが設計を承認し、スコープ付きアクセスを有効にするまで、プロダクション ワークを提出することはできません。

QuicktRouteHTTPS 経由の JSON非同期ジョブスコープ付き認証情報
01

クイックスタート

API ホストの場合、QuickT は、割り当てられたテナントエンドポイントの前にサポートが有効化された認証情報をチェックします。このデバイス用の準備が整ったビューは、サーバーのみのコールパスも明確にします。

テナント URLhttps://quickt.io
認証X-API-Key: pending_activation_…
クライアントプロファイルQuicktRoute
API バージョンv1
# Available only after support activation
export QUICKT_ROUTE_TOKEN="issued-after-review"

curl -X POST https://quickt.io/v1/resolve \
  -H "X-API-Key: $QUICKT_ROUTE_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"route_source":"https://www.youtube.com/watch?v=VIDEO_ID"}'

QuickTはサーバーサイドの秘密ストレージの周りに Credential safety を組織化します。そのデバイス準備が整ったビューは、クライアントバンドルの埋め込みを比較しません。公開ログやリポジトリは最終チェックに残りません。

02

リンクを解決する

Resolve操作のため、QuickTは、提出されたURLの1つからフォーマットする前にソース検出をチェックします。このデバイス用の準備が整ったビューは、発明された出力も明らかにしません。

ポスト/v1/resolve範囲:解決
フィールドタイプ必須説明
route_sourceHTTPS URLはい分析する公開または認可されたメディアページ。
tenant文字列いいえ割り当てられたテナント ドメイン 通常は省略されます。
{
  "success": true,
  "platform": "youtube",
  "title": "Example video",
  "formats": [
    {"id":"18","type":"video","quality":"360p","container":"mp4"}
  ],
  "cached": false
}

QuickT は、変更なしで返された値の周りに Format 識別子を組織化します。そのデバイス準備が整ったビューは、リンクごとの利用可能性を比較します。推測された品質ラベルは最終チェックに残りません。

03

ダウンロードジョブを作成して追跡する

Job 作成を説明するために、QuickT は非同期準備を短い HTTP リクエストから分離します。デバイス準備ビューは、bounded worker 実行に独自の場所を与えます。

ポスト/v1/jobs範囲:仕事
フィールドタイプ必須説明
route_sourceHTTPS URLはい解決するために提出された同じ正規化されたソース。
route_format文字列はい解決応答からの正確な ID。
tenant文字列いいえ割り当てられたテナント ドメイン 通常は省略されます。
curl -X POST https://quickt.io/v1/jobs \
  -H "X-API-Key: $QUICKT_ROUTE_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"route_source":"https://www.youtube.com/watch?v=VIDEO_ID","route_format":"18"}'
1202 受理保存 route_job.
2投票状況GET /v1/jobs/{route_job} 同じ鍵で
3準備完了署名されたダウンロードURLを開きます。
ステータス意味クライアントアクション
queued制限付きキューに受け入れられました。バックオフで再度ポールします。
extractingソースメタデータまたはルートを更新しています。投票を続けてください。
processingダウンロード、リマスタリングまたはマージ。サーバー処理の進行状況を表示します。
ready署名付きダウンロードが利用可能です。URL をユーザーに送信します。
failedターミナル構造化エラー。読み込み error_code. 勧められた場合のみ再試行してください。
expired一時的な出力は削除された。新しいジョブを作成します。
curl https://quickt.io/v1/jobs/ROUTE_JOB \
  -H "X-API-Key: $QUICKT_ROUTE_TOKEN"

1 秒の初期待ち時間は、QuickT 上の Job ポリングの開始点です。その後、デバイス用の準備が整ったビューで、キャップドバックオフが提示され、一時的な署名されたデリバリーが説明されます。

04

予測可能な誤り

Error 契約の場合、QuickT は 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キュー/容量または上流が一時的に利用できません。指数関数的なバックオフとジッターで再試行します。
05

運用契約

QuickT は、クリエイターネットワークと API が応答性を保つように、承認中にモバイル クライアントの制限を選択します。

Schema アクセスの場合、QuickT は割り当てられた認証の前に探索の前にアクティベーションをチェックします。このデバイス用の準備が整ったビューは、文書化されたリクエストの形状も明確にします。

オペレータ監視アクセス

サポートを通じてアクティベート

モバイル体験、そのトラフィック期待値、必要なクリエイターネットワークを記述します。 QuickT は、その情報を使用して、秘密を一度明らかにする前に分析とキューの権限を割り当てます。

アクティベーションを要求する キーはテナントスコープであり、撤回可能であり、コンタクトフォームを通じて発行されます。 匿名スクリプトはダウンロードアーの作業を実行できません。