Version: 1.0.2
Last Updated: 19th Sep, 2024

시뮬레이터 화면 페이지 연동

사용하고자 하는 제품의 Moldwork simulator 연동
https://moldwork.net/mmpPlatform/postProc/{iamCode}/{groupID}/{productCode}/{viewSizeWidth}/{viewSizeHeight}


CALL PARAMETERS

Field Type Description
iamCode String Moldwork 플랫폼에 등록된 IAMCODE
productCode String Moldwork 플랫폼에 등록된 제품 코드 ID
groupID String 호출시 사용하실 고유ID 또는 호출시 사용할 그룹 ID
viewSizeWidth String (optional) Iframe 내 콘텐츠가 보여지는 영역 넓이 default : 100%
viewSizeHeight String (optional) Iframe 내 콘텐츠가 보여지는 영역 높이 default : 800px

사용예시 :
<iframe width="800" height="800" src="https://moldwork.net/mmpPlatform/postProc/moldwork/12312/samplecubeCode/800/800" id="productSimulator" title="productSimulator" frameborder="0" allowfullscreen>
사이즈 미지정 :
<iframe width="800" height="800" src="https://moldwork.net/mmpPlatform/postProc/moldwork/12312/samplecubeCode" id="productSimulator" title="productSimulator" frameborder="0" allowfullscreen>

시뮬레이터 뷰 페이지 연동 ( 후가공 결과만 )

생성된 후가공 제품의 Moldwork simulator 뷰
https://moldwork.net/mmpPlatform/postView/{iamCode}/{sessionID}/{productCode}/{viewSizeWidth}/{viewSizeHeight}


CALL PARAMETERS

Field Type Description
iamCode String Moldwork 플랫폼에 등록된 IAMCODE
sessionID String 시뮬레이터에서 후가공 정보 저장시 전달해 드린 SessionID
productCode String Moldwork 플랫폼에 등록된 제품 코드 ID
viewSizeWidth String (optional) Iframe 내 콘텐츠가 보여지는 영역 넓이 default : 100%
viewSizeHeight String (optional) Iframe 내 콘텐츠가 보여지는 영역 높이 default : 100%

사용예시 :
<iframe width="800" height="800" src="https://moldwork.net/mmpPlatform/postView/moldwork/group00001/product00001/800/800" id="productSimulator" title="productSimulator" frameborder="0" allowfullscreen>
사이즈 미지정 :
<iframe width="800" height="800" src="https://moldwork.net/mmpPlatform/postView/moldwork/group00001/product00001" id="productSimulator" title="productSimulator" frameborder="0" allowfullscreen>

후가공 결과 조회 ( Data )

저장된 후가공 제품의 정보 조회 ( Data )
https://moldwork.net/mmpPlatform/postSaveInfo/{iamCode}/{productCode}/{sessionID}


CALL PARAMETERS

Field Type Description
iamCode String Moldwork 플랫폼에 등록된 IAMCODE
productCode String Moldwork 플랫폼에 등록된 제품 코드 ID
sessionID String 시뮬레이터에서 후가공 정보 저장시 전달해 드린 SessionID

반환예시 ( JSON ) :

                                	
{
   "partsDataList":[
      {
         "imgURL":"b3a6abf14f3f4a5a8a007853aea81e74.png",
         "color":"",
         "subPartsURL":"",
         "subPartsMaterial":"",
         "subPartsColor":"",
         "materialID":"",
         "subPartsName":"",
         "objectName":"윗면",
         "objectID":"Image",
         "otherOption":[
            
         ]
      },
      {
         "imgURL":"",
         "color":"#FFFFFF",
         "subPartsURL":"",
         "subPartsMaterial":"",
         "subPartsColor":"",
         "materialID":"",
         "subPartsName":"",
         "objectName":"몸통",
         "objectID":"GripTok_Circle",
         "otherOption":[
            
         ]
      }
   ],
   "codeDetail":"success",
   "code":"success"
}

Return Code Meaning
code Query Status ( success or none )
codeDetail Detailed description of Query Status
Json Node Meaning
imgURL 각 파츠에 사용된 이미지 URI
color 각 파츠에 사용된 색상값
objectID 각 파츠의 고유 ID
materialID 각 파츠에 사용된 마테리얼 ( 재질 ) ID

썸네일 목록 단일 상품 조회 ( Data )

생성된 후가공 제품의 썸네일 목록 조회
https://moldwork.net/mmpPlatform/getThumnailListBySessionID/{iamCode}/{sessionID}


