# 서버에서 카탈로그 데이터 연동 방법

## 사전 작업 <a href="#pre-work" id="pre-work"></a>

### 카탈로그 택소노미 확인 <a href="#taxonomy" id="taxonomy"></a>

데이터를 연동하기 전, 현재 프로젝트에서 어떤 상품 속성이 연동이 가능한지 확인해야 합니다. 아래 페이지에서 반드시  사용가능한 이벤트와 속성을 확인해주세요.

{% content-ref url="overview" %}
[overview](https://docs.marketap.io/t3ZS4WXNMj0HK27EtIMV/developer/catalog/overview)
{% endcontent-ref %}

{% hint style="danger" %}
Marketap은 **정의되지 않은 카탈로그 속성을 수집하지 않습니다**. 반드시 카탈로그 연동하기 전 프로젝트에 정의된 텍소노미를 확인해주세요.
{% endhint %}

## 1. 인증

서버로 데이터를 전송하는 경우, 인증 토큰을 함께 전달해야 합니다. 먼저 아래 페이지를 참고하여 유효한 토큰을 준비해주세요.

{% content-ref url="../open-api/authentication" %}
[authentication](https://docs.marketap.io/t3ZS4WXNMj0HK27EtIMV/developer/open-api/authentication)
{% endcontent-ref %}

## 2. 데이터 연동

### 2-1 상품 카탈로그 연동

마켓탭은 API를 통해 상품 카탈로그 정보를 업데이트할 수 있는 기능을 제공합니다.

{% content-ref url="../open-api/catalog" %}
[catalog](https://docs.marketap.io/t3ZS4WXNMj0HK27EtIMV/developer/open-api/catalog)
{% endcontent-ref %}

이 기능을 활용하여 연동을 완료한 후 기존 상품 데이터의 마이그레이션이 가능합니다.

## 3. 연동 결과 확인

서버에서 연동한 데이터도 마찬가지로 잘 반영이 되었는지 확인해야 합니다.&#x20;

설정 > 카탈로그 > 상품 카탈로그 에서 서버로 전달한 데이터가 마켓탭에 올바르게 반영되었는지 확인해주세요.

{% hint style="info" %}
연동된 카탈로그 데이터는 10분 이내로 반영됩니다.
{% endhint %}

<figure><img src="https://260547158-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FTQoY0rYrzNUQxhlUfYFm%2Fuploads%2FOpEI1XGfrpj33T8HcLMa%2F%E1%84%89%E1%85%B3%E1%84%8F%E1%85%B3%E1%84%85%E1%85%B5%E1%86%AB%E1%84%89%E1%85%A3%E1%86%BA%202026-03-05%20%E1%84%8B%E1%85%A9%E1%84%92%E1%85%AE%205.04.56.png?alt=media&#x26;token=e4090bd3-2164-4605-8be9-51365949ef12" alt=""><figcaption></figcaption></figure>