1

RESTfulAPIを設計/作成する方法を学び始めたばかりです。一般的な質問があります:

ある種の単純なSQLデータベースがあり、新しいレコードの作成、レコードの表示、レコードの削除、またはレコードの更新を可能にするAPIを作成していると仮定します。

レコードを削除したい場合、通常は、たとえば、URLでレコードのIDを渡す方が/api/delete_record?id=10よいですか、それとも次のようなことを行う方がよいでしょうか。

/api/record、、、を受け入れGET、データはリクエストのJSON本文を介して処理されます。POSTPATCHDELETE

PythonでFlaskを使用して小さなAPIを作成しましたが、URLは1つだけです。/recordこれは、上記のすべてのHTTPメソッドを受け入れます。リクエスト内のメソッドを調べ、それに応じてJSONのリクエスト本文を期待します。それは良い習慣と見なされますか、それとも悪い習慣と見なされますか?

任意の提案をいただければ幸いです。私はまだこれらすべてに非常に慣れていないことに注意してください。私は以前にAPIを使用したことがありますが、APIを開発したことはありません。ありがとう!

4

1 に答える 1

3

リソースを削除する適切なRESTfulな方法は、DELETEリクエストを送信し、スコープ情報を(本文ではなく)URIに/api/records?id=10またはのように配置すること/api/records/10です。メソッド情報は、URIではなくHTTPメソッドに含める必要があります。

API設計のベストプラクティスを学ぶために、「RESTfulWebサービス」を読むことをお勧めします。

于 2012-11-13T17:27:46.017 に答える