상품 데이터 수집 API

상품 수집

post

상품 데이터를 수집합니다.

Header parameters

Content-Typestring · enumRequired

컨텐츠 타입

Possible values:

Api-KeystringRequired

API 키

Body

고객사의 상품 데이터 수집

@contextstring · enumOptional

스키마 context

Possible values:

specversionstring · enumOptional

스펙 버전

Possible values:

idstring · enumOptional

이벤트 고유 식별자

Possible values:

typestring · enumOptional

상품 수집 유형

Possible values:

Responses

200

수집 성공

No content

400

잘못된 요청

503

서비스 일시 불가

post/collector/products

POST /collector/products HTTP/1.1
Host: api.gelatto.ai
Api-Key: text
Content-Type: application/json
Accept: */*
Content-Length: 2616

{
  "@context": "https://schema.org",
  "specversion": "1.0",
  "id": "EVT-CREATE-PRODUCT",
  "type": "create_product",
  "agent": {
    "@type": "Organization",
    "name": "Sample Seller Inc."
  },
  "@graph": [
    {
      "@type": "Product",
      "sku": "SKU-0001",
      "name": {
        "@value": "프리미엄 무선 헤드폰",
        "@language": "ko"
      },
      "description": {
        "@type": "TextObject",
        "text": "노이즈 캔슬링 기능을 갖춘 프리미엄 무선 헤드폰입니다.",
        "inLanguage": "ko",
        "additionalProperty": [
          {
            "@type": "PropertyValue",
            "propertyID": "sub_description",
            "value": [
              "프리미엄 무선 헤드폰"
            ]
          }
        ]
      },
      "brand": {
        "@type": "Brand",
        "@id": "BRD-001",
        "name": [
          {
            "@value": "SoundMax",
            "@language": "en"
          }
        ],
        "logo": [
          "https://example.com/images/logo.png"
        ]
      },
      "category": [
        {
          "@type": "CategoryCode",
          "codeValue": "ELEC-HEADPHONE",
          "name": [
            {
              "@value": "헤드폰",
              "@language": "ko"
            }
          ],
          "position": 1
        }
      ],
      "positiveNotes": [
        {
          "@value": "착용감이 편안하고 음질이 뛰어남",
          "@language": "ko"
        }
      ],
      "url": [
        {
          "@value": "https://example.com/products/sku-12345",
          "@language": "ko"
        }
      ],
      "itemCondition": "NewCondition",
      "hasAdultConsideration": "AlcoholConsideration",
      "countryOfOrigin": {
        "@type": "Country",
        "address": "KR"
      },
      "material": [
        {
          "@value": "플라스틱",
          "@language": "ko"
        },
        {
          "@value": "알루미늄",
          "@language": "ko"
        }
      ],
      "offers": [
        {
          "@type": "Offer",
          "sku": "SKU-0001",
          "gtin": 881234567890,
          "mpn": "SMX-WH-900",
          "price": 299000,
          "priceCurrency": "KRW",
          "priceSpecification": {
            "@type": "UnitPriceSpecification",
            "priceType": "SalePrice",
            "price": 299000,
            "priceCurrency": "KRW",
            "unitCode": "C62"
          },
          "color": "Black",
          "size": "XL-1",
          "availability": "InStock",
          "availabilityStarts": "2026-01-01T00:00:00+09:00Z",
          "availabilityEnds": "2026-12-31T23:59:59+09:00Z",
          "inventoryLevel": {
            "@type": "QuantitativeValue",
            "value": 150
          },
          "shippingDetails": {
            "@type": "OfferShippingDetails",
            "weight": {
              "@type": "QuantitativeValue",
              "value": 0.85,
              "unitCode": "KGM"
            }
          },
          "image": [
            {
              "@type": "ImageObject",
              "representativeOfPage": false,
              "contentUrl": "https://example.com/images/sku-12345.jpg"
            }
          ]
        },
        {
          "@type": "Offer",
          "sku": "SKU-0001-BLK",
          "gtin": 881234567890,
          "mpn": "SMX-WH-900",
          "price": 299000,
          "priceCurrency": "KRW",
          "priceSpecification": {
            "@type": "UnitPriceSpecification",
            "priceType": "SalePrice",
            "price": 299000,
            "priceCurrency": "KRW",
            "unitCode": "C62"
          },
          "color": "Black",
          "size": "XL-1",
          "availability": "InStock",
          "availabilityStarts": "2026-01-01T00:00:00+09:00Z",
          "availabilityEnds": "2026-12-31T23:59:59+09:00Z",
          "inventoryLevel": {
            "@type": "QuantitativeValue",
            "value": 150
          },
          "shippingDetails": {
            "@type": "OfferShippingDetails",
            "weight": {
              "@type": "QuantitativeValue",
              "value": 0.85,
              "unitCode": "KGM"
            }
          },
          "image": [
            {
              "@type": "ImageObject",
              "representativeOfPage": false,
              "contentUrl": "https://example.com/images/sku-12345.jpg"
            }
          ]
        }
      ]
    }
  ]
}

No content

상품 수정

put

상품 데이터를 수정합니다.

Header parameters

Content-Typestring · enumRequired

컨텐츠 타입

Possible values:

Api-KeystringRequired

API 키

Body

고객사의 상품 데이터 수집

@contextstring · enumOptional

스키마 context

Possible values:

specversionstring · enumOptional

스펙 버전

Possible values:

idstring · enumOptional

이벤트 고유 식별자

Possible values:

typestring · enumOptional

상품 수집 유형

Possible values:

Responses

200

수집 성공

No content

400

잘못된 요청

503

서비스 일시 불가

put/collector/products

PUT /collector/products HTTP/1.1
Host: api.gelatto.ai
Api-Key: text
Content-Type: application/json
Accept: */*
Content-Length: 2484

