REST APIと設計に関するtoshio-shiratoriのブックマーク (2)

  • GoogleのWebAPI設計とWebAPI設計のベストプラクティスを比較してみる

    RESTful な URL にしよう 元記事 GET /tickets - チケットのリストを取得する GET /tickets/12 - 指定したチケットの情報を取得する POST /tickets - 新しいチケットを作成する PUT /tickets/12 - チケット #12 を更新する PATCH /tickets/12 - チケット #12 を部分的に更新する DELETE /tickets/12 - チケット #12 を削除する Google GET /events - 予定のリストを取得する GET /events/12 - 指定した予定の情報を取得する POST /events - 新しい予定を作成する PUT /events/12 - 予定 #12 を更新する PATCH /events/12 - 予定 #12 を部分的に更新する DELETE /events/12 -

    GoogleのWebAPI設計とWebAPI設計のベストプラクティスを比較してみる
    toshio-shiratori
    toshio-shiratori 2017/09/18
    新規apiを作るときに参考にする。
  • REST APIとは? - API設計のポイント

    最近は様々なサービスでWebAPIが提供されています。普段の開発をする中でもシステム連携などでAPIを作る機会が出てくるのではないでしょうか。 WebAPIの中でもREST APIなんてものもよく聞くのかなぁと思います。REST APIの設計は色々と奥が深く、なかなかおもしろい技術です。 今回はそんなREST APIを設計する上でのポイントをご紹介していきます。この記事では実装よりも設計思想的な部分を書いています。次回以降にもう少し実装に近いレベル記事を書いきます! REST APIとはRESTの原則に沿った形で設計されたAPIを指します。 じゃあ、RESTってなんぞや?となると思いますが、参考サイトにはこんなことが書かれています。 「セッションなどの状態管理を行わない(やり取りされる情報はそれ自体で完結して解釈することができる)」(Webシステムでは、HTTP自体にはセッション管理の機構

    REST APIとは? - API設計のポイント
    toshio-shiratori
    toshio-shiratori 2017/03/25
    分かりやすい。
  • 1