CALL PARAMETERS

Field Type Description
iamCode String Moldwork 플랫폼에 등록된 IAMCODE
sessionID String 시뮬레이터에서 후가공 정보 저장시 전달해 드린 SessionID

반환예시 ( JSON ) :

                
{
   "codeDetail":"success",
   "code":"success",
   "thumnailList":[
      {
         "savefileName":"b00b8d70534f405a881ab378d2c4e1bf.jpg",
         "thumnailDirection":"forward",
         "sessionID":"cefd6fd2-1d7e-4e1d-955f-23e45c9c02ba",
         "savefileNameOrigin":"Capture_foward.jpg",
         "createDate":"2024-02-23 오후 01:31"
      }
   ]
}

Return Code Meaning
code Query Status ( success or none )
codeDetail Detailed description of Query Status
Json Node Meaning
savefileName 생성된 썸네일 파일의 URI
savefileNameOrigin 생성된 썸네일 파일의 원본 파일명
thumnailDirection 썸네일 고유명
( 'forward' : 앞면, 'back' : 뒷면, 'up' : 위면, 'down' : 아랫면, 'left' : 왼쪽면, 'right' : 오른쪽면 )
createDate 썸네일 생성 일자

썸네일 목록 그룹 상품 조회 ( Data )

생성된 후가공 제품의 그룹 썸네일 목록 조회
https://moldwork.net/mmpPlatform/getThumnailListByGroupID/{iamCode}/{groupID}


CALL PARAMETERS

Field Type Description
iamCode String Moldwork 플랫폼에 등록된 IAMCODE
groupID String 시뮬레이터 호출시 사용된 groupID

반환예시 ( JSON ) :

                
{
   "codeDetail":"success",
   "code":"success",
   "thumnailList":[
      {
         "sessionID":"95fc2229-3909-48dd-a51f-fe8de7f90624",
         "fileList":[
            {
               "savefileName":"Capture_forward.jpg",
               "thumnailDirection":"forward",
               "savefileNameOrigin":"Capture_forward.jpg"
            }
         ],
         "createDate":"2024-02-23 오전 11:04"
      },
      {
         "sessionID":"d2385e1f-14f7-4476-8eaf-19a3ac13c848",
         "fileList":[
            {
               "savefileName":"Capture_forward.jpg",
               "thumnailDirection":"forward",
               "savefileNameOrigin":"Capture_forward.jpg"
            },
            {
               "savefileName":"Capture_forward.jpg",
               "thumnailDirection":"forward",
               "savefileNameOrigin":"Capture_forward.jpg"
            }
         ],
         "createDate":"2024-02-22 오후 02:40"
      }
   ]
}

Return Code Meaning
code Query Status ( success or none )
codeDetail Detailed description of Query Status
Json Node Meaning
sessionID 후가공 정보 저장시 생성된 sessionID
savefileName 그룹 내 생성된 썸네일 파일의 URI
savefileNameOrigin 그룹 내 생성된 썸네일 파일의 원본 파일명
thumnailDirection 썸네일 고유명
( 'forward' : 앞면, 'back' : 뒷면, 'up' : 위면, 'down' : 아랫면, 'left' : 왼쪽면, 'right' : 오른쪽면 )
createDate 썸네일 생성 일자

제품별 컬러셋 ( Data )

제품별 설정된 색상 정보 목록 조회
https://moldwork.net/mmpPlatform/getColorSetListByProductCode/{iamCode}/{productCode}


CALL PARAMETERS

Field Type Description
iamCode String Moldwork 플랫폼에 등록된 IAMCODE
productCode String 플랫폼에 등록된 제품 코드 ( productCode )

반환예시 ( JSON ) :

                
{
   "code":"success",
   "codeDetail":"success",
   "colorSetInfo":[
      {
         "objectName":"앞면",
         "objectID":"Front",
         "colorSetList":[
            {
               "colorSetName":"빨강",
               "colorSetHexCode":"#FF0000"
            },
            {
               "colorSetName":" 초록",
               "colorSetHexCode":"#008000"
            },
            {
               "colorSetName":" 파랑",
               "colorSetHexCode":"#0000FF"
            }
         ]
      }
   ]
}

Return Code Meaning
code Query Status ( success or none )
codeDetail Detailed description of Query Status
Json Node Meaning
objectName 제품 후가공 메뉴 ( 3D 모델의 파츠명 )
objectID 3D 모델의 파츠 ID
colorSetName 컬러명
colorSetHexCode 컬러명에 해당하는 HexCode

