> For the complete documentation index, see [llms.txt](https://docs.archisketch.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.archisketch.com/guide/dev-kr/api-sdk/api-integration/3d-product-integration.md).

# 3D 상품 연동하기

Archisketch Open API를 연동하기 위한 전체 흐름입니다. 아래 순서대로 진행하세요.

## 1. x-api-key 발급

Archisketch 대시보드에 로그인한 후 API 키를 발급받습니다. 발급받은 `x-api-key`는 이후 모든 API 요청 헤더에 포함해야 합니다.

{% hint style="warning" %}
`x-api-key`는 외부에 노출되지 않도록 안전하게 보관하세요.
{% endhint %}

## 2. 모델링 등록

3D 모델 파일을 업로드하여 모델링을 생성합니다. 생성된 모델링 ID는 다음 단계에서 사용합니다.

{% content-ref url="/pages/w1ABpbjXhkHSmVC1d1K7" %}
[모델링 등록하기](/guide/dev-kr/api-sdk/api-integration/3d-product-integration/modeling.md)
{% endcontent-ref %}

## 3. 컴포넌트 등록

모델링을 기반으로 컴포넌트를 생성합니다. 생성된 컴포넌트 ID는 다음 단계에서 사용합니다.

{% content-ref url="/pages/jiDBj6GtgNkCvQpsp4AK" %}
[컴포넌트 등록하기](/guide/dev-kr/api-sdk/api-integration/3d-product-integration/component.md)
{% endcontent-ref %}

## 4. 파라메트릭 컴포넌트 등록 (선택)

치수·색상 등 파라미터를 동적으로 조합할 수 있는 파라메트릭 컴포넌트가 필요한 경우 진행합니다.

{% content-ref url="/pages/vsmN6rcmJQO12pSkaCVj" %}
[파라메트릭 컴포넌트 등록하기](/guide/dev-kr/api-sdk/api-integration/3d-product-integration/parametric.md)
{% endcontent-ref %}

## 5. 상품 등록

컴포넌트를 기반으로 판매 상품을 생성합니다.

{% content-ref url="/pages/9m6mTnEicpizWPZYVHzo" %}
[상품 등록하기](/guide/dev-kr/api-sdk/api-integration/3d-product-integration/product.md)
{% endcontent-ref %}