中古車検索APIでリクエストURL作成

中古車検索APIでリクエストURL作成
カーセンサーAPIてほ、
パラメータのkeyは必須になります
ベースURLへ
パラメータをつなげて、リクエストURLを作成てきます
今回は、
都道府県
車種
を指定して、
年式の新しい順で表示します
都道府県は、pref
車種は、model
年式を新しい順にするには、order=5
として組み上げます
http://webservice.recruit.co.jp/carsensor/usedcar/v1/?key=APIキー&model=車種名&pref=都道府県コード&order=5

中古車検索API

中古車検索API
これは、カーセンサーnetのデータから
車種、色、販売地域など、
条件を指定して、表示するというもの
走行距離、年数などの情報も取得可能なため
アフィリエイトと組み合わせて
中古車検索ページや
中古車サイトも作成できる
カーセンサー中古車検索APIを使うには
リクルートWebサービスに登録し
APIキーを取得する必要があります
APIの
基本仕様は
http://webservice.recruit.co.jp/carsensor/reference.html
ベースURLほ
http://webservice.recruit.co.jp/carsensor/usedcar/v1/
リクエストパラメータの必須パラメータはkey
これほ、APIキー
その他検索用パラメータとして
model
車種
large_area
中古車店所在エリアをコードで指定
pref
中古車店の所在する都道府県をコードて指定
body
ボディの形をコードで指定
color
車の色をカラーコードで指定
keyword
ブランド
車種
モデル
説明


など、キーワードを指定
price_min
最低価格
price_max
最高価格
missiin
ATか、MTか指定
1ならAT
2ならMT
order
検索結果の並び順を指定
0 デフォルト設定で、これほ、ブランド順
1 価格の安い順
2 価格の高い順
3 車種名順
4 年式古い順
5 走行距離少ない順
start
検索結果の何件目から表示するか指定
count
検索結果の最大出力データ数
デフォルトは10
1~100で設定
レスポンスフィールドは、いかの用になります
results_available
検索結果の全件数
results_returned
レスポンス結果に含まれる検索結果の件数
results_start
検索結果の開始位置
usedcar->brand->code
ブランドコード
usedcar->brand->name
ブランド名
usedcar->model
車種名
usedcar->geade
グレード名
usedcar->price
本体価格
usedcar->inspection
車検情報
usedcar->maintenance
整備情報
usedcar->warranty
保証情報
usedcar->recycle
リサイクル規定
usedcar->desc
説明文
usedcar->body->code
ボディタイプコード
usedcar->body->name
ボディタイプ名
usedcar->odd
走行距離
usedcar->year
登録年
usedcar->shop->name
店名
usedcar->shop->pref->code
都道府県コード
usedcar->shop->pref->name
都道府県名
usedcar->shop->lat
緯度
usedcar->shop->lng
経度
usedcar->shop->datum
測地系
usedcar->color
ボディカラー
usedcar->maintenance_comment
整備に関するコメント
usedcar->maintenance_free
整備にかかる金額
usedcar->photo->main->l
大きいメイン画像のURL
usedcar->photo->main->s
小さいメイン画像のURL
usedcar->photo->main->caption
キャプション
usedcar->photo->sub
その他の画像URL
usedcar->urls->pc
PC向けURL
usedcar->urls->mobile
携帯向けURL
usedcar->urls->qr
QRコード向けURL
usedcar->warranty_comment
保証に関するコメント
usedcar->warranty_distance
保証距離
usedcar->warranty_length
保証期間
usedcar->warranty_fee
保証費用

yahooオークション検索API