썸네일 제품 정보 ( Data )

생성된 후가공 제품의 썸네일과 등록된 제품 정보 조회
https://moldwork.net/mmpPlatform/getThumnailListBySessionIDWidthProductInfo/{iamCode}/{groupID}


CALL PARAMETERS

Field Type Description
iamCode String Moldwork 플랫폼에 등록된 IAMCODE
groupID String 시뮬레이터 호출시 사용된 groupID

반환예시 ( JSON ) :

                
{
  "codeDetail": "success",
  "code": "success",
  "thumnailList": [
    {
      "savefileName": "f3f3dafdasdfasdf.jpg",
      "productCode": "productCode0001",
      "uuid": "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
      "productName": "제품00001"
    }
  ]

Return Code Meaning
code Query Status ( success or none )
codeDetail Detailed description of Query Status
Json Node Meaning
savefileName 후가공 정보 저장시 생성된 썸네일 파일 URI
productCode 제품 코드
uuid 제품 고유 코드
productName 제품 명

제품별 서브 파츠 정보 ( Data )

제품별 설정된 서브 파츠별 색상 정보 목록 조회
https://moldwork.net/mmpPlatform/getSubPartsListByProductCode/{iamCode}/{productCode}


CALL PARAMETERS

Field Type Description
iamCode String Moldwork 플랫폼에 등록된 IAMCODE
productCode String 플랫폼에 등록된 제품 코드 ( productCode )
partsID String 플랫폼에 등록된 제품 파츠ID ( partsID )
여러개 조회시 쉼표 (,)로 구분하여 요청
예) subParsIDNo1,subParsIDNo2

반환예시 ( JSON ) :

                

{
  "partsSetInfo": [
    {
      "colorSetList": [
        {
          "colorSetName": "니켈",
          "colorSetHexCode": "#B5B5B5"
        },
        {
          "colorSetName": "골드",
          "colorSetHexCode": "#E0B43D"
        }
      ],
      "partsID": "subParsIDNo1",
      "partsThumnailImage": "subParsIDNo1.jpg",
      "partsName": "서브파츠 #1"
    },
    {
      "colorSetList": [
        {
          "colorSetName": "흑니켈",
          "colorSetHexCode": "#E0B4FF"
        }
      ],
      "partsID": "subParsIDNo2",
      "partsThumnailImage": "subParsIDNo2.png",
      "partsName": "서브파츠 #2"
    }
  ],
  "codeDetail": "success",
  "code": "success"
}

Return Code Meaning
code Query Status ( success or none )
codeDetail Detailed description of Query Status
Json Node Meaning
objectName 제품 후가공 메뉴 ( 3D 모델의 파츠명 )
partsID 3D 모델의 서브 파츠 ID
colorSetName 컬러명
colorSetHexCode 컬러명에 해당하는 HexCode

제품별 서브 파츠별 정보 ( Data )

제품별 설정된 서브 파츠별 색상 정보 목록 조회
https://moldwork.net/mmpPlatform/getSubPartsColorSetListByPartsID/{iamCode}/{productCode}/{partsID}


CALL PARAMETERS

Field Type Description
iamCode String Moldwork 플랫폼에 등록된 IAMCODE
productCode String 플랫폼에 등록된 제품 코드 ( productCode )
partsID String 플랫폼에 등록된 제품 파츠ID ( partsID )
여러개 조회시 쉼표 (,)로 구분하여 요청
예) subParsIDNo1,subParsIDNo2

반환예시 ( JSON ) :

                

{
  "partsSetInfo": [
    {
      "colorSetList": [
        {
          "colorSetName": "니켈",
          "colorSetHexCode": "#B5B5B5"
        },
        {
          "colorSetName": "골드",
          "colorSetHexCode": "#E0B43D"
        }
      ],
      "partsID": "subParsIDNo1",
      "partsThumnailImage": "subParsIDNo1.jpg",
      "partsName": "서브파츠 #1"
    },
    {
      "colorSetList": [
        {
          "colorSetName": "흑니켈",
          "colorSetHexCode": "#E0B4FF"
        }
      ],
      "partsID": "subParsIDNo2",
      "partsThumnailImage": "subParsIDNo2.png",
      "partsName": "서브파츠 #2"
    }
  ],
  "codeDetail": "success",
  "code": "success"
}