{
  "@context": "https://schema.org",
  "specversion": "1.0",
  "id": "EVT-UPDATE-PRODUCT",
  "type": "update_product",
  "agent": {
    "@type": "Organization",
    "name": "Sample Seller Inc."
  },
  "@graph": [
    {
      "@type": "Product",
      "sku": "SKU-12345",
      "name": {
        "@value": "프리미엄 무선 헤드폰",
        "@language": "ko"
      },
      "description": {
        "@type": "TextObject",
        "text": "노이즈 캔슬링 기능을 갖춘 프리미엄 무선 헤드폰입니다.",
        "inLanguage": "ko"
      },
      "brand": {
        "@type": "Brand",
        "@id": "brand-001",
        "name": [
          {
            "@value": "SoundMax",
            "@language": "en"
          }
        ],
        "logo": [
          "https://example.com/images/logo.png"
        ]
      },
      "category": [
        {
          "@type": "CategoryCode",
          "codeValue": "ELEC-HEADPHONE",
          "name": [
            {
              "@value": "헤드폰",
              "@language": "ko"
            }
          ],
          "position": 1
        }
      ],
      "color": "Black",
      "positiveNotes": [
        {
          "@value": "착용감이 편안하고 음질이 뛰어남",
          "@language": "ko"
        }
      ],
      "url": [
        {
          "@value": "https://example.com/products/sku-12345",
          "@language": "en"
        }
      ],
      "itemCondition": "NewCondition",
      "hasAdultConsideration": "AlcoholConsideration",
      "countryOfOrigin": {
        "@type": "Country",
        "address": "KR"
      },
      "material": [
        {
          "@value": "플라스틱, 알루미늄",
          "@language": "ko"
        }
      ],
      "offers": [
        {
          "@type": "Offer",
          "sku": "SKU-12345",
          "gtin": 881234567890,
          "mpn": "SMX-WH-900",
          "price": 299000,
          "priceCurrency": "KRW",
          "priceSpecification": {
            "@type": "UnitPriceSpecification",
            "priceType": "SalePrice",
            "price": 299000,
            "priceCurrency": "KRW",
            "unitCode": "C62"
          },
          "color": "Black",
          "size": "XL-1",
          "availability": "InStock",
          "availabilityStarts": "2026-01-01T00:00:00+09:00Z",
          "availabilityEnds": "2026-12-31T23:59:59+09:00Z",
          "inventoryLevel": {
            "@type": "QuantitativeValue",
            "value": 150
          },
          "shippingDetails": {
            "@type": "OfferShippingDetails",
            "weight": {
              "@type": "QuantitativeValue",
              "value": 0.85,
              "unitCode": "KGM"
            }
          },
          "image": [
            {
              "@type": "ImageObject",
              "representativeOfPage": false,
              "contentUrl": "https://example.com/images/sku-12345.jpg"
            }
          ]
        },
        {
          "@type": "Offer",
          "sku": "SKU-12345-1",
          "gtin": 881234567890,
          "mpn": "SMX-WH-900",
          "price": 299000,
          "priceCurrency": "KRW",
          "priceSpecification": {
            "@type": "UnitPriceSpecification",
            "priceType": "SalePrice",
            "price": 299000,
            "priceCurrency": "KRW",
            "unitCode": "C62"
          },
          "color": "Black",
          "size": "XL-1",
          "availability": "InStock",
          "availabilityStarts": "2026-01-01T00:00:00+09:00Z",
          "availabilityEnds": "2026-12-31T23:59:59+09:00Z",
          "inventoryLevel": {
            "@type": "QuantitativeValue",
            "value": 150
          },
          "shippingDetails": {
            "@type": "OfferShippingDetails",
            "weight": {
              "@type": "QuantitativeValue",
              "value": 0.85,
              "unitCode": "KGM"
            }
          },
          "image": [
            {
              "@type": "ImageObject",
              "representativeOfPage": false,
              "contentUrl": "https://example.com/images/sku-12345.jpg"
            }
          ]
        }
      ]
    }
  ]
}

No content

상품 삭제

put

상품 데이터 삭제 요청합니다.

Header parameters

Content-Typestring · enumRequired

컨텐츠 타입

Possible values:

Api-KeystringRequired

API 키

Body

고객사의 상품 데이터 삭제 요청 수집

@contextstring · enumOptional

스키마 context

Possible values:

specversionstring · enumOptional

스펙 버전

Possible values:

idstring · enumOptional

이벤트 고유 식별자

Possible values:

typestring · enumOptional

상품 수집 유형

Possible values:

Responses

200

수집 성공

No content

400

잘못된 요청

503

서비스 일시 불가

put/collector/products-delete

PUT /collector/products-delete HTTP/1.1
Host: api.gelatto.ai
Api-Key: text
Content-Type: application/json
Accept: */*
Content-Length: 213

{
  "@context": "https://schema.org",
  "specversion": "1.0",
  "id": "EVT-DELETE-PRODUCT",
  "type": "delete_product",
  "agent": {
    "@type": "Organization",
    "name": "Sample Seller Inc."
  },
  "@graph": [
    {
      "@type": "Product",
      "sku": "SKU-12345"
    }
  ]
}

No content