yahooオークション検索APIは
通称ヤフオクで出品されている商品を検索して
条件にあったものを表示できるAPI
ちなみに、ヤフオクは
http://auctions.yahoo.co.jp/
ちなみに、これもYahoo関連なので、
アプリIDが必要になります
このYahooデベロッパー登録は
http://developer.yahoo.co.jp/
から取得可能です
今回のAPIの詳細は
http://developer.yahoo.co.jp/webapi/auctions/auction/v2/search.html
になります
APIの基本仕様として
ベースURLが
XMLなら
http://auctions.yahooapis.jp/AuctionWebService/V2/search
となります
リクエストパラメータは
必須なのが
appID
アプリID
そして
query
検索キーワード、ただしUTF-8エンコード必須
その他のパラメータとして
type
検索種類、デフォルトはすべてを対象にするall
any にすれば文字列のうちいずれかを含むになります
category
http://batchsubmit.auctions.yahoo.co.jp/show/batch_categorylist
にあるカテゴリ一覧から
カテゴリIDを数値で指定
コンピュータなら
http://batchsubmit.auctions.yahoo.co.jp/show/batch_categorylist?bigCatID=23336
となるので
23336
sort
並び替え
order と組み合わせて使う
検索結果に
注目のオークションが含まれているなら
注目のオークションが上から優先して表示される
end 終了時間
img 画像の有無
bids 入札数
cbids 現在価格
bidorbuy 即決価格
order
並び順を指定
a 昇順
b 降順
store
商品の区分状態を指定
0 すべての商品
1 オークションストアの出品
2 一般出品者の出品
aucminprice
商品価格の下限値
aucmaxprice
商品価格の上限値
aucmin_bidorbuy_price
即決価格の下限値
aucmax_bidorbuy_price
即決価格の上限値
new
newアイコンのついた商品に絞り込むときに
1 を指定する
freeshipping
送料無料に絞り込むなら
1を指定
buynow
即決価格に絞り込むなら
1を設定
thumbnail
画像のある商品に絞り込むなら
1を設定
attn
注目のオークション商品に絞り込むなら
1を設定
item_status
商品状態で絞り込み
0 指定なし
1 新品
2 中古

Amazon Advertising API の流れ

検索キーワードは
rawurlencode() でURLエンコードする
時刻認証パラメータ Timestamp をAmazon の使用にそって作成
時間の表示はISO8691形式
タイムゾーンはUTCで
2012-12-18T11:09:51Z
というようになるようにする
UTCで現在時刻を出力するには
gmdate() を使う
これも最後にrawurlenccode() で
URLエンコードする
//Timestamp 作成
$Timestamp =gmdate(‘Y-m-d’).’T’.gmdate(‘H:i:s’).’Z’;
$Timestamp=rawurlencode($Timestamp);
そして、Amazon の使用にそった順番でパラメータを記述し変数に格納
署名認証パラメータのSignature をAmazon の仕様にそって作成
署名対象のリクエスト文字列を整えて変数に代入
それをAmazon から発効されたシークレットアクセスキーを使ってRFC2104準拠の
HMAC-SHA256ハッシュアルゴリズム計算して
それをさらにBASE64エンコードし
最後にURLエンコードする
仕様の詳細は
https://images-na.ssl-images-amazon.com/images/G/09/associates/paapi/dg/index.html?rest-signature.html
を参照
あとは、パラメータを組み合わせて
データ取得用URLを作り、XMLパースする
これも変数に格納
取得した検索結果
$xml->Items->Item

foreach() で1つずつ代入しながら処理
使用するレスポンス名が長いためこれを変数にすると
書きやすい
商品名と画像を表示して商品ページのリンクURLをはって
価格などの情報を定義リスト表示する
そして、 if else で検索結果がないなら
メッセージを表示するようにする
という流れ

Amazon AdvertisingAPIでリクエストURL作成

