商品を同期する

Sankaの商品データを取得して外部システムに同期する手順です。

​

概要

商品一覧を定期取得し、更新が必要な場合は作成APIで Upsert します。

​

同期方針を決める

• 同期の頻度（例: 1時間ごと、1日1回）
• どの項目を使って突合するか（例: 外部ID）

​

商品一覧を取得する

curl -X GET "https://api.sanka.com/v1/public/items" \
  -H "Authorization: Bearer <access_token>"

レスポンス例:

{
  "data": [
    {
      "id": "itm_123",
      "name": "りんご",
      "price": 120,
      "currency": "JPY",
      "status": "active",
      "updated_at": "2026-01-20T12:00:00Z"
    }
  ]
}

​

外部システムに反映する

• id や外部IDをキーに突合
• 差分だけ更新して負荷を抑える
• 変更を送るときは 商品作成 を使い、external_id でUpsertする