APIドキュメント

認証

APIトークンを設定ページで確認。ユーザー登録した時点でランダムなAPIトークンが生成されている。変更可能(60文字以下)。

以降はこのAPIトークンを常に使う。

APIトークンの指定方法

1. Bearer

リクエストヘッダーで指定。基本的にはこれを使用。
Authorization: Bearer API_TOKEN

2. GET時のquery

GET /api/world?api_token=API_TOKEN

3. POST時のbody

ウォッチリストに追加(ASIN)

優先度を変更したい場合もこのAPIを使う。
POST /api/watch/asin

パラメータ

asin
必須。10文字のASINを指定。
priority
優先度。01。デフォルトは0。

ウォッチリストに追加(JAN/EAN)

ASINとは違いJANからASINに変換して追加するのでAPIはインポートを開始するまで。優先度の指定はできない。
POST /api/watch/ean

パラメータ

ean
必須。13文字のJAN/EANを指定。

ウォッチリストから削除(ASIN)

DELETE /api/watch/asin/{asin}
DELETE /api/watch/asin/0000000000

ウォッチリストに追加(カテゴリー)

POST /api/watch/browse

パラメータ

browse
必須。ブラウズノードIDを指定。

ウォッチリストから削除(カテゴリー)

DELETE /api/watch/browse/{browse}
DELETE /api/watch/browse/1234

【ワールド】国コード

JP,US

【ワールド】商品リストを取得

GET /api/world

レスポンス

更新時間順の商品リスト。

パラメータ

country
JPJP,USなど国コードを指定。,区切りで複数指定。デフォルトはすべての国。
search
商品タイトル/ASIN/JANで検索。
page
ページ。デフォルト1。
limit
1ページ辺りの表示数。デフォルト50。
GET /api/world?country=JP,US&search=test&page=2&limit=50

【ワールド】個別の商品データを取得

ASINで指定

GET /api/world/asin/{asin}

JAN/EAN(13桁)で指定

GET /api/world/ean/{ean}

パラメータ

country
JPJP,USなど国コードを指定。,区切りで複数指定。デフォルトはすべての国。
GET /api/world/asin/0000000000?country=JP,US

【ワールド】商品データを即時更新

これはPOSTメソッドにも対応。
GET /api/world/update?asin=0000000000&country=JP

レスポンス

更新後の各ASINの商品データ。

パラメータ

asin
必須。10桁のASINを指定。,区切りで複数指定。Amazon APIの仕様により最大10個まで。
country
JPなど国コードを指定。複数指定は不可。デフォルトはJP。
GET /api/world/update?asin=0000000000,1111111111&country=US

【ワールド】商品リスト(新着)を取得

GET /api/world/new

レスポンス

作成時間順の商品リスト。

パラメータ

since
2017-10-22など日付を指定。作成日が指定日以降の商品のみ。
country
JPJP,USなど国コードを指定。,区切りで複数指定。デフォルトはすべての国。
page
ページ。デフォルト1。
limit
1ページ辺りの表示数。デフォルト50。
GET /api/world/new?since=2017-10-22&country=JP&page=2&limit=50