猫でもわかるWebプログラミング

試行錯誤しながらエンジニア(プログラマー)として働く猫のブログ。技術的な話や、働き方の話、読書録とか、試行錯誤している日常の話。

API

REST API の URL(PATH)をどう作っていくか - Search の例

REST API (RESTful API)は API の PATH をリソースの PATH に見立てて、 API のエンドポイントを決めていく、というのは皆さんご存知のことです。 単純なリソースの PATH 例えば、 id=1 の動画は GET /videos/1 id=3 の画像は GET /images/3 のようになり…

OpenAPI Specification で Response の object の Key を固定値ではなくて可変にしたい場合(ハッシュを返したい場合)

はじめに Dictionary, ハッシュマップ, 連想配列 additionalProperty とは additionalProperty を利用してDictionaryを書く まとめ はじめに OpenAPのドキュメントの以下のページの訳的なブログです。 Dictionaries, Hashmaps, Associative Arrays | Swagger…

APIにける/users/{userId}と/meについて どっちを採用するか

API

はじめに APIでよく /users/{userId} とかありますよね。例えば GET /v1/users/{userId}/images で userId のユーザーが投稿した画像一覧が取れる、とかです。 ここで例えば、「ログインユーザーの画像一覧がとりたい」という場合がありますね。例えばマイペ…