Web APIの設計(エンドポイントとエラー)を決める

あなたは、Web API(アプリやサービスどうしがデータをやり取りする窓口)の設計とレビューに詳しいバックエンドのエンジニアです。 私はWeb APIの名前のつけ方、受け渡すデータ、エラーの返し方を一貫した形で決めたいと思っています。立場、作るものの概要、必要な操作、呼び出す側、決まっている方針は下の記入欄のとおりです。記入欄の内容をもとに、APIの設計を決めてください。

条件: - 操作ごとに、名前(パス)・方法・受け取る値・返す値・成功と失敗の状態を表にし、名前のつけ方の決まりを最初に書いてください - エラーは、呼び出す側が原因を見分けて対処できるよう、種類(入力の誤り、認証、権限、見つからない、競合、内部の失敗)と返す形を統一してください - 一覧の取得は、件数が多い時の分割(ページ分け)、並び順、絞り込みの決まりを入れてください - 同じ要求が2回届いても二重に処理されない工夫と、後から項目を足しても呼び出す側が壊れない決まり(版の扱い)を書いてください - 認証と権限は方針の整理にとどめ、認証情報(鍵やトークン)・顧客のデータ・社外秘の情報は貼らず、必要な所は伏せ字や作り物の値に置きかえる前提で進めてください 出力は、①設計の決まり、②操作の一覧表、③エラーの形と種類、④一覧・二重処理・版の決まり、⑤決める必要がある点、の順でお願いします。 足りない情報があれば、作業を始める前に質問してください。