Amazon AdvertisingAPIでリクエストURL作成
ベースURLは
http://ecs.amazonaws.jp/onca/xml
必須パラメータは
Service
AWSAccessKeyId
AssociateTag
Timestamp
Signature
Operation
SearchIndex
Service
AWSAccessKeyId
AssociateTag
については、固定、
または
発行された固有パラメータを指定します
Operationは、商品検索の
ItemLookup
を指定して、
SearchIndexは、すべてにするので
Allを指定
Timestamp
Signature
は、認証のためのパラメータ
それでは、リクエストURLの作成
これも、ベースURLへ、
リクエストパラメータをつなげデータ取得URLを作成
Amazon AdvertisingAPIでは、
Signature以外のパラメータの順番を
バイト順に並び替えたうえで、最後に
Signatureパラメータをつける
これで、リクエストURLは、
http://ecs.amazonaws.jp/onca/xml?AWSAccessKeyId=アクセスキーID&AssociateTag=アソシエイトタグ&ItemPage=1&Keywords=検索キーワード&Operation=ItemSearch&ResponseGroup=Large&SearchIndex=All&Service=AWSECommerceService&Timestamp=時刻認証&Version=20110802&sigunature=署名認証
となります
しかし、なぜか、今回自宅サーバーで
実験したときにはwordpress で表示されませんでした
もっとスキルをあげて再挑戦したいと思います

Amazon AdvertisingAPIの基本仕様

Amazon AdvertisingAPI
Amazonの商品検索API
利用するには
アクセスキーID
シークレットアクセスキー
アフィリエイトタグ
が必要
ベースURLは
http://ecs.amazonaws.jp/onca/xml
リクエストパラメータの必須パラメータも多い 
以下は必須パラメータ
Service
AWSECommerceServiceを指定
AWSAccessKeyId
アクセスキーID
AssociateTag
アソシエイトタグ
Timestamp
認証のための現在時刻
Signature
認証のための署名を指定
Operation
実行するAPIの処理を指定
商品検索なら ItemLookup
SearchIndex
商品カテゴリーの指定
AllもしくはBlendedなら、全カテゴリ
Apparel
ファッション
Appliance
大型家電
Automotive
カー用品
Baby
ベビー&マタニティ
Beauty
コスメ
Books

DVD
DVD
Electronics
家電、カメラ、AV機器
ForeignBooks
洋書
Grocery
食品、飲料
HealthPersonalCare
ヘルス、ビューティー
Hobbies
ホビー
Jewelry
ジュエリー
Kitchen
ホーム、キッチン
Marketplace
マーケットプレイス
MP3Downloads
MP3ダウンロード
Music
音楽
MusicalInstruments
楽器
OfficeProducts
オフィス用品、文房具
Shoes

Software
PCソフト
SportingGoods
スポーツ用品
Toys
おもちゃ
VideoGames
TVゲーム
Watches
時計
以下は必須ではないパラメータ
keywords
検索ワード
ただし、URLエンコードが必要
Title
検索する商品名
Availability
在庫かあるもののみ出すならAvailableを指定
MaxmumPrice
商品の最高価格
MinimumPrice
最低価格
Condition
商品の状態
All
すべて
New
新品
ちなみに!デフォルト設定ほこれ
Used
中古
Collective
コレクター商品
Refyrbished
修理品
MerchantId
出品者ID
Amazon
Amazonのみ
デフォルト設定はこれ
All
すべての出品者
ID
出品者固有のID
ResponseGroup
取得する情報や種類の絞り込み
情報量を指定する
Large
Medium
Small
特定の属性の指定になる
Topsellers
NewRelease
などがある
ItemPage
何ページ目の検索結果を取得するか指定
SearchIndex=All
なら、最大5件となり
5ページ目まで検索できる
 
Version
使用するAPIバージョンを日付で指定
続いてレスポンスフィールド
Items->Result->IsValid
検索結果があればTRUEを返す
Items->Item->DetailPageURL
商品ページのURL
Items->Item->LargeImage->URL
大きな商品画像のURL
Items->Item->ItemAttributes->Title
商品名
Items->Item->ItemAttributes->Label
レーベル
Items->Item->ItemAttributes->ListPrice->FormattedPrice
価格
Items->Item->OfferSummary->LowestNewPrice->FormattedPrice
新品の最安値
Items->Item->OfferSummary->LowestUsedPrice->FormattedPrice
中古最安値
Items->Item->EditorialReviews->EditorialReview->Content
商品の説明
Items->MoreResearchResultsUrl
その他の検索結果のURL

