非推奨 API コンテンツの目的は、Cloudflare がそのエンドポイントをサポートしなくなったことを伝え、代替手段を示すことです。
説明的で、率直
reference
Deprecated endpoint name: 非推奨になる前の Endpoint と一致させてください。
Context: 何が起きているか、Cloudflare がこのエンドポイントを非推奨にする理由、その他の重要な情報を簡潔に説明します。今日、明日、1 週間後などの期限に依存する表現は避けます。日付を書くときは具体的にします。
Replacement: 代替エンドポイントの説明やリンク、またはそのエンドポイントの機能を削除する理由の説明です。
End of life date: ユーザーがそのエンドポイントを使えなくなる日付です。月名を省略せず、日付と年を書きます(May 10, 2021)。
非推奨になるエンドポイントまたは関連 API の完全な一覧
API の非推奨告知は、エンドポイント名のアルファベット順ではなく、非推奨日順で API deprecations ページに追加します。
指定期間後に非推奨になるが、まだ利用できるエンドポイントには、エンドポイントの説明に今後の非推奨についての注記を追加します("<name of endpoint> will be deprecated on <full month name, date, year>. Use the <alternative endpoint> instead.")。
Cloudflare Images - Create authenticated direct upload URL v1
End of life date: July 1, 2022
このエンドポイントは非推奨です。メタデータを制御し、アクセスポリシーを定義し、画像 ID を取得できる v2 の利用を推奨します。
Deprecated API:
POST accounts/:account_identifier/images/v1/direct_upload
Replacement:
POST accounts/:account_identifier/images/v2/direct_upload