> For the complete documentation index, see [llms.txt](https://help.genser.ai/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://help.genser.ai/ja/developers/action-data/api-references/kto-cart.md).

# カート (Cart)

カート関連のユーザー行動収集API

## カート追加

> カート追加収集API

```json
{"openapi":"3.1.0","info":{"title":"Gelatto イベント収集API（基本）","version":"1.0.0"},"tags":[{"name":"カート (Cart)","description":"カート関連のユーザー行動収集API"}],"servers":[{"url":"https://api.gelatto.ai","description":"Production"},{"url":"https://api-dev.gelatto.ai","description":"Development"},{"url":"http://localhost","description":"Local Development (ポート80)"}],"security":[{"ApiKeyAuth":[]}],"components":{"securitySchemes":{"ApiKeyAuth":{"type":"apiKey","in":"header","name":"Api-Key","description":"APIキー"}},"schemas":{"ActionsCartAddEvent":{"title":"カート追加","description":"ユーザーが商品をカートに追加する行動を収集します","type":"object","required":["time","source","data"],"properties":{"specversion":{"type":"string","description":"仕様バージョン","enum":["1.0.0"]},"id":{"type":"string","description":"イベントの一意識別子","enum":["EVT-ADD-TO-CART"]},"type":{"type":"string","description":"イベントタイプ","enum":["add_to_cart"]},"time":{"type":"string","description":"ISO 8601 UTC イベント作成時刻","format":"date-time"},"source":{"type":"string","description":"イベント発生元"},"datacontenttype":{"type":"string","description":"データコンテンツタイプ","enum":["application/ld+json"]},"dataschema":{"type":"string","description":"データスキーマパス","enum":["https://api.gelatto.ai/schema/actions/cart_add.json"]},"data":{"type":"object","description":"イベントデータオブジェクト","required":["agent","object"],"properties":{"@context":{"type":"string","description":"スキーマコンテキスト","enum":["https://schema.org/"]},"@type":{"type":"string","description":"アクションタイプ","enum":["AddAction"]},"agent":{"type":"object","description":"実行者（Person）","required":["identifier"],"properties":{"@type":{"type":"string","enum":["Person"]},"identifier":{"items":{"type":"object","required":["propertyID","value"],"properties":{"@type":{"type":"string","enum":["PropertyValue"]},"propertyID":{"type":"string","description":"プロパティID"},"value":{"type":"string","description":"値"}}},"type":"array","description":"実行者識別子リスト（userId、memberId、cookieIdは必須で追加する必要があります。属性の追加が必要な場合は協議）"},"gender":{"type":"string","enum":["Female","Male","https://schema.org/Female","https://schema.org/Male"]},"additionalProperty":{"items":{"type":"object","required":["propertyID","value"],"properties":{"@type":{"type":"string","enum":["PropertyValue"]},"propertyID":{"type":"string","description":"プロパティID"},"value":{"oneOf":[{"type":"string"},{"type":"number"}],"description":"値"}}},"type":"array","description":"追加属性"}}},"object":{"oneOf":[{"$ref":"#/components/schemas/ActionsCartAddOrderItem"},{"type":"array","items":{"$ref":"#/components/schemas/ActionsCartAddOrderItem"}}]},"target":{"type":"object","description":"エンドポイント情報","required":["urlTemplate"],"properties":{"@type":{"type":"string","enum":["EntryPoint"]},"urlTemplate":{"type":"string","description":"URL"}}}}}}},"ActionsCartAddOrderItem":{"description":"購入情報","type":"object","required":["orderedItem","orderQuantity"],"properties":{"@type":{"type":"string","enum":["OrderItem"]},"orderedItem":{"$ref":"#/components/schemas/ActionsCartAddProduct"},"orderQuantity":{"type":"number","description":"数量"}}},"ActionsCartAddProduct":{"description":"商品オブジェクト","type":"object","required":["sku","name","offers"],"properties":{"@type":{"type":"string","enum":["Product"]},"sku":{"type":"string","description":"商品一意識別子、商品コード（SKU）"},"name":{"description":"商品名","oneOf":[{"description":"単純文字列","type":"string"},{"description":"多言語オブジェクト","type":"object","required":["@value","@language"],"properties":{"@value":{"type":"string","description":"商品名の値"},"@language":{"type":"string","description":"ISO 639-1 言語コード","enum":["ko","en","ja"]}}},{"description":"多言語配列","type":"array","items":{"type":"object","required":["@value","@language"],"properties":{"@value":{"type":"string","description":"商品名の値"},"@language":{"type":"string","description":"ISO 639-1 言語コード","enum":["ko","en","ja"]}}}}]},"offers":{"$ref":"#/components/schemas/ActionsCartAddOffer"}}},"ActionsCartAddOffer":{"description":"数量/価格オブジェクト","type":"object","required":["price","priceCurrency"],"properties":{"@type":{"type":"string","enum":["Offer"]},"price":{"type":"number","description":"販売価格"},"priceCurrency":{"type":"string","description":"ISO 4217 通貨コード（例：KRW、USD、JPY）"}}}}},"paths":{"/actions/cart/add":{"post":{"summary":"カート追加","description":"カート追加収集API","operationId":"collectCartAdd","tags":["カート (Cart)"],"parameters":[{"name":"Content-Type","in":"header","required":true,"schema":{"type":"string","enum":["application/json"]},"description":"コンテンツタイプ"},{"name":"Idempotency-Key","in":"header","required":true,"schema":{"type":"string","format":"uuid"},"description":"べき等性キー - クライアントが呼び出し時に渡す必要があります（UUID）"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ActionsCartAddEvent"}}}},"responses":{"200":{"description":"収集成功"},"400":{"description":"不正なリクエスト"},"503":{"description":"一時的にサービスを利用できません"}}}}}}
```

## カート削除

> カート削除収集API

```json
{"openapi":"3.1.0","info":{"title":"Gelatto イベント収集API（基本）","version":"1.0.0"},"tags":[{"name":"カート (Cart)","description":"カート関連のユーザー行動収集API"}],"servers":[{"url":"https://api.gelatto.ai","description":"Production"},{"url":"https://api-dev.gelatto.ai","description":"Development"},{"url":"http://localhost","description":"Local Development (ポート80)"}],"security":[{"ApiKeyAuth":[]}],"components":{"securitySchemes":{"ApiKeyAuth":{"type":"apiKey","in":"header","name":"Api-Key","description":"APIキー"}},"schemas":{"ActionsCartRemoveEvent":{"title":"カート削除","description":"ユーザーが商品をカートから削除する行動を収集します","type":"object","required":["time","source","data"],"properties":{"specversion":{"type":"string","description":"仕様バージョン","enum":["1.0.0"]},"id":{"type":"string","description":"イベントの一意識別子","enum":["EVT-REMOVE-FROM-CART"]},"type":{"type":"string","description":"イベントタイプ","enum":["remove_from_cart"]},"time":{"type":"string","description":"ISO 8601 UTC イベント作成時刻","format":"date-time"},"source":{"type":"string","description":"イベント発生元"},"datacontenttype":{"type":"string","description":"データコンテンツタイプ","enum":["application/ld+json"]},"dataschema":{"type":"string","description":"データスキーマパス","enum":["https://api.gelatto.ai/schema/actions/cart_remove.json"]},"data":{"type":"object","description":"イベントデータオブジェクト","required":["agent","object"],"properties":{"@context":{"type":"string","description":"スキーマコンテキスト","enum":["https://schema.org/"]},"@type":{"type":"string","description":"アクションタイプ","enum":["DeleteAction"]},"agent":{"type":"object","description":"実行者（Person）","required":["identifier"],"properties":{"@type":{"type":"string","enum":["Person"]},"identifier":{"items":{"type":"object","required":["propertyID","value"],"properties":{"@type":{"type":"string","enum":["PropertyValue"]},"propertyID":{"type":"string","description":"プロパティID"},"value":{"type":"string","description":"値"}}},"type":"array","description":"実行者識別子リスト（userId、memberId、cookieIdは必須で追加する必要があります。属性の追加が必要な場合は協議）"},"gender":{"type":"string","enum":["Female","Male","https://schema.org/Female","https://schema.org/Male"]},"additionalProperty":{"items":{"type":"object","required":["propertyID","value"],"properties":{"@type":{"type":"string","enum":["PropertyValue"]},"propertyID":{"type":"string","description":"プロパティID"},"value":{"oneOf":[{"type":"string"},{"type":"number"}],"description":"値"}}},"type":"array","description":"追加属性"}}},"object":{"oneOf":[{"$ref":"#/components/schemas/ActionsCartRemoveOrderItem"},{"type":"array","items":{"$ref":"#/components/schemas/ActionsCartRemoveOrderItem"}}]},"target":{"type":"object","description":"エンドポイント情報","required":["urlTemplate"],"properties":{"@type":{"type":"string","enum":["EntryPoint"]},"urlTemplate":{"type":"string","description":"URL"}}}}}}},"ActionsCartRemoveOrderItem":{"description":"購入情報","type":"object","required":["orderedItem","orderQuantity"],"properties":{"@type":{"type":"string","enum":["OrderItem"]},"orderedItem":{"$ref":"#/components/schemas/ActionsCartRemoveProduct"},"orderQuantity":{"type":"number","description":"数量"}}},"ActionsCartRemoveProduct":{"description":"商品オブジェクト","type":"object","required":["sku","name","offers"],"properties":{"@type":{"type":"string","enum":["Product"]},"sku":{"type":"string","description":"商品一意識別子、商品コード（SKU）"},"name":{"description":"商品名","oneOf":[{"description":"単純文字列","type":"string"},{"description":"多言語オブジェクト","type":"object","required":["@value","@language"],"properties":{"@value":{"type":"string","description":"商品名の値"},"@language":{"type":"string","description":"ISO 639-1 言語コード","enum":["ko","en","ja"]}}},{"description":"多言語配列","type":"array","items":{"type":"object","required":["@value","@language"],"properties":{"@value":{"type":"string","description":"商品名の値"},"@language":{"type":"string","description":"ISO 639-1 言語コード","enum":["ko","en","ja"]}}}}]},"offers":{"$ref":"#/components/schemas/ActionsCartRemoveOffer"}}},"ActionsCartRemoveOffer":{"description":"数量/価格オブジェクト","type":"object","required":["price","priceCurrency"],"properties":{"@type":{"type":"string","enum":["Offer"]},"price":{"type":"number","description":"販売価格"},"priceCurrency":{"type":"string","description":"ISO 4217 通貨コード（例：KRW、USD、JPY）"}}}}},"paths":{"/actions/cart/remove":{"post":{"summary":"カート削除","description":"カート削除収集API","operationId":"collectCartRemove","tags":["カート (Cart)"],"parameters":[{"name":"Content-Type","in":"header","required":true,"schema":{"type":"string","enum":["application/json"]},"description":"コンテンツタイプ"},{"name":"Idempotency-Key","in":"header","required":true,"schema":{"type":"string","format":"uuid"},"description":"べき等性キー - クライアントが呼び出し時に渡す必要があります（UUID）"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ActionsCartRemoveEvent"}}}},"responses":{"200":{"description":"収集成功"},"400":{"description":"不正なリクエスト"},"503":{"description":"一時的にサービスを利用できません"}}}}}}
```