Amazon Advertising API

https://affiliate.amazon.co.jp/gp/advertising/api/detail/main.html
へアクセスしてアカウントを作成します
注意点は、Amazon アソシエイトで登録した
メールアドレスと同じにするということ
サポート関連が面倒になることを回避するためです
ちなみに、すべて登録ページは英語での入力になります
http://www.blog-ouendan.com/amazonasosieito.html
を参考に入力することができました
一番悩んだのが、電話番号
携帯なので、どうしようかということで検索
個人輸入時の電話番号入力について
を参考に、
お持ちのケータイの番号が仮に090-1234-5678だとしたら、
+81-90-1234-5678と書くことになる
ということなので、
この方法でクリアしました
英語の入力は今後もありそうなので
メモしてみました
Address Line 1
(住所1) 番地など (通常、市区町村名の後に表示される住所) を記入 (例:2-15-1, Shibuya)
Address Line 2
(住所2) アパート・マンション・ビル名などを記入
City
市区町村名を記入
State, Province or Region
都道府県名を記入
ZIP or Postal Code
郵便番号を記入
Country
(国名) 日本の場合、ドロップダウンメニューから “Japan” を選択
Phone Number
(電話番号) 国番号から電話番号を記入
(例:81-3-1234-5678)
Company Name
会社名を記入 (法人の場合)
Website URL
Web サイトの URL を記入
Website or Application Description
API を利用予定の Web サイトやアプリケーションの簡単な説明を英語で記入

楽天のショッピングサイトの商品を表示 その2

リクエストパラメータ確認
まず、楽天の商品検索APIを使うため
applicationId
アプリID
keyword
キーワード
を指定する
そして、wordpressてPHPてWebAPIを使うので
format
は今回は、xmlを指定
その他のパラメータとして
hits
取得件数の指定
sort
並び方
最低金額
minPrice
最高金額
maxPrice
商品画像の有無を指定する
imageFlag
除外キーワード指定の
NGkeyword
を使って、リクエストURL作成
ベースURLへ
?
をつけて、パラメータは
&
てつなげて作成する
並び順は、
-reviewAverage
てレビューの低い順にしてみます
ベースURLは長いため
変数
$baseurlへ格納します
もし、いくつかベースURLがあるなら
わかりやすいように
$rakyten_baseurl
とするとわかりやすくなります
これで、リクエストURL作成すると
$baseurl?applicationId=アプリID&keyword=キーワード&NGkeyword=除外キーワード&format=xml&sort=-reviewAverage
ただし、sortの値をurlエンコードする必要があります
レスポンスフィールドのうち、使用するてーたの確認
商品の一覧表示に使うのは以下のデータを使います
count
検索結果の総数
Items->item->itemName
商品名
Items->Item->catchcopy
キャッチコピー
Items->Item->itemPrice
商品価格
Items->Item->itemURL
商品のURL
Items->Item->mediumImageUrls->imageUrl([0])
商品画像
Items->Item->reviewCount
レビュー件数
Items->Item->reviewAverage
レビューの平均点数
Items->Item->shopName
店舗名
Items->Item->shopUrl
店舗URL

楽天のショッピングサイトの商品を表示

