오류 정보

오류 정보 | Error

OMNIOUS LENS API 이용 시 발생하는 에러는 다음과 같습니다. 한 번에 두 개 이상의 상품 정보 입력 시, 하나의 항목이라도 에러가 있는 경우 전체를 에러로 간주합니다.

Code	Message(EN)	설명
609	Authentication failed. Make sure the API key is correct or you have the correct permissions.	API KEY가 잘못 입력되었거나 권한이 없는 경우 발생.
612	An API key is required. Please check X-API-KEY header.	X-API-KEY 헤더 값을 입력하지 않은 경우 발생.
623	Invalid access. Make sure the URI and method (POST, GET) are correct.	존재하지 않은 resource 또는 Method를 호출하는 경우 발생. 호출한 API의 URL과 Method (POST, GET) 이 롤바른지 확인 필요.
801	This image content should remove base64 header.	base64 헤더 없음
802	Fail to prove base64 image.	base64 image 가져오기 실패
803	Fail to prove image from url.	url image 가져오기 실패
804	The 'image.type' field value 'url, base64' does not match any of the allowed values!	image type이 url,base64가 아님
805	This image format is not supported.	image format 지원안함 (지원하는 image format:BMP, GIF, JPEG, PNG, TIFF, WEBP)
903	Can’t find ‘id’ field	id 필드가 없는 경우
904	Can’t find ‘url’ field.	url 필드가 없는 경우
905	Can’t find ‘image’ field.	image 필드가 없는 경우
906	Can’t find ‘image.detection’ field.	image 필드 내 detection 필드가 없는 경우
907	Can’t find ‘image.content’ field.	image 필드 내 content 필드가 없는 경우
908	‘id’ field is empty.	id가 빈 값인 경우
909	‘url’ field is empty.	url이 빈 값인 경우
911	‘image.content’ field is empty.	image 필드 내 content가 빈 값인 경우
912	Can’t find ‘ids’ field.	ids 필드가 없는 경우
913	Invalid weightColorFeature field values: 'asdf'. Allowed values: ['HIGH', ‘MEDIUM’, ‘LOW’]	지원하지 않는 weightColorFeature 옵션에 대한 에러 처리 (지원하는 field 값: 'HIGH', 'MEDIUM', 'LOW', Default: 'MEDIUM')
914	Invalid json format.	REST API, POST body의 json format이 유효하지 않은 경우
915	Invalid query action params: ‘asdf'. Allowed values: [UPDATE, DELETE]	현재 정의된 query action parameter 값이 유효하지 않은 경우 (현재 update, delete만 사용)
916	Unknown Metadata Field: {입력 필드}	metadata update 시 미리 정의되지 않은 field가 들어오는 경우
917	Invalid Metadata Field type: {입력 필드 타입 } Allowed value: {미리 정의된 필드 타입 }	metadata update시 잘못된 field type이 들어올 경우

Example. 에러 코드 반환

에러 발생 시 아래 예시와 같이 error.code 값을 반환합니다.

{
    "data": {},
    "error": {
        "message": "’url’ field is empty.",
        "code": 909
    },
    "status": "fail"
}

Example. 하나의 항목에 에러가 있는 경우

POST /?action=update 호출 시 두 번째 상품 정보에서 id field가 없는 경우 → 전체 Error로 간주합니다.

{
  "products": [
    {
      "id": "AT000123FB",
      "url": "http://asdfmall/product?id=AT00123FB",
      "image": {
        "detection": "TOP",
        "content": "http://some/image.jpg"
      },
      "context": {
        "name": "집업 후드",
        "gender": "MAN",
        "brand": "GAP",
        "price": {
          "currency": "KRW",
          "value": 12000,
          "discounted": 9900
        }
      }
    },
     {
      "url": "http://asdfmall/product?id=A200123FB",
      "image": {
        "detection": "TOP",
        "content": "http://some/image.jpg"
      },
      "context": {
        "name": "집업 후드",
        "gender": "MAN",
        "brand": "GAP",
        "price": {
          "currency": "KRW",
          "value": 12000,
          "discounted": 9900
        }
      }
    }
  ]
}