Insto でビルドダウンロード

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

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

Instoは、Credentialの安全性に関する3つの実践的なポイントを紹介します。まずはサーバーサイドの秘密保持が来ます。ダウンロードレビューは、次にクライアントバンドルの埋め込みなしをカバーします。その最後のポイントは、公開ログやリポジトリがありません。

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

Instoは、フォーマット識別子に対する3つの実用的なポイントを提示します。最初に変更なしで返される値が来ます。ダウンロードレビューは、次にリンクごとの利用可能性をカバーします。その最後のポイントは、推測された品質ラベルがありません。

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

curl https://insto.app/v1/jobs/PREPARE_ID \
  -H "X-API-Key: $INSTO_MEDIA_TOKEN"

Insto では、ジョブポリングを説明するときに 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 を不必要にログに記録しないでください。

スキーマアクセスのために、Instoは探索前のアクティベーションから始まります。そのダウンロードレビューは、それを割り当てられた認証とペアリングし、文書化されたリクエスト形状で終了します。