楽天のショッピングサイトの商品を表示
楽天市場の商品の中から
キーワードにマッチする商品を表示することができます
それを行うのが
楽天商品検索API2
これは楽天
http://www.rakuten.co.jp/
の中から商品情報を表示することができます
これも価格帯や送料無料などで絞り込みができます
除外キーワードを設定してNOT検索も可能
楽天商品検索API2を利用するには
楽天Webサービスへ登録して、アプリIDが必要になります
楽天商品検索API2の詳細は
http://webservice.rakuten.co.jp/api/ichibaitemsearch/
へ記載されています
ベースURLは
https://app.rakuten.co.jp/services/api/IchibaItem/Search/20120723
パラメータは
applicationId
アプリID
これは必須
そして、keyword, genreId , itemCode
のどれか1つが必須になる
というより、このどれかを指定しないと
商品の検索ができない
keyword
キーワード
genreId
ジャンルID
ジャンル名、ジャンルの親子関係を調べたい場合
楽天ジャンル検索API2
http://webservice.rakuten.co.jp/api/ichibagenresearch/
を参照
itemCode
商品コード
これら以外のパラメータとして
affiliateId
アフィリエイトID
format
初期値はjson
XMLにしたいなら xml を指定
hits
取得件数の指定
デフォルトは30
設定は1~30で設定可能
sort
検索結果の並び替えに使用
かなり細かく設定できる
+affiliateRate
アフィリエイト利率順(多い順)
-affiliaateRate
アフィリエイト利率順(少ない順)
+reviewCount
レビュー件数の多い順
-reviewCount
レビュー件数の少ない順
+reviewAverage
レビューの平均で多い順
-reviewAverage
レビューの平均で少ない順
+itemPrice
価格の高い順
-itemPrice
価格の安い順
+updateTimestamp
商品更新日の日時の新しい順
-updateTimestamp
商品更新日の日時の古い順
standard
楽天標準ソート順
これがデフォルト
minPrice
検索する最低価格を設定
maxPrice
検索する最高値の設定
availability
在庫の状態指定
0なら指定なし
1なら在庫があるものだけになる
デフォルトは1
imageFrag
しょうひんの画像の有無
0なら画像の有無を気にしない(デフォルト)
1なら画像があるものだけにする
orFlag
複数キーワードで検索するときの方法の指定
0ならAND検索(デフォルト)
1ならOR検索
NGkeyword
検索から除外するキーワード設定
これはURLエンコードする必要あり
postageFag
送料の設定
0なら有料を含む
1なら送料無料のみにする
これらのAPIを使うメリットは
アフィリエイトサイト作成と
自分なりに使いやすいサイトを構築できるということ
おそらく、スマートフォンのアプリなどにも使えるはず
続いて、以下はレスポンスフィールド関連
こちらは、サイトなどに内容表示するときに使います
count
検索結果の総商品数
itemName
商品名
catchcopy
キャッチコピー
itemPrice
商品価格
itemCaption
商品の説明
itemUrl
商品URL
affiliateUrl
アフィリエイトURL
ただし、パラメータにアフィリエイトIDが入っているときのみ
imageFlag
商品画像の有無
0なら画像なし
1なら画像あり
ifなどで判別するのに使える
smallImageUrls
商品画像(小)のURL
最大3枚を配列 imageUrl で返す
mediumImageUrls
商品画像(中)のURL
最大3枚を配列 imageUrl で返す
availability
販売の可否
0なら販売不可
1なら販売可
taxFlag
消費税について
0なら税込み
1なら税別
postageFlag
送料について
0なら送料込み
1なら送料別
reviewAverage
レビューの平均点数
shopName
店舗名
shopUrl
店舗URL

yahoo ショッピング商品検索API 仕様

