データベース内のユーザー レコードにユーザー名を追加する基本的なサービスを実装しています。サービスは最初にユーザー名が存在するかどうかを確認し、存在する場合は何らかの値を返し、ユーザー名が既に使用されていることをクライアントに伝えます。ユーザー名が使用可能な場合、ユーザー レコードが更新され、「OK」が返されます。このアプリケーションでは、クライアントはネイティブの IOS モバイル アプリであり、サーバーは node.js です。しかし、それはこの質問には関係ありません。
このサービスでは、戻り値として何を使用することをお勧めしますか? たとえば、成功した場合、ステータス コード 200 を返す必要がありますか? ブール値？カスタム文字列? 同様に、失敗した状態の場合、推奨される通常の戻り値は何でしょうか?
成功した状態の場合は201を返し、失敗した状態の場合は400または409を返します。
お役に立てば幸いです。
ブランドン
ステータス 201 は、何らかのリソースが作成されたときに使用されることを意図しています。そのため、ユーザーを作成するときにステータス コード 201 を設定し、同じリクエストが更新を行うときに 200 に設定する必要があります。さらに、作成/更新されたユーザーの ID id を返すことができます。私見では、作成と更新を別々のサービスとして維持する必要があります。
エラーが発生した場合は、適切な 4xx エラー (リンクを参照) を使用できます。応答が XML または JSON の場合は、常に応答にステータス メッセージ属性を保持してください。これに適切なメッセージを設定できます。モバイル アプリは、指定した HTTP ステータス コードに基づいてこのメッセージを確認できます。