楽天の在庫APIなどのAPIコードの書き方、こつ

質問

APIのコードを書くとき最初にたくさんいろんなコードをそれぞれAPIによって書いてると思うのですが、
ebayだったらこんな感じ↓
// Turn on all errors, warnings and notices for easier PHP debugging
error_reporting(E_ALL);

// Define global variables
$s_endpoint = "http://open.api.ebay.com/shopping?"; // Shopping URL
$m_endpoint = 'http://svcs.ebay.com/MerchandisingService?'; // Merchandising URL
$appid = 'hogehoge'; //AppID
$responseEncoding = 'XML'; // Type of response we want back
function getMostWatchedItemsResults ($selectedItemID = '', $cellColor = '') {
global $m_endpoint;
global $appid;
global $responseEncoding;

$apicalla = "$m_endpoint";
$apicalla .= "OPERATION-NAME=getMostWatchedItems";
$apicalla .= "&SERVICE-VERSION=1.5.0";
$apicalla .= "&CONSUMER-ID=$appid";
$apicalla .= "&RESPONSE-DATA-FORMAT=$responseEncoding";
$apicalla .= "&maxResults=3";
$apicalla .= "&categoryId=xxx";

// Load the call and capture the document returned by eBay API
$resp = simplexml_load_file($apicalla);

このコードはググってたらebayの練習用のコードが出てきたので、それの最初の方にあったやつを抜粋しました。
アプリIDをいれるような基本形というか、上記のようなコードはどうやって探してくるのでしょうか？
質問内容を簡潔にまとめると、APIを使うときに、こつみたいなのっていうのはあるのですか？
調べていると、「なれてきたらAPI簡単だった」みたいなコメントもあったりするので、こつとかあるのかなっと思いました！
そういうのがあれば教えていただけたらうれしいです。
よろしくおねがいします！

回答No.1

hymat · ベストアンサー

ググればたいていのコード例は出てくると思いますけど、基本は説明をよく読むことです。
楽天なら、 http://webservice.rakuten.co.jp/api/ichibaitemsearch/ に説明と例がありますね。

コツが必要になるようなクセやワナのあるAPIもあり、トンチンカンなエラーメッセージを出すAPIで苦労したことがありますけど、勘違いしててうまく行かないだけだった、ナゾが解けたら簡単だった、みたいな話かと思います。ここがミソだとかポイントだとか力説するのは、人それぞれのつまづいた経験によるものだったりします。

あるいは、いろんなのを試してるうちに、こういうパラメータが必要なはず、この機能の場合はここが変わるはず、みたいな見当がつくようになるってことじゃないでしょうか。たいていは１つできたら他のも似たようなものですから、そのパターンが読めて応用が効くようになれば、それがコツなんでしょう。

お礼

APIリファレンスを見ながらトライアンドエラーを繰り返して成長していくのが、APIの近道ということですね！
回答ありがとうございました！

回答No.2

agunuz

公開されているAPIは「どうやってアクセスするのか」「どういう形で結果を返すのか」が文書化されています。公開されているというのは『それ』を指しているのが普通です。インタフェイスがわからないのにAPIとは呼べませんよね（APIの語義のとおり）。

なので（公開されている）ドキュメントを読んでそれに従って書くだけです。コツも何もありません。公式のドキュメントが読めないというのはAPIを利用する立場にないと言っているようなものです。他人が書いたソースを流用すればその時点で動くものは作れるでしょうけど、APIが変更になったら（旧APIが廃止になったら）誰かが書いてくれるのを待つしかありません。

お礼

説明をいろいろと読んでいたらコツではないですけど、どうやってアプローチしたらいいかわかってきました！
回答ありがとうございました！