質問をすることでしか得られない、回答やアドバイスがある。

15分調べてもわからないことは、質問しよう!

ただいまの
回答率

90.32%

  • API

    1606questions

    APIはApplication Programming Interfaceの略です。APIはプログラムにリクエストされるサービスがどのように動作するかを、デベロッパーが定めたものです。

  • REST

    148questions

    REST(Representational State Transfer)はwebアプリケーションの構築スタイルの一種です。HTTP GET/POSTによってリクエストを送信し、レスポンスはXMLで返されます。SOAPのようなRPCの構築と比べるとサーバからクライアントを分離することが出来る為、人気です。

RestfulなAPIのリソースについて

解決済

回答 1

投稿

  • 評価
  • クリップ 0
  • VIEW 370

gottenderloin

score 10

RestfulなAPIの作成について学習しています。
学習する上で、リソースの部分で理解できない部分があり、どうしてもつまづいてしまいます。

GET /tickets - チケットのリストを取得する
GET /tickets/12 - 指定したチケットの情報を取得する
POST /tickets - 新しいチケットを作成する
PUT /tickets/12 - チケット #12 を更新する
PATCH /tickets/12 - チケット #12 を部分的に更新する
DELETE /tickets/12 - チケット #12 を削除する

(参考URL:http://qiita.com/mserizawa/items/b833e407d89abd21ee72

上記引用を私なりに解釈したディレクトリ構成は以下の通りです。
イメージ説明

上から3つめのPOST操作をすると、API内で連番を振り、「/tickets/12」というリソースが作成されるのだと思いますが、画像のように、「/tickets/12」というフォルダが実際に作成されるのでしょうか?

DBにチケットの情報を格納している場合、DB操作用のAPIファイルが1つあれば、あとはSELECTする際の条件に12番を指定すればいいだけだと思うので、「/tickets/12」というフォルダが実際に作成されているのだとしたら、作成する意図がわかりません。

それとも実際にはフォルダは作成されず、「/tickets/」以降は識別子としてついており、実際の操作は全て「/tickets/」直下のAPIファイルで行われているのでしょうか?
ネットで調べても欲しい答えが載っておらず、質問させて頂きました。

説明が下手で申し訳有りません。
ご教授頂けますと幸いです。

  • 気になる質問をクリップする

    クリップした質問は、後からいつでもマイページで確認できます。

    またクリップした質問に回答があった際、通知やメールを受け取ることができます。

    クリップを取り消します

  • 良い質問の評価を上げる

    以下のような質問は評価を上げましょう

    • 質問内容が明確
    • 自分も答えを知りたい
    • 質問者以外のユーザにも役立つ

    評価が高い質問は、TOPページの「注目」タブのフィードに表示されやすくなります。

    質問の評価を上げたことを取り消します

  • 評価を下げられる数の上限に達しました

    評価を下げることができません

    • 1日5回まで評価を下げられます
    • 1日に1ユーザに対して2回まで評価を下げられます

    質問の評価を下げる

    teratailでは下記のような質問を「具体的に困っていることがない質問」、「サイトポリシーに違反する質問」と定義し、推奨していません。

    • プログラミングに関係のない質問
    • やってほしいことだけを記載した丸投げの質問
    • 問題・課題が含まれていない質問
    • 意図的に内容が抹消された質問
    • 広告と受け取られるような投稿

    評価が下がると、TOPページの「アクティブ」「注目」タブのフィードに表示されにくくなります。

    質問の評価を下げたことを取り消します

    この機能は開放されていません

    評価を下げる条件を満たしてません

    評価を下げる理由を選択してください

    詳細な説明はこちら

    上記に当てはまらず、質問内容が明確になっていない質問には「情報の追加・修正依頼」機能からコメントをしてください。

    質問の評価を下げる機能の利用条件

    この機能を利用するためには、以下の事項を行う必要があります。

回答 1

checkベストアンサー

0

答えとしては

それとも実際にはフォルダは作成されず、「/tickets/」以降は識別子としてついており、実際の操作は全て「/tickets/」直下のAPIファイルで行われているのでしょうか? 

こちらが正解に近いかなと思います。

/tickets/12であれば「12」は引数として処理を行うといいと思います。

どの言語、どのフレームワークで作成するかによって、記述の仕方に違いはあるかと思いますが、
例えば、JavaのPlayというフレームワークではルーティングは以下のように設定します。

GET    /tickets      controllers.Application.listAll
GET    /tickets/:id  controllers.Application.list(id: Long)
POST   /tickets      controllers.Application.create
PUT    /tickets/:id  controllers.Application.update(id: Long) 
 :


細かいところの説明は省略しますが、
一行目: /tickets のURLアクセスでは、ApplicationクラスのlistAllメソッド(関数)を引数なしで呼び出す
二行目: /tickets/12 のURLアクセスでは、Applicationクラスのlistメソッド(関数)をid=12の引数呼び出す

といった感じです。

投稿

編集

  • 回答の評価を上げる

    以下のような回答は評価を上げましょう

    • 正しい回答
    • わかりやすい回答
    • ためになる回答

    評価が高い回答ほどページの上位に表示されます。

  • 回答の評価を下げる

    下記のような回答は推奨されていません。

    • 間違っている回答
    • 質問の回答になっていない投稿
    • スパムや攻撃的な表現を用いた投稿

    評価を下げる際はその理由を明確に伝え、適切な回答に修正してもらいましょう。

  • 2017/02/06 10:31

    PHP言語でのAPI作成を学んでおりました。
    お恥ずかしながらルーティングというものをはじめて知りましたので、これから学習したいと思います。
    具体的な例もくださり、非常に助かりました!
    ありがとうございます!

    キャンセル

同じタグがついた質問を見る

  • API

    1606questions

    APIはApplication Programming Interfaceの略です。APIはプログラムにリクエストされるサービスがどのように動作するかを、デベロッパーが定めたものです。

  • REST

    148questions

    REST(Representational State Transfer)はwebアプリケーションの構築スタイルの一種です。HTTP GET/POSTによってリクエストを送信し、レスポンスはXMLで返されます。SOAPのようなRPCの構築と比べるとサーバからクライアントを分離することが出来る為、人気です。