Student addRESTAPI呼び出しがあります。これにより、候補データとファイルの添付が可能になります。たとえば、候補が正常に追加されましたが、何らかの理由でドキュメントがアップロードされませんでした。応答ステータスコードはどうあるべきか。
両方が成功した場合、新しく作成された候補JSONオブジェクトで200を返します。
1 に答える
0
REST API 呼び出しは、成功するか失敗する必要があります。中途半端なし。
添付ファイルをアップロードするアカウントの作成が必須でない場合は、別の呼び出しで行う必要があります。添付ファイルが必須の場合 (またはアップロードが必須である場合)、リクエストは失敗し、ユーザーは作成されず、問題を示す 4xx ステータス コードが返されます。
必須ではないと仮定すると、これを 2 つの異なる REST 呼び出しに分けます。1 回の呼び出しにあまりにも多くの機能をオーバーロードしようとすると、API が乱雑になります。1 つの呼び出しを作成してユーザーを作成し、2 つ目の呼び出しを作成してファイルをユーザーに関連付けることをお勧めします。次に、201 (新しいユーザー用に作成) と 200 (ドキュメントの関連付けが成功した場合) の応答コードを使用します。
もう 1 つのオプション:障害を適切に無視し、ユーザーを作成し、201 を返し、失われた添付ファイルを使用します :)
于 2012-12-13T22:01:02.417 に答える