상품 카탈로그

사전 작업

서버에서 이벤트를 전송하기 전, 먼저 프로젝트에 유효한 토큰을 발급받아 주세요.

인증 토큰 발급 방법

1. 개요

카탈로그 데이터를 전송할 수 있도록 제공하는 Open API입니다. 상품 속성에 대한 자세한 설명은 카탈로그 속성에서 확인하세요.

2. 인증

API를 사용하려면 서버에서 발급받은 API 키를 Authorization 헤더에 포함해야 합니다.

Authorization: Bearer {your_api_key}

또한, 모든 요청에는 프로젝트 ID가 필요합니다.

이를 쿼리 파라미터에 포함하여 전송합니다.

?project_id=your_project_id

3. Open API 명세서

• timestamp 값으로 속성을 명시하는 경우, ISO 8601 표준에 맞게 전달해주세요.

  • 예) "2025-01-17T05:39:22Z", "2025-01-17T05:39:22+09:00"

Timestamp를 명시적으로 적는 경우, Timezone값에 유의하세요.

• bulk 요청 시, 한 번의 호출당 items에 1,000개 미만으로 요청해주세요.

• 연동 가능한 속성에 대한 자세한 설명은 카탈로그 속성에서 확인하세요.

Create or update product catalogs in bulk

post

Creates or updates multiple product catalog items.

Authorizations

BearerAuth

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Query parameters

project_idstringRequired

Project ID

Example: your_project_id

Body

application/json

Responses

200

Catalogs processed successfully.

400

Invalid request.

application/json

401

Unauthorized.

application/json

post

/v1/api/catalogs

HTTPcURLJavaScriptPython

POST /v1/api/catalogs?project_id=text HTTP/1.1
Host: event.marketap.io
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 148

{
  "items": [
    {
      "product_id": "ABC123",
      "properties": {
        "mkt_product_name": "티셔츠"
      }
    },
    {
      "product_id": "XYZ999",
      "properties": {
        "mkt_product_name": "바지"
      }
    }
  ]
}

No content

Request catalog item deletion

post

Triggers asynchronous deletion of a catalog product.

Authorizations

BearerAuth

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Query parameters

project_idstringRequired

Project ID

Example: your_project_id

Body

application/json

productIdstringRequiredExample: ABC12345

Responses

200

Catalog deletion job accepted.

400

Invalid request.

application/json

401

Unauthorized request.

application/json

post

/v1/api/catalogs/deletion-job

HTTPcURLJavaScriptPython

POST /v1/api/catalogs/deletion-job?project_id=text HTTP/1.1
Host: event.marketap.io
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 24

{
  "productId": "ABC12345"
}

No content