Return Code Meaning
code Query Status ( success or none )
codeDetail Detailed description of Query Status
Json Node Meaning
objectName 제품 후가공 메뉴 ( 3D 모델의 파츠명 )
partsID 3D 모델의 서브 파츠 ID
colorSetName 컬러명
colorSetHexCode 컬러명에 해당하는 HexCode

후가공 정보 전송 ( 이기종간 DATA 전송 )

생성된 후가공 정보를 다른 서버에 저장 / 처리 시
* 스펙에 따른 사전 협의 필요


전송 예시 ( JSON ) :

                
{
   "sessionID" : "c17cdcca-df78-11ee-89d2-6c0b84f0fe76" ,
   "groupID" : "1095d24e-df7a-11ee-89d2-6c0b84f0fe76" ,
   "productCode" : "samplecubeCode" ,   
   "productName" : "테스트 제품" ,
   "thumnailimgURL": [ 
				{ 
				  "URL" : "87d8748b-e685-11ee-89d2-6c0b84f0fe76.jpg" ,
				  "direction" : "forward"  
				},
				{ 
				  "URL" : "8dea874b-e685-11ee-89d2-6c0b84f0fe76.jpg" ,
				  "direction" : "left"  
				},
		   ],
   "originalImageURL": [ 
				{ 
				  "fileUrl" : "c17cdcca-df78-11ee-89d2-6c0b84f0fe76.jpg" ,
				  "objectID" : "Image"  
				}
		   ],
 "parts":[
      {
         "imageURL":"ab13fc4c-e685-11ee-89d2-6c0b84f0fe76.jpg",	  	  
         "color":"",
         "subPartsURL":"",
         "subPartsMaterial":"",
         "subPartsColor":"",
         "materialID":"",
         "subPartsName":"",
         "objectID":"Image",
         "objectName":"이미지",
         "otherOption":[
            
         ]
      },
      {
         "imageURL":"",
         "color":"#FFFFFF",
         "subPartsURL":"",
         "subPartsMaterial":"",
         "subPartsColor":"",
         "materialID":"",
         "subPartsName":"",
         "objectID":"BODY",
         "objectName":"바디",
         "otherOption":[
            
         ]
      }
   ]
}

Json Node Meaning
sessionID 시뮬레이터 호출시 생성된 Moldwork 플랫폼 고유 값
productCode 시뮬레이터 제품 코드
productName 시뮬레이터 제품명
groupID 시뮬레이터 호출시 넘겨주신 고유 값
thumnailimgURL ( array ) 생성된 썸네일 이미지 내역
Json Node Meaning
URL AWS 업로된 파일명
direction 썸네일 생성 시 카메라 위치 ( 제품 기준 썸네일 추출 방향 )
originalImageURL ( array ) 시뮬레이터에서 사용된 원본 이미지 내역
Json Node Meaning
fileUrl AWS 업로된 원본 파일명
objectID 이미지가 업로드된 모델 파츠 ID ( 후가공 메뉴 )
imageURL 각 파츠에 사용된 이미지 URI ( 시뮬레이터에서 사용한 가공 이미지 )
color 각 파츠에 사용된 색상값
objectID 각 파츠의 고유 ID ( 후가공 메뉴 ID )
objectName 각 파츠 이픔 ( 후가공 메뉴 )
materialID 각 파츠에 사용된 마테리얼 ( 재질 ) ID

후가공 정보 저장 함수 ( 별도의 UI 로 처리시 )

제공되는 IFRAME 이 아닌 별도의 UI 요소로 처리하길 원할 경우

Function Name Meaning
saveAndRun IFRAME 내 후가공 정보를 저장하기 위한 JavaScript Function Name

예시 )
<iframe width="800" height="800" src="https://moldwork.net/postProc/triple/group00001/product00001/800/800" id="productSimulator" title="productSimulator" frameborder="0" allowfullscreen>
위와 같이 IFRAME 호출일 경우

IFRAME 내 javascript 호출
productSimulator.saveAndRun();
or
productSimulator.saveAndRun( callbackFunction, arg1 , arg2, arg3 );
//부모 페이지 내에 callbackFunction 정의 필요

Errors

API uses the following error codes:

Error Code Meaning
X000 Some parameters are missing. This error appears when you don't pass every mandatory parameters.
X001 Unknown or unvalid IAMCODE. This error appears if you use an unknow API key or if your API key expired.
X002 Unknown or unvalid user token. This error appears if you use an unknow user token or if the user token expired.