0

私はREST APIを実装しており、たとえばset_ftp_credentialsリクエストがあります

POST api.domain.com/object/set_ftp_credentials

この要求は、接続を試みることによって、ftp 資格情報が適切であることを確認します。 ここで、HTTP レスポンス 200 を返す必要があるかどうか、コンテンツでリクエストが失敗したこととその理由
を返すかどうかについて話し合いました。 または、他の HTTP 応答コード (40* 応答コード) を返す必要があります。

これを行う正しい方法と考えられるものは何ですか?

200 でない場合、正しい応答コードは何だと思いますか?

4

2 に答える 2

3

200 は OK 応答であり、要求が正常に満たされた場合にのみ送信されるべきだと思います。

于 2012-12-25T14:08:14.513 に答える
2

1つのアプローチは、次の質問に自分で答えることです。

  1. どのHTTPメソッドをサポートしていますか？
  2. 各HTTPメソッドの予想される動作は何ですか？
  3. サポートされているHTTPメソッドごとに、問題が発生した場合に発生する可能性のある障害のクラスは何ですか？

ここで、200HTTP応答コードを使用して予想される応答ペイロードを返します。障害に対してクライアント側エラー（400クラス）またはサーバー側エラー（500クラス）を返します。

次のことを検討することをお勧めします。

  • アプリケーションに固有のエラーコードを返し、それらをHTTPエラーコードにマップします
  • 正常な応答とエラー応答のために、個別のデータコントラクト（JSON形式またはXMLスキーマを想定）を定義します
于 2012-12-26T02:05:28.897 に答える