ウィッシュリスト (Wishlist)

ウィッシュリスト関連のユーザー行動収集API

ウィッシュリスト追加

post

/actions/wishlist/add

ウィッシュリスト追加収集API

Authorizations

Api-KeystringRequired

APIキー

Header parameters

Content-Typestring · enumRequired

コンテンツタイプ

Possible values:

Idempotency-Keystring · uuidRequired

べき等性キー - クライアントが呼び出し時に渡す必要があります（UUID）

Body

ユーザーが商品をウィッシュリストに追加する行動を収集します

specversionstring · enumOptional

仕様バージョン

Possible values:

idstring · enumOptional

イベントの一意識別子

Possible values:

typestring · enumOptional

イベントタイプ

Possible values:

timestring · date-timeRequired

ISO 8601 UTC イベント作成時刻

sourcestringRequired

イベント発生元

datacontenttypestring · enumOptional

データコンテンツタイプ

Possible values:

dataschemastring · enumOptional

データスキーマパス

Possible values:

Responses

200

収集成功

No content

400

不正なリクエスト

503

一時的にサービスを利用できません

post/actions/wishlist/add

POST /actions/wishlist/add HTTP/1.1
Host: api.gelatto.ai
Api-Key: YOUR_API_KEY
Idempotency-Key: 123e4567-e89b-12d3-a456-426614174000
Content-Type: application/json
Accept: */*
Content-Length: 1085

{
  "specversion": "1.0.0",
  "id": "EVT-ADD-TO-WISHLIST",
  "type": "add_to_wishlist",
  "time": "2025-12-02T10:00:00Z",
  "source": "https://shop.groobee.com",
  "datacontenttype": "application/ld+json",
  "dataschema": "https://api.gelatto.ai/schema/actions/wishlist_add.json",
  "data": {
    "@context": "https://schema.org/",
    "@type": "AddAction",
    "agent": {
      "@type": "Person",
      "identifier": [
        {
          "@type": "PropertyValue",
          "propertyID": "memberId",
          "value": "groobee1234"
        },
        {
          "@type": "PropertyValue",
          "propertyID": "userId",
          "value": "2aa9a562-4182-4c59-b886-2be9d2a36b23"
        },
        {
          "@type": "PropertyValue",
          "propertyID": "cookieId",
          "value": "bb404573-c87f-b4b1-d6e7-f2750499bf06"
        },
        {
          "@type": "PropertyValue",
          "propertyID": "sessionId",
          "value": "8f9d2a6c-4e1b-4b2a-a9e1-7f6d5c4b3a21"
        },
        {
          "@type": "PropertyValue",
          "propertyID": "deviceCode",
          "value": "PC"
        }
      ]
    },
    "object": {
      "@type": "OrderItem",
      "orderedItem": {
        "@type": "Product",
        "sku": "NIKE_0000001",
        "name": [
          {
            "@value": "ナイキ エアジョーダン",
            "@language": "ja"
          }
        ],
        "offers": {
          "@type": "Offer",
          "price": 18000,
          "priceCurrency": "JPY"
        }
      }
    },
    "target": {
      "@type": "EntryPoint",
      "urlTemplate": "https://shop.groobee.com/wishlist"
    }
  }
}

No content

ウィッシュリスト削除

post

/actions/wishlist/remove

ウィッシュリスト削除収集API

Authorizations

Api-KeystringRequired

APIキー

Header parameters

Content-Typestring · enumRequired

コンテンツタイプ

Possible values:

Idempotency-Keystring · uuidRequired

べき等性キー - クライアントが呼び出し時に渡す必要があります（UUID）

Body

ユーザーが商品をウィッシュリストから削除する行動を収集します

specversionstring · enumOptional

仕様バージョン

Possible values:

idstring · enumOptional

イベントの一意識別子

Possible values:

typestring · enumOptional

イベントタイプ

Possible values:

timestring · date-timeRequired

ISO 8601 UTC イベント作成時刻

sourcestringRequired

イベント発生元

datacontenttypestring · enumOptional

データコンテンツタイプ

Possible values:

dataschemastring · enumOptional

データスキーマパス

Possible values:

Responses

200

収集成功

No content

400

不正なリクエスト

503

一時的にサービスを利用できません

post/actions/wishlist/remove

POST /actions/wishlist/remove HTTP/1.1
Host: api.gelatto.ai
Api-Key: YOUR_API_KEY
Idempotency-Key: 123e4567-e89b-12d3-a456-426614174000
Content-Type: application/json
Accept: */*
Content-Length: 1101

{
  "specversion": "1.0.0",
  "id": "EVT-REMOVE-FROM-WISHLIST",
  "type": "remove_from_wishlist",
  "time": "2025-12-02T10:00:00Z",
  "source": "https://shop.groobee.com",
  "datacontenttype": "application/ld+json",
  "dataschema": "https://api.gelatto.ai/schema/actions/wishlist_remove.json",
  "data": {
    "@context": "https://schema.org/",
    "@type": "DeleteAction",
    "agent": {
      "@type": "Person",
      "identifier": [
        {
          "@type": "PropertyValue",
          "propertyID": "memberId",
          "value": "groobee1234"
        },
        {
          "@type": "PropertyValue",
          "propertyID": "userId",
          "value": "2aa9a562-4182-4c59-b886-2be9d2a36b23"
        },
        {
          "@type": "PropertyValue",
          "propertyID": "cookieId",
          "value": "bb404573-c87f-b4b1-d6e7-f2750499bf06"
        },
        {
          "@type": "PropertyValue",
          "propertyID": "sessionId",
          "value": "8f9d2a6c-4e1b-4b2a-a9e1-7f6d5c4b3a21"
        },
        {
          "@type": "PropertyValue",
          "propertyID": "deviceCode",
          "value": "PC"
        }
      ]
    },
    "object": {
      "@type": "OrderItem",
      "orderedItem": {
        "@type": "Product",
        "sku": "NIKE_0000001",
        "name": [
          {
            "@value": "ナイキ エアジョーダン",
            "@language": "ja"
          }
        ],
        "offers": {
          "@type": "Offer",
          "price": 18000,
          "priceCurrency": "JPY"
        }
      }
    },
    "target": {
      "@type": "EntryPoint",
      "urlTemplate": "https://shop.groobee.com/wishlist"
    }
  }
}

No content