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