curlでAPIを叩きたい

Question

やりたいこと

初歩的な質問ですが、自分で某アプリケーションのAPIをドキュメントを見ながら叩く遊びをしています。
例えば、次の条件でcurlし、レスポンスが返ってくることは確認できます

・POST /valifications
・REQUEST BODY SCHEMA: application/json

https://api.test.hograpp.io/v2/verifications

 curl https://api.test.hogeapp.io/v2/verifications \                                                                                             
-X POST \
-H "Connect-Type: application/json" \
-H "Authorization: Bearer ***********"

わからないこと

一方で、次の条件の様に、{}でオブジェクトを指定された場合、どの様にcurlコマンドを書けば良いのでしょうか？

・PUT /verifications/{id}/plans
・REQUEST BODY SCHEMA: application/json

https://api.test.hogeapp.io/v2/verifications/{id}/plans

idについては、以下の様なフォーマットでしたので、文字列を入れることになりそうです　
id string <uuid> Example: 12345678-90ab-cdef-1234-567890abcdef

やったこと

次の様な指定でcurlしてみましたが404が返ってきました

 curl https://api.test.hogeapp.io/v2/valifications/{12345678-90ab-cdef-1234-567890abcdef}/plans \                                                              
-X PUT  \
-H "Connect-Type: application/json" \
-H "Authorization: Bearer ***********"

 curl https://api.test.hogeapp.io/v2/valifications/12345678-90ab-cdef-1234-567890abcdef/plans \                                                              
-X PUT  \
-H "Connect-Type: application/json" \
-H "Authorization: Bearer ***********"

 curl https://api.test.hogeapp.io/v2/valifications/id={12345678-90ab-cdef-1234-567890abcdef}/plans \                                                              
-X PUT  \
-H "Connect-Type: application/json" \
-H "Authorization: Bearer ***********"

 curl https://api.test.hogeapp.io/v2/valifications/id=12345678-90ab-cdef-1234-567890abcdef/plans \                                                              
-X PUT  \
-H "Connect-Type: application/json" \
-H "Authorization: Bearer ***********"

Comments

[itagagaki]

{id}はオブジェクトなんですか？

[ts21]

JSONの話だと考え、勝手にオブジェクトと捉えていましたが違うのでしょうか？

[itagagaki]

APIの仕様書を読まないとなんとも…ですけど、{id}のところに何かのID（文字列）を入れてねっていう意味かも？と思いました。

[ts21]

ありがとうございます。idについては、以下の様なフォーマットでしたので、文字列を入れることになりそうです　
id
string <uuid>
Example: 12345678-90ab-cdef-1234-567890abcdef

[ex025]

https://api.test.hogeapp.io/v2/verifications/12345678-90ab-cdef-1234-567890abcdef/plans

こういう話ではないのですか?

[ts21]

そちらのcurlも試してみましたが404が返ってきました(やったことを追記させていただきます）

[ex025]

追記を読みました。
「verifications/」はどこに消えたのでしょう。
「https://api.test.hogeapp.io/v2/verifications/{id}/plans」の「{id}」を「12345678-90ab-cdef-1234-567890abcdef」で置き換えればできるはずですが、追記では「verifications/」がなくなっています。

[ex025]

もう一つ書くとすれば、「{id}」は別にオブジェクトではなく、変数のような意味合いで使っているのだと思います。
単純に「https://api.test.hogeapp.io/v2/verifications/12345678-90ab-cdef-1234-567890abcdef/plans」のように書いてしまうと置き換えるべき箇所が分からない場合があるので、{id}という書き方をしています。
APIの仕様とかを読んでいるとよく出てくる書き方です。

[ts21]

ご指摘いただきありがとうございます。
valificationが抜けていました、修正いたします。

[ts21]

APIの仕様についてのコメントありがとうございます。
valificationsをつけた状態でcurlしても404でした、入力しているid= 123..が違うのかなと思いました

[ex025]

こちらには何のAPIかもわからないので、idに何を入れるべきなのかは分かりません。
何かユーザーid的なのを入れるのか、他の何かのidなのか。

[itagagaki]

valificationsではなくverificationsなのでは

[ts21]

verificationsですね、タイポです.
verificationsでも404でした

Answer 1

JSONパラメータが必要でした