HTTPステータス202 - 非同期リクエストの完了に関する情報を提供する方法？

Question

サーバーが非同期要求のステータスコード202 - Acceptedを返すときに、要求完了の見積もりを行う適切な方法は何ですか？ HTTP spec（私によって追加イタリック体）から

：

202受理

要求は処理のために受け入れられているが、処理は完了していません。 [...]

エンティティは、ステータスモニタ又はユーザが要求を満たすことが期待できる場合のいくつかの見積りに対するリクエストの現在のステータスの表示とポインタのいずれかを含むべきである。この応答で返されます。ここで

思考のいくつかされています

• 私はmax-ageディレクティブをちらっと見てきたが、それを使用してCache-Controlを濫用することでしょうか？
• 応答本体の予想待ち時間を返しますか？
• アプリケーション固有のX-レスポンスヘッダーを追加しましたが、X-ヘッダーは、RFC 6648で廃止されましたか？
• （X-以外の）特定の応答ヘッダーを追加しますか？もしそうなら、どのようにそれを命名すべきですか？ SOの質問Custom HTTP headers : naming conventionsはいくつかのアイデアを提供しましたが、非推奨の後では、HTTPヘッダがどのようにフォーマットされ、どのようにそれらの名前を付けられるべきかについてのみ回答します。
• その他のおすすめ？

Answer 1

具体的には202 - Acceptedの応答コードについて明示的に言及していませんが、Retry-Afterヘッダーが適切なオプションのようです。 documentationから：

Retry-Afterレスポンスヘッダーフィールドは使用できます[...]をクリックして、要求しているクライアントがサービスを利用できなくなると予想される期間を示します。

Answer 2

これには既存のHTTPヘッダーを悪用しないでください。それはあなた自身のサーバーなので、レスポンスの外観を定義することになります。あなたは、この情報の意図された受取人に対してどのような応答が最も効果的であるかを選ぶことができます（そして、すべきです）。

例えば、人間が判読可能なメッセージを表示することだけに興味がある場合は、text/plain「次の30分以内にリクエストが処理される可能性があります」と返すことができます。スペクトルの他の終わりに

、あなたはおそらく、この（私は完全にその場でこれを作った）のようにフォーマットされ、すべてのRESTの道を行くとapplication/jsonを返すようにしたいかもしれません：

あなたが使用することができます

{ 
    "status": "pending", 
    "completion": { 
    "estimate": "Thu Sep 08 2011 12:00:00 GMT-0400", 
    "rejected-after": "Fri Sep 09 2011 12:00:00 GMT-0400", 
    }, 
    "tracking": { 
    "url": "http://server/status?id=myUniqueId" 
    } 
} 

Answer 3

Locationヘッダーを使用して、ステータスモニタのURLを指定します。現在のステータスや見積もりなどのカスタムヘッダー（自分のソフトウェアは誰も使用しません）やレスポンスボディ（Webブラウザがユーザーに少なくとも表示するもの）に入れることができます。