EasyF でビルドダウンロード

# Available only after support activation
export EASYF_SERVICE_KEY="issued-after-review"

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

認証情報の安全性は、EasyF 上のサーバーサイドの秘密ストレージから始まります。次のビューは、クライアントバンドルの埋め込みなしをカバーします。ページは、公開ログやリポジトリを見えないように保持します。

{
  "success": true,
  "platform": "youtube",
  "title": "Example video",
  "formats": [
    {"id":"18","type":"video","quality":"360p","container":"mp4"}
  ],
  "cached": false
}

フォーマット識別子は EasyF に変更なしで返された値で開始します。次のビューはリンクごとの利用可能性をカバーします。ページは推測された品質ラベルを表示しません。

curl -X POST https://easyf.app/v1/jobs \
  -H "X-API-Key: $EASYF_SERVICE_KEY" \
  -H "Content-Type: application/json" \
  -d '{"asset_url":"https://www.youtube.com/watch?v=VIDEO_ID","variant_code":"18"}'

curl https://easyf.app/v1/jobs/DELIVERY_ID \
  -H "X-API-Key: $EASYF_SERVICE_KEY"

EasyF は、1 秒の初期待ち、その後のキャップドバックオフを通じてジョブポリングにアプローチします。

{
  "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": "…"
}

• idempotent アプリケーションロジックを使用し、同じユーザークリックに対して重複ジョブを開始しないでください。
• キャッシュはメタデータを簡単に解決しますが、署名されたダウンロード URL は常に有効期限切れとみなします。
• ジッター付き有界指数バックオフを使用する 429, 503 再試行可能なエラーを 見つけることができます
• パブリックメディアまたはアクセス権限があるメディアのみを処理します。DRMやアクセス制御はバイパスされません。
• リクエスト ID とジョブ ID をプライベートの操作ログに保持します。送信された URL を不必要にログに記録しないでください。

Schema アクセスを説明するために、EasyF は探索前のアクティベーションを割り当てられた認証から分離します。 プレーン言語のワークフローは、文書化されたリクエスト形状に独自の場所を与えます。