楽天市場API:ジャンルID、タグIDの最終更新日を返すAPI

楽天市場API:ジャンルID、タグIDの最終更新日を返すAPI

楽天市場のジャンルID、タグIDの最終更新日を取得できるAPI

2018年10月現在、ジャンルIDは月1回以上、タグIDは毎週の見直しがあります。そのため最終更新日を教えてくれるこのAPIは(構築次第ですが)情報更新の指針となります。

例えばジャンルIDを取り込もうとした時、DB内のタイムスタンプと日時を比較しAPIで取得した更新日の値が大きければシステムDB内の更新をするなどの使い方が出来ます。

APIメソッド:navigation.genre.header.get

この機能を利用すると、 NavigationAPIが返却するデータの最終更新日時を取得することができます。

Endpoint / HTTP Method

Endpoint HTTP Method
https://api.rms.rakuten.co.jp/es/1.0/navigation/genre/header/get GET

Request

HTTP Header
No Key Value Note
1 Authorization ESA Base64(serviceSecret:licenseKey)
Query parameters
No Parameter Description Type Mandatory Multiplicity Note
1 genreId ジャンルID String 1

Response

HTTP Header
No Key Value
1 Content-Type text/xml
HTTP Body
XML:result
No Element Description Type Size(byte) Multiplicity Note
1 result.status ステータス XML : status 1 interfaceId = navigation.genre.header.get
2 result.navigationHeaderGetResult ヘッダー取得情報 XML : navigationHeaderGetResult 1

 

XML:navigationHeaderGetResult
No Element Description Type Size(byte) Multiplicity Note
1 navigationHeaderGetResult.status 結果ステータス String 255 1
2 navigationHeaderGetResult.genreLastUpdateDate ジャンル最終更新日時 String 255 1 ジャンルデータの最終更新日時。
3 navigationHeaderGetResult.tagLastUpdateDate タグ最終更新日時 String 255 1 タグデータの最終更新日時。