フロントエンド開発者は、バックエンド開発者向けにJSON形式を指定する必要がありますか？

私はプロジェクトでフロントエンドの役割を担っています。PHPがJavaScriptに返すJSONの正確な形式をバックエンドチームメイトに指定する必要がありますか？

たとえば、ここで説明する形式と同様の形式を使用する必要があることを伝えます。

フロントエンドで使用するためのJSONを適切に構成する方法

または、自分の役割を可能な限り無菌状態に保ち、単にバックエンドインターフェイスから必要な入力と出力を言葉で説明する必要がありますか？（もちろん、これが発生した場合、異なるデータ構造形式を処理することは私の側でより困難になる可能性があります）

これは、さまざまな形式の要件と長所と短所について話し合うために一緒に行うべき会話です。

どちらか一方が何が起こるかを指示している場合、あなたは悪いソフトウェアと不幸なチームになってしまうでしょう。

JSONの形式と構造がどのように見えるかについて、最も明確に貢献する必要があります。APIの消費者であるフロントエンドエンジニアが、データ構造のあり方を知っている人であることがよくあります。

あなたは、データを使用し、フォーマットし、ループし、それで作業する人です。配信方法について意見を持っている必要があります。

ミドルウェア開発の素晴らしい世界へようこそ。プロトコルを開発するのは大変な労力と議論になる可能性があり、誰も結果を見るべきではありません。

あなたが小さなチームにいる場合は、独裁者を避けてください：プロトコルを打ち出すために皆とのクイックミーティングを持っています。

中規模のチームは、プロトコルを実行する代表者を希望する場合があります。

大規模なチームおよび/または複雑な組織を持つチームには、プロトコルを制御する専用のミドルウェア担当者が必要です。

すべての場合に文書化！前提条件とは何か、事後条件とは何か、必須フィールドとは何か、オプションフィールドとは何か、副作用とは何か、返されるエラーとは… 新しい条件、エラータイプ、副作用が見つかったときにドキュメントを維持する、その後、ドキュメントに追加されます。

また、ドキュメントへの準拠を確認するために、クライアント側とサーバー側の両方の単体テストとシステムテストをお勧めします。

大変な作業のように思えるかもしれませんが、ここでの軽微なミスは非常に高価で時間がかかる可能性があります。

私はただ「なぜ」と尋ねるでしょうか？プロジェクトについて話しているときは、プロジェクトに取り組んでいるチームについても話します。使用される機能と構造についての意見を聞くことを期待し、歓迎すべきです。開発者として、私は個人的にチームメイトの貢献を信じ、大切にします。

「早く行きたいなら一人で行きたい。一緒に遠く行きたいなら」という言葉があることはご存知でしょう。