ほぼすべての種類の API に、123
エラーの種類を示す (例: ) のような整数エラー コードがあります。user_not_found
またはのような説明的な文字列コードを使用する方がよいのではないかと考えていましたinvalid_request
。私の意見では、それらの方がはるかに実用的です。たとえば、数か月後にコードに戻り、ドキュメントでエラー コードを検索せずにエラー処理部分を簡単に確認できるとしましょう。
API に整数エラー コードがまだ存在するのはなぜですか?
ほぼすべての種類の API に、123
エラーの種類を示す (例: ) のような整数エラー コードがあります。user_not_found
またはのような説明的な文字列コードを使用する方がよいのではないかと考えていましたinvalid_request
。私の意見では、それらの方がはるかに実用的です。たとえば、数か月後にコードに戻り、ドキュメントでエラー コードを検索せずにエラー処理部分を簡単に確認できるとしましょう。
API に整数エラー コードがまだ存在するのはなぜですか?
API では、クライアントは通常、条件を使用して応答コードをテストするコンピューターです。
文字列に対してテストするよりも、整数に対してテストする方がはるかに高速です。それだけです。
2xx
さらに、エラー コードには特定のロジックがあります。API は通常 HTTP コードを使用するため、(人間として) それらを読むと、成功を4xx
示し、クライアント側のエラーを5xx
示し、サーバー側のエラーを示していることがわかります。それらすべてを心から知っています。
編集:
あなたの質問により、ウェブサイトの読み込み時間が利益にどのように影響するかについて、この回答について考えさせられました。数ミリ秒でも問題になる場合があることを理解するために、これを読む必要があります。
しかし、ほとんどのエラーには適切な名前があります。標準 C、POSIX、および Windows の両方に、エラー コードの名前があります。もちろん、これらの名前のほとんどはプリプロセッサ マクロとして作成されますが、これらのメッセージから適切な文字列またはメッセージを取得する関数もあります。