Upgrade to Pro
— share decks privately, control downloads, hide ads and more …
Speaker Deck
Features
Speaker Deck
PRO
Sign in
Sign up for free
Search
Search
Amazon Marketplace API Update 対応が めちゃくちゃ大変だった件
Search
CData Software Japan
January 29, 2022
Technology
0
2.1k
Amazon Marketplace API Update 対応が めちゃくちゃ大変だった件
#burikaigi 2022/01/29
CData Software Japan Kazuya Sugimoto
CData Software Japan
January 29, 2022
Tweet
Share
More Decks by CData Software Japan
See All by CData Software Japan
CData Sync V25.2 アップデートをプロダクトスペシャリストが大解説 Microsoft Fabric 連携やSAP ERP CDC 機能など~
cdataj
0
12
電気自動車 Tesla の公式API をPostman から実行し、車両データを取得・分析してみよう!
cdataj
0
6
NetSuite MCP ServerとAIエージェントで未入金処理のオペレーション最適化を実現
cdataj
0
40
「データ統合の長い旅路の終着点とは?」〜現場の『壁』を打ち破るモダンアーキテクチャと CData Virtuality〜
cdataj
0
31
ログベースCDCの実装とクラウドDWHへのデータ連携 ⼤規模データ運⽤に向けたCData Syncの活⽤ポイント
cdataj
0
97
最近話題のMCP って何? HCL Dominoと組み合わせるとどうなるの? CData MCP Serversで連携してみよう
cdataj
0
100
API の仕様から紐解く「MCP 入門」 ~MCP の「コンテキスト」って何だ?~
cdataj
0
330
AI は、あなたの会社の「言葉」を話せるか?~CData MCP Servers が拓く、データ活用の新時代~
cdataj
0
210
CDataコネクタが提供する「標準化」の価値 ~なぜCDataは400種類ものMCP Serverを一度にリリースすることができたのか~
cdataj
0
110
Other Decks in Technology
See All in Technology
Kubernetes における cgroup v2 でのOut-Of-Memory 問題の解決
pfn
PRO
0
450
Grafana MCPサーバーによるAIエージェント経由でのGrafanaダッシュボード動的生成
hamadakoji
1
1.1k
BPaaSにおける人と協働する前提のAIエージェント-AWS登壇資料
kentarofujii
0
110
Vault meets Kubernetes
mochizuki875
0
190
生成AI時代のデータ基盤設計〜ペースレイヤリングで実現する高速開発と持続性〜 / Levtech Meetup_Session_2
sansan_randd
1
110
カミナシ社の『ID管理基盤』製品内製 - その意思決定背景と2年間の進化 #AWSUnicornDay / Kaminashi ID - The Big Whys
kaminashi
3
740
AIのグローバルトレンド2025 #scrummikawa / global ai trend
kyonmm
PRO
1
190
7月のガバクラ利用料が高かったので調べてみた
techniczna
3
820
2025年になってもまだMySQLが好き
yoku0825
8
3.5k
個人CLAUDE.md紹介と設定から学んだこと/introduce-my-claude-md
shibayu36
0
180
Snowflakeの生成AI機能を活用したデータ分析アプリの作成 〜Cortex AnalystとCortex Searchの活用とStreamlitアプリでの利用〜
nayuts
0
160
クラウドセキュリティを支える技術と運用の最前線 / Cutting-edge Technologies and Operations Supporting Cloud Security
yuj1osm
2
260
Featured
See All Featured
JavaScript: Past, Present, and Future - NDC Porto 2020
reverentgeek
51
5.6k
Building Better People: How to give real-time feedback that sticks.
wjessup
368
19k
Into the Great Unknown - MozCon
thekraken
40
2k
Practical Orchestrator
shlominoach
190
11k
Rebuilding a faster, lazier Slack
samanthasiow
83
9.1k
How to train your dragon (web standard)
notwaldorf
96
6.2k
The Art of Delivering Value - GDevCon NA Keynote
reverentgeek
15
1.6k
Designing for Performance
lara
610
69k
RailsConf & Balkan Ruby 2019: The Past, Present, and Future of Rails at GitHub
eileencodes
139
34k
Making the Leap to Tech Lead
cromwellryan
134
9.5k
How to Think Like a Performance Engineer
csswizardry
26
1.9k
Statistics for Hackers
jakevdp
799
220k
Transcript
© 2022 CData Software Japan, LLC | www.cdata.com/jp 1. About
CData Software Amazon Marketplace API Update 対応が めちゃくちゃ大変だった件 #burikaigi 2022/01/29 CData Software Japan Kazuya Sugimoto
© 2022 CData Software Japan, LLC | www.cdata.com/jp CData Software
Japan の API holic 担当 年100種類以上のAPIを見たり触ったりしています。 Twitter:@sugimomoto Facebook:sugimomoto Blog:http://kageura.hatenadiary.jp/ About Speaker 朝5時起きでブリを買ってきました
© 2022 CData Software Japan, LLC | www.cdata.com/jp 1. About
CData Software 本日のお話
© 2022 CData Software Japan, LLC | www.cdata.com/jp 業界最多級のデータソース Drivers
for NoSQL, Big Data, & SaaS Connectivity CRMおよびマーケティング自動化 会計システム コラボレーションおよびERP オンプレミスおよびクラウドDB ドキュメントおよびファイル形式 ソーシャルネットワーキング ネットワーキングおよび認証 電子商取引 その他
© 2022 CData Software Japan, LLC | www.cdata.com/jp API アップデートへの追従がチョー大変
© 2022 CData Software Japan, LLC | www.cdata.com/jp その中でもとりわけエグかった 「Amazon
Marketplace API Update 」 その対応で得た知見をシェア
© 2022 CData Software Japan, LLC | www.cdata.com/jp 1. About
CData Software Amazon Marketplace API とは?
© 2022 CData Software Japan, LLC | www.cdata.com/jp Amazon Marketplace
の 在庫・注文・商品・レポートなどが管理できるAPI
© 2022 CData Software Japan, LLC | www.cdata.com/jp 1. About
CData Software どんなAPI Updateだったの?
© 2022 CData Software Japan, LLC | www.cdata.com/jp API Update
の変更ポイント 1.APIデザイン 2.フォーマット 3.認証・認可 4.スケジュール
© 2022 CData Software Japan, LLC | www.cdata.com/jp APIデザインが大幅刷新 RPCライクなものからRESTベースに
POST /Orders/2013-09- 01/?AWSAccessKeyId=AKIAIKW5JHOTOOWSF43A&Ac tion=ListOrders&LastUpdatedAfter=1969-12- 31T15%3A00%3A00Z&MWSAuthToken=amzn.mws.X XX&MarketplaceId.Id.1=A1VC38T7YXB528&SellerId=A 1WD8M4EQL9XVH&Signature=XXXXX&SignatureMeth od=HmacSHA256&SignatureVersion=2&Timestamp= 2020-10-02T00%3A27%3A20Z&Version=2013-09-01 HTTP/1.1 Host: mws.amazonservices.jp Accept: application/xml Content-Type: application/xml GET /orders/v0/orders?MarketplaceIds=A1VC38T7YXB5 28&CreatedAfter=2021-08-09 HTTP/1.1 Host: sellingpartnerapi-fe.amazon.com Accept: application/json Authorization:****** x-amz-access-token: XXXXX x-amz-date: 20210809T073105Z x-amz-security-token: XXXXX MWS API Selling Partner API
© 2022 CData Software Japan, LLC | www.cdata.com/jp レスポンスフォーマットが XMLからJSONに変更
<ListOrdersResponse xmlns="https://mws.amazonservices.com/Orders/2013 -09-01"> <ListOrdersResult> <Orders> <Order> <LatestShipDate>2018-08- 17T14:59:59Z</LatestShipDate> <OrderType>StandardOrder</OrderType> <PurchaseDate>2018-08- 15T09:59:55.270Z</PurchaseDate> { "payload": { "Orders": [ { "NumberOfItemsUnshipped": 0, "BuyerInfo": {}, "IsReplacementOrder": "false", "IsSoldByAB": false, "AmazonOrderId": "503-9993250-1405404", "LatestShipDate": "2018-08-17T14:59:59Z", "EarliestShipDate": "2018-08-15T15:00:00Z MWS API Selling Partner API
© 2022 CData Software Japan, LLC | www.cdata.com/jp 認証・認可方法が 独自認証から独特な
OAuth 2.0?に クライアント ユーザー リソース 1. AWS IAMで AssumeRole を実施 2. Amazon marketplace APIへのア クセス権を付与したAWS AccessKey・SecretKeyを取得 3. 認可URLを生成 4. 認証・認可処理をリクエスト・ Codeを取得 5. Codeと引き換えにAccess Token を取得 6. Access TokenとAccessKey・ SecretKeyを元にAWS Signature を生成して、リクエストを実施
© 2022 CData Software Japan, LLC | www.cdata.com/jp API仕様が大幅変更にも関わらず 旧バージョンAPI終了予定が半年後
https://sellercentral.amazon.co.jp/forums/t/topic/73349 ※現在は2022年7月に延期
© 2022 CData Software Japan, LLC | www.cdata.com/jp 1. About
CData Software 対応として工夫した点
© 2022 CData Software Japan, LLC | www.cdata.com/jp デザインディスカッションする前に 必要なAPIをすべて試す
・開発チームに共有するために自分が実装 できる粒度でAPIを一通り試しておく ・Postman Collectionで必要なAPIリ クエスト・設定・検証方法を共有 ・検証した知見をドキュメント化して共有・つ いでに Blog にしてマーケティングコンテンツ に。開発チームもHappy https://www.cdatablog.jp/entry/amazonspapihowto01
© 2022 CData Software Japan, LLC | www.cdata.com/jp データモデルを極力変えない MWS
API SP-API Column Name Type Column Name Type OrderItemId VARCHAR OrderItemId VARCHAR AmazonOrderId VARCHAR AmazonOrderId VARCHAR ASIN VARCHAR ASIN VARCHAR SellerSKU VARCHAR SellerSKU VARCHAR BuyerCustomizedInfoCustomizedURL VARCHAR BuyerCustomizedInfoCustomizedURL VARCHAR Title VARCHAR Title VARCHAR QuantityOrdered INT QuantityOrdered INT QuantityShipped INT QuantityShipped INT GrantedPointsNumber INT GrantedPointsNumber INT GrantedPointsMonetaryValueAmount DECIMAL GrantedPointsMonetaryValueAmount DECIMAL GrantedPointsMonetaryValueCurrencyCode VARCHAR GrantedPointsMonetaryValueCurrencyCode VARCHAR NumberOfItems INT NumberOfItems INT ItemPriceAmount DECIMAL ItemPriceAmount DECIMAL ItemPriceCurrencyCode VARCHAR ItemPriceCurrencyCode VARCHAR ShippingPriceAmount DECIMAL ShippingPriceAmount DECIMAL ShippingPriceCurrencyCode VARCHAR ShippingPriceCurrencyCode VARCHAR GiftWrapPriceAmount VARCHAR GiftWrapPriceAmount VARCHAR GiftWrapPriceCurrencyCode VARCHAR GiftWrapPriceCurrencyCode VARCHAR TaxCollectionName VARCHAR #N/A #N/A TaxCollectionValue VARCHAR #N/A #N/A ItemTaxAmount DECIMAL ItemTaxAmount DECIMAL ・内部の実装は異なるが、インターフェース レベルでは同じ仕様を保てるようにする ・移行のしやすさ、ビジネスロジックサイドへ の影響を最小化 ・新しいAPIで存在しない項目、追加され た項目は致し方ないが
© 2022 CData Software Japan, LLC | www.cdata.com/jp 前のデータモデル・ロジックも残す ・API順次廃止とはいえ、まだ未リリースの
APIもあったため、スムーズな切り替えのた めデータモデル・ロジックを残存 (メンテナンスコストの観点から最初は反 発があった)
© 2022 CData Software Japan, LLC | www.cdata.com/jp 1. About
CData Software まとめ
© 2022 CData Software Japan, LLC | www.cdata.com/jp そんなこんなありながら、無事リリースしました https://www.cdatablog.jp/entry/amazonmarketplacespapiupdate
© 2022 CData Software Japan, LLC | www.cdata.com/jp 不安定かつ多様な「API」と共存している
© 2022 CData Software Japan, LLC | www.cdata.com/jp 不安定かつ多様なAPIと 連携しなければいけないのが実情
もし、この不安定さが直接的に ビジネスロジックに影響したら? APIへの追従・機能追加がアプリの スケールを阻害する可能性がある
© 2022 CData Software Japan, LLC | www.cdata.com/jp API Update
前提でビジネスと アーキテクチャを考えておくこと 疎結合・インターフェースを意識 ビジネスロジックへの影響を最小化するポイント こういうアップデートもあるんだということを ぜひ心に留めておいてください
© 2022 CData Software Japan, LLC | www.cdata.com/jp 1. About
CData Software 最後に
© 2022 CData Software Japan, LLC | www.cdata.com/jp CData Software
Japan では 業務拡大につき新しいメンバーを絶賛募集中! https://www.wantedly.com/companies/cdata2/projects ・テクニカルサポートエンジニア ・製品開発エンジニア ・インサイドセールス ・ローカライゼーション etc