Service
amazon.co.jp 구매자 계정을 연결하면 카탈로그 검색, 상품 상세 조회, 장바구니와 저장된 결제 수단 및 주문 내역 확인, 결제 합계 미리보기, 가격 하락 추적을 사용할 수 있습니다. 공개 카탈로그 조회는 연결 없이 가능하며 장바구니, 주문, 결제 수단, 결제는 로그인 세션이 필요합니다.
94.62%30일 가동률평균 응답6511ms
행을 선택하면 해당 API의 레퍼런스로 이동합니다.
| Method | API | Path | Summary |
|---|---|---|---|
| POST | /v1/amazon-jp/add-cart-item | Add a product_id to the connected shopper's amazon.co.jp cart with an optional quantity (defaults to 1). Use only with explicit user intent to add that item to the cart. Do NOT use to track a product's price without buying it — use amazon-jp:create-price-watch instead. Requires a connected shopper account (signed-in session). Returns action, added, and the updated cart. | |
| POST | /v1/amazon-jp/check-price-drops | Re-fetch every watched product, compare the current price with the saved snapshot and target_price, and update each watch's snapshot. Use on demand or on a schedule to detect price drops for tracked products. Do NOT use to add or remove watches — use amazon-jp:create-price-watch or amazon-jp:delete-price-watch instead. Requires a connected shopper account (signed-in session). Returns action and drops, listing only products whose price fell or reached target_price, each with product_id, title, old_price, new_price, drop_percent, and target_hit. | |
| POST | /v1/amazon-jp/clear-cart | Empty the connected shopper's amazon.co.jp cart. Use only with explicit user intent to remove all cart items. Do NOT use to remove a single item — use amazon-jp:remove-cart-item instead. Requires a connected shopper account (signed-in session). Returns action and the resulting cart. | |
| POST | /v1/amazon-jp/create-price-watch | Create or replace a price watch for a product_id with an optional target_price, storing the current price as the saved snapshot. Use when the user wants to track a product's price over time. Do NOT use to buy the product — use amazon-jp:add-cart-item instead; do NOT use to compare against the current price — use amazon-jp:check-price-drops instead. Requires a connected shopper account (signed-in session). Returns action plus the stored watch entry with product_id, title, target_price, last_price, added_at, and last_checked_at. | |
key가 호출할 수 있는 서비스와 API의 범위를 정의합니다.
멱등한 호출의 재시도 규칙과 backoff 동작을 설명합니다.
예약 확정, 배달 상태 변경 같은 이벤트를 webhook으로 수신합니다.
| POST |
| /v1/amazon-jp/delete-price-watch |
| Delete the price watch for one product_id. Use when the user wants to stop tracking a product. Do NOT use to remove an item from the cart — use amazon-jp:remove-cart-item instead. Requires a connected shopper account (signed-in session). Returns action, removed, and product_id. |
| POST | /v1/amazon-jp/get-cart | Read the connected shopper's amazon.co.jp cart contents and subtotal. Use when the current cart state is needed before changing the cart or starting checkout. Do NOT use for the checkout estimated_total or notes — use amazon-jp:preview-checkout instead. Requires a connected shopper account (signed-in session). Returns items, subtotal, and item_count. |
| POST | /v1/amazon-jp/get-order | Read one amazon.co.jp order by order_id from the connected shopper's order history. Use when the user wants the details of one specific order, typically after amazon-jp:list-orders. Do NOT use to browse or list orders — use amazon-jp:list-orders instead. Requires a connected shopper account (signed-in session). Returns order_id, placed_at, total, ship_to, delivery, return_eligible, and items. |
| POST | /v1/amazon-jp/get-product | Read one amazon.co.jp product page by product_id, the public Amazon product identifier. Use when the product_id is already known and full detail is needed. Do NOT use for keyword discovery — use amazon-jp:search-products instead. Works without a connected account. Returns normalized product detail including title, url, image_url, price, brand, availability, points, delivery, and features. |
| POST | /v1/amazon-jp/list-orders | List recent amazon.co.jp orders for the connected shopper, up to the optional limit (default 10). Use when the user wants order history or needs an order_id to pass to amazon-jp:get-order. Do NOT use for one order's full detail — use amazon-jp:get-order instead. Requires a connected shopper account (signed-in session). Returns orders as normalized summaries with snake_case fields. |
| POST | /v1/amazon-jp/list-payment-methods | List saved payment methods for the connected shopper's amazon.co.jp account. Use when the user wants to see which payment choices are available before checkout. Do NOT use to get the checkout total — use amazon-jp:preview-checkout instead. Requires a connected shopper account (signed-in session). Returns methods with display name and description only; full card numbers are never exposed. |
| POST | /v1/amazon-jp/list-price-watches | List the price watches stored for the connected shopper. Use when the user wants to see which products are tracked and their last saved price snapshots. Do NOT use to fetch current prices or detect drops — use amazon-jp:check-price-drops instead. Requires a connected shopper account (signed-in session). Returns items, one watch entry per product_id with snake_case price-watch fields. |
| POST | /v1/amazon-jp/preview-checkout | Drive amazon.co.jp checkout to the final review stage without placing an order. Use when the user wants the estimated total and checkout notes for the current cart before deciding to buy. Do NOT use to read or change cart contents — use amazon-jp:get-cart, amazon-jp:add-cart-item, or amazon-jp:remove-cart-item instead. Never places an order; fails when the cart is empty. Requires a connected shopper account (signed-in session). Returns action, stage, cart, estimated_total, requires_confirmation, and notes. |
| POST | /v1/amazon-jp/remove-cart-item | Remove one product_id from the connected shopper's amazon.co.jp cart. Use only with explicit user intent to remove that specific item. Do NOT use to empty the whole cart — use amazon-jp:clear-cart instead. Requires a connected shopper account (signed-in session). Returns action, removed, and the updated cart. |
| POST | /v1/amazon-jp/search-products | Search the amazon.co.jp catalog by keyword with optional sort, min_price, and max_price filters. Use when the product is not yet known and must be discovered before calling amazon-jp:get-product or adding it to the cart. Do NOT use for a known product_id — use amazon-jp:get-product instead. Works without a connected account. Returns keyword, page, total, and products (summaries, each with product_id and snake_case fields). |
