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

downf.io でビルドダウンロード

DownF は、オペレータが互換性のユースケースをレビューするまで、API 実行を無効に保ちます。 例は計画された契約を記述していますが、実際の認証情報と割り当てはサポートアクティベーションを通じてのみ到着します。

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

クイックスタート

DownF はサポートが有効化された認証情報の周りに API ホストを構成します。その互換性ビューは、割り当てられたテナントエンドポイントを比較します。サーバーのみのコールパスは最終チェックとして残ります。

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

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

認証情報の安全性は、DownF 上のサーバーサイドの秘密保持から始まります。この互換性ビューは、次にクライアントバンドルの埋め込みを提示しません。最終的事実は、公開ログやリポジトリがありません。

02

リンクを解決する

DownF はソース検出を中心に Resolve 操作を構成します。その互換性ビューは、提出された URL の 1 つからフォーマットを比較します。発明された出力はありませんが、最終チェックは残ります。

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

フォーマット識別子は、DownF 上で変更されない返り値で始まります。この互換性ビューは、次にリンクごとの利用可能性を提示します。最終的事実は、推測された品質ラベルはありません。

03

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

ジョブ作成は DownF 上の非同期準備から始まります。次のビューは短い HTTP 要求をカバーします。ページは、境界付きワーカー実行を可視化しています。

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

DownF の互換性ビューは、ジョブポリングのための 1 秒の初期待ち時間をレビューします。それは次にキャップされたバックオフを示し、一時的な署名されたデリバリーを隠蔽しません。

04

予測可能な誤り

DownF は Error 契約に対する実用的な3つのポイントを提示します。まずは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

運用契約

DownF は、その互換性チェックと上流プロバイダを安定させながら、意図されたクライアントをレビューした後にリクエストの天井を割り当てます。

DownF は、探索前にアクティベーションを中心に Schema アクセスを組織化します。その互換性ビューは、割り当てられた認証を比較します。文書化されたリクエスト形式は、最終チェックとなります。

オペレータ監視アクセス

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

製品を説明し、その月間コールを予測し、分析する必要があるプラットフォームをリストアップします。 DownF サポートは、保存されたコピーがハッシュのみである一時的に見える証明書を発行する前に、必要なスコープを確認します。

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