リクエストパラメータとレスポンスの違い

Question

現在、自分でAPIを作成しようとしています。
その設計にぐるなびさんのレストラン検索APIを参考にしています。
その中にリクエストパラメータとレスポンスとあり、説明を見ると概要がふんわり伝わるのですが、その明確な違いが腑に落ちていません。

ひとことで言うとどういった違いがありますか？またその上で設計における注意点を教えていただきたいです。

Answer 1

初めまして。

リクエストパラメータは結果を取得するための条件だと思えばいいと思います。

この条件(リクエストパラメータ)に合う結果(レスポンス)を下さい。といった感じで。
SQLで言うwhereみたいな。
人により設計方法は違うと思うので一概には言えませんが、だいたいこのような感じかと思います。

簡単な例を挙げると
~/api/user/?id=hoge
とのGETリクエストをする場合リクエストパラメータは、IDがhogeのデータを取得し、レスポンスとしてこの条件に合うuserデータを返すようなイメージです。

Answer 2

リクエストパラメーターというのは、APIの入力です。
レスポンスというのは、APIの出力です。

APIという物を理解されているという前提だと、これの違いが分からないという理由がわからないです。