{"pageKey":"Developers","slug":"developers-api-integrations","locale":"ko","localeResolved":"ko","fallbackApplied":false,"version":"developers-api-integrations@2026-11-19T13:03:03.147Z","lastModified":null,"canonicalUrl":"https://www.merchandaise.com/ko/developers/api-integrations","payload":{"slug":"developers-api-integrations","purpose":"llm-developers-api-integrations","title":"상품 API 문서 및 OpenAPI 통합 | MerchandAise","description":"맞춤형 상품, 커뮤니티 삽입, 공급업체 워크플로 및 기업 ID에 대한 MerchandAise API 문서 및 OpenAPI 사양을 살펴보세요.","sections":[{"heading":"프로젝트에 필요한 연결을 선택하세요","paragraphs":["아래 참조를 사용하여 엔드포인트, 요청 형식 및 승인 요구 사항을 평가하세요. 공개 사양은 계획 및 클라이언트 생성을 지원합니다. 운영 액세스는 API, 계정 및 환경에 따라 다릅니다.","MerchandAise이 구매자 거래를 처리하는 경우 Hutter Products GmbH은 MerchandAise 브랜드의 계약 판매자이자 등록된 판매자입니다. 공급업체 신원 및 연락처 세부 정보는 공개가 필요한 경우를 제외하고는 비공개로 유지되며 생산에는 여전히 디지털 증명 승인, 생산성 확인, 필수 기술 점검 및 정확한 승인 주문에 적용되는 샘플 승인이 필요합니다."]},{"heading":"API 및 통합 표면","items":[{"title":"API 문서 및 OpenAPI","description":"보조 도구 및 설계 세션에 대한 API 참조를 찾은 다음 워크플로에 맞는 커뮤니티, 공급업체 또는 기업 계약을 선택하세요. 구현 가이드: 보조 도구 문서 읽기 (/api/docs). 기계 계약: 보조 도구 OpenAPI JSON (/api/docs/openapi.json). 액세스: 공개. 보조자 및 도구 API에 대한 공개 참조입니다. 생산 접근 및 주문에 영향을 미치는 작업에는 여전히 해당 승인이 필요합니다. 표준 페이지: /ko/developers/api-integrations. 정식 섹션: /ko/developers/api-integrations#api-docs."},{"title":"커뮤니티 API","description":"클럽이나 커뮤니티 웹사이트를 공개 커뮤니티 정보, 디자인 제출, 투표 및 승인 전달 명령에 연결하세요. 계약 내용: 공개 커뮤니티 컨텍스트, 디자인 게시물 및 투표, 목록 게시, 보류 중인 주문, 커뮤니티 소유자 승인 또는 거부. 실용적인 출발점: 클럽 웹사이트의 공개 커뮤니티 내용을 읽어보세요. 그런 다음 디자인 제출 또는 결제 전달을 추가하기 전에 어떤 작업에 회원 세션이나 소유자 권한이 필요한지 매핑하세요. 액세스: 사양은 공개되어 있습니다. 공개 읽기, 회원 작업 및 소유자 전용 작업에는 인증 요구 사항이 다릅니다. 각 끝점에서 보안 규칙을 사용하십시오. 구현 가이드: 커뮤니티 API 살펴보기 (/ko/developers/api-integrations#community-integrations). 기계 계약: 커뮤니티 OpenAPI JSON (/api/v1/community/public/openapi/v1). 액세스: 공개. 매장 임베드, 커뮤니티 검색 및 로케일 인식 핸드오프를 위한 공개 버전의 계약입니다. 표준 페이지: /ko/developers/api-integrations. 정식 섹션: /ko/developers/api-integrations#community-integrations."},{"title":"공급자 API","description":"승인된 공급업체 시스템을 출시된 생산 패키지, 온보딩 상태, ERP 또는 PLM 웹훅 워크플로에 연결하세요. 계약 내용: 공급업체 온보딩 상태, 출시된 프로덕션 패키지, 감사된 아티팩트 다운로드, 분석, 웹훅 구독 및 동기화 체크포인트. 실용적인 출발점: ERP 또는 제품 수명주기 관리 시스템과 공급업체 센터 간의 연결을 계획하세요. 할당된 주문을 처리하기 전에 웹훅 페이로드, 재시도 및 동기화 상태를 검토하세요. 액세스: 로그인하지 않고 OpenAPI 사양을 읽어보세요. 운영 요청에는 적절한 공급업체 계정과 권한이 필요합니다. 공개 문서는 공급업체를 등록하거나 다른 공급업체의 데이터에 대한 액세스 권한을 부여하지 않습니다. 구현 가이드: 공급업체 API 살펴보기 (/ko/developers/api-integrations#supplier-integrations). 기계 계약: 공급업체 OpenAPI JSON (/api/v1/supplier/openapi/v1). 액세스: 공개. 기획 및 고객 창출을 위한 공개 계약. 운영 공급업체에 대한 액세스는 계속 허용됩니다. 표준 페이지: /ko/developers/api-integrations. 정식 섹션: /ko/developers/api-integrations#supplier-integrations."},{"title":"엔터프라이즈 ID API","description":"승인된 회사 작업 공간을 Single Sign-On, 사용자 및 그룹 프로비저닝, ID 감사 기록에 연결하세요. 계약 내용: OpenID Connect(OIDC) Single Sign-On, SCIM 사용자 및 그룹 수명 주기 작업, SCIM 토큰 순환 및 프로비저닝 감사 이벤트입니다. 실용적인 출발점: ID 공급자를 승인된 작업 공간에 매핑하세요. 로그인, 사용자 프로비저닝 및 프로비저닝 해제를 계획한 다음 합의된 테스트 환경에서 그룹 매핑 및 감사 기록을 확인하세요. 액세스: 엔터프라이즈 ID 사양이 보호됩니다. 구현하기 전에 통합 팀에 문의하여 작업 공간 및 액세스 요구 사항을 검토하세요. 일반 제품 구매 시 기업 ID는 선택 사항입니다. 구현 가이드: 기업 아이덴티티 살펴보기 (/ko/developers/api-integrations#enterprise-integrations). 기계 계약: 엔터프라이즈 ID OpenAPI JSON (/api/v1/enterprise/identity/openapi/v1). 액세스: 보호됨. 승인된 기업 업무 공간에 대한 보호 계약 이 엔드포인트를 사용하기 전에 액세스를 요청하세요. 표준 페이지: /ko/developers/api-integrations. 정식 섹션: /ko/developers/api-integrations#enterprise-integrations."}]},{"heading":"코드 이전에 계약을 선택하세요","items":[{"title":"단계 1: 사용자 여정 지도","description":"워크플로우에 누가 들어갈지, 어디에 들어갈지 결정하십시오: 내장된 상점의 구매자, 승인된 공급업체, 기업 사용자 또는 명시적인 권한을 가지고 운영하는 보조자."},{"title":"단계 2: 접근 경계 확인","description":"평가 및 클라이언트 생성을 위해 공개 계약을 사용한 다음 구현 전에 자격 증명, 범위, 환경, 콜백 및 보호된 엔드포인트를 확인하세요."},{"title":"단계 3: 상태 연속성 증명","description":"재시도 및 롤백 경로를 포함하여 통합 전반에 걸쳐 설계, 견적, 승인, 오류 및 주문 전달이 최신 버전으로 유지되는지 테스트합니다."}]},{"heading":"모든 통합이 보존해야 할 것","items":[{"title":"버전이 지정된 상태 1개","description":"디자인, 상거래 의도, 공급업체가 지원하는 견적, 승인 및 주문 상태가 계속 연결됩니다. 오래된 변경 사항은 눈에 보이는 재인용 또는 검토 상태를 트리거해야 합니다."},{"title":"상업 및 공급업체 개인정보 보호","description":"MerchandAise은 여전히 구매자 측 판매자이자 지원 소유자입니다. 공급업체 신원, 연락처 및 내부 데이터는 공개 통합을 통해 노출되지 않습니다."},{"title":"생산 전 승인","description":"3D 뷰는 물리적 증거가 아닙니다. 확인된 견적에는 고객이 선택할 수 있는 샘플 선택 사항, 비용, 제한 사항 및 시기가 설명되어 있습니다. 대량 생산 전에 정확한 디지털 증명을 승인하고 필수 기술 점검을 완료하며 필수 또는 선택된 샘플 승인을 완료하세요. 기존 승인된 주문 요구 사항은 여전히 ​​구속력을 갖습니다."}]},{"heading":"프로덕션 트래픽 전","paragraphs":["게시된 OpenAPI 파일은 익명의 프로덕션 액세스를 약속하는 것이 아니라 계획을 위한 표면입니다. 우리는 실행하기 전에 환경, 자격 증명, 오류 처리 및 운영 소유권을 검토합니다."],"items":[{"title":"액세스 및 환경","description":"계약 버전, 승인된 작업 공간, 인증 범위, 샌드박스, 프로덕션 자격 증명, 콜백 대상을 확인하세요."},{"title":"실패와 회복","description":"릴리스 전 재시도, 멱등성, 시간 초과, 고객에게 표시되는 오류, 관찰 가능성, 지원 소유권 및 롤백을 정의합니다."},{"title":"엔드투엔드 증거","description":"견적, 승인, 핸드오프 및 복구 동작을 통해 진입 및 상태 변이 단계에서 의도한 여정을 확인합니다."}]},{"heading":"FAQ","items":[{"title":"어떤 상품 API부터 시작해야 하나요?","description":"사람과 상태 전환부터 시작하세요. 구매자 대면 클럽 또는 커뮤니티 여정을 위한 커뮤니티 임베드, 승인된 공급측 워크플로를 위한 공급업체 운영, SSO 및 SCIM을 위한 기업 ID, 명시적으로 승인된 AI 주도 흐름을 위한 보조 도구만 사용하세요."},{"title":"공개 계약은 공개 프로덕션 액세스를 의미합니까?","description":"아니요. 공개 OpenAPI 계약은 검색, 아키텍처 검토 및 클라이언트 생성을 지원합니다. 프로덕션 자격 증명, 쓰기 작업, 공급업체 워크플로, 기업 ID 및 보조 실행에는 여전히 승인된 작업 영역 및 범위 권한 부여가 필요할 수 있습니다."},{"title":"통합으로 인해 공급업체가 노출되거나 승인을 우회할 수 있나요?","description":"아니요. 공개가 필요한 경우를 제외하고 공급업체 신원 및 연락처 세부 정보는 비공개로 유지됩니다. MerchandAise은 구매자 관계를 소유하고 주문에 영향을 미치는 조치는 구성된 디지털 증명, 기술 및 주문별 샘플 승인 요구 사항을 유지해야 합니다."}]},{"heading":"우리와의 통합을 계획하세요.","paragraphs":["통합을 사용할 사람, 읽거나 변경해야 하는 상태, 경험이 어디에 있을 것인지 알려주세요. 계약, 액세스 모델, 가장 안전한 출시 경로를 귀하와 함께 지도해 드리겠습니다."],"items":[{"title":"통합 계획","description":"/ko/contact?intent=api-integration-review"},{"title":"AI 에이전트 및 MCP 살펴보기","description":"/ko/developers/ai-agents-mcp"}]}],"source":{"type":"page-copy","id":"Developers"}},"metadata":{"source":"route-owned-source","schema":"2025-11-05"}}