yahoo ショッピング商品検索API 仕様
今回はXMLで実験してみました
詳しい解説は
http://developer.yahoo.co.jp/webapi/shopping/shopping/v1/itemsearch.html
に掲載されています
ベースURLは
http://shopping.yahooapis.jp/ShoppingWebService/V1/itemSearch
パラメータは
appid
必須
アプリのID
query
検索キーワード
ただし、UTF-8エンコード必須
type
検索のタイプ
all すべての文字列を含む(こっちがデフォルト)
any 検索文字のうちいずれかを含む
jan
JANコードで商品検索
isbn
ISBNコードで商品検索
本を探すときに使う
store_id
店のIDを指定して検索
店の絞り込みに使う
http://store.shopping.yahoo.co.jp/○○○○/index.html
の○○○○の部分のURL
http://shopping.yahoo.co.jp/stores
でお店の名前を選ぶと
でてきます
例えば、
12月度の月間ベストストア 第1位!
の中で
世界のお店ニューヨークの場合だと
http://store.shopping.yahoo.co.jp/newyork19892005/index.html
となっているので、
newyork19892005
の部分がストア名に該当します
price_from
再低価格の設定
price_to
最高値の設定
hits
取得する検索結果の数
デフォルトは20
最大で50
sort
並び替えの設定
ただし、URLエンコードする必要があります
具体的な設定は
+price
価格の安い順
-price
価格の高い順
+name
ストア名順(昇順)
あいうえお順
-name
ストア名順(降順)
あいうえお順の逆
+score
おすすめ順(昇順)
おすすめ度の高いものから
-score
おすすめ順(降順)
おすすめ度の低いものから
+sold
売れ筋順(昇順)
売れているものから
-sold
売れ筋順(降順)
売れていないものから
+review_count
レビュー(昇順)
評価の高いものから
-review_count
レビュー(降順)
評価の低いものから
デフォルトは +score になっています
availability
在庫の設定
在庫があるものだけにしたいなら
availability=1 にする
discount
セール品への絞り込み
セール中商品だけ表示したいなら
discount=1 にする
shipping
送料無料の設定
shipping=1 で送料無料となります
あとは、使いそうなものとして
payment
これは支払方法の絞り込みにつかいます
creditcard
ならカード支払可能
となります
ほかにもパラメータはいくつかあります
続いて、レスポンスフィールド
totalResultsAvailable
検索結果の総数
totalResultsReturned
検索結果のうち、かえってきた検索結果の数
firstResultPosition
最初の検索結果が何個目にあたるかということ
最初は1になります
/ResultSet/Result/Hit/Name
商品名
/ResultSet/Result/Hit/Url
商品URL
/ResultSet/Result/Hit/Description
商品の説明
/ResultSet/Result/Hit/Headline
キャッチコピー
/ResultSet/Result/Hit/Availability
在庫の有無
instock 在庫あり
outofstock 在庫なし
/ResultSet/Result/Hit/JanCode
JANコード
/ResultSet/Result/Hit/IsbnCode
ISBNコード
書籍に使う
/ResultSet/Result/Hit/Model
型番
/ResultSet/Result/Hit/Store/Url
店のURL
/ResultSet/Result/Hit/Store/Name
店の名前
/ResultSet/Result/Hit/Store/Ratings/Rate
お店の評価
/ResultSet/Result/Hit/Store/Ratings/Count
評価した人数
/ResultSet/Result/Hit/Image/Small
76×76サイズの画像URL
/ResultSet/Result/Hit/Image/Medium
146×146サイズの画像URL
/ResultSet/Result/Hit/Review/Count
商品のレビュー件数
/ResultSet/Result/Hit/Review/Rate
商品レビューの平均
/ResultSet/Result/Hit/Review/Url
商品レビューページのURL
/ResultSet/Result/Hit/Price
価格
/ResultSet/Result/Hit/PriceLabel/FixedPrice
定価
/ResultSet/Result/Hit/PriceLabel/SalePrice
セール価格
/ResultSet/Result/Hit/Category/Current/Name
現在カテゴリ名
/ResultSet/Result/Hit/Point/Amount
ポイント数
これらを使って
リクエストURLを組み立てます
例えば、
検索キーワードを指定して商品を探し
その中で、在庫があるのだけを表示するようにします
この場合
リクエストURLは
http://shopping.yahooapis.jp/ShoppingWebService/V1/itemSearch?appid=アプリID&query=検索キーワード&availability=1
というようになります
なお、検索キーワードは
URLエンコードする必要があります