대상 이미지 속성 수정 | PUT /target/<target_id>

target_id에 해당하는 대상 이미지 속성을 수정합니다. Http patch 형식으로 매개변수를 변경하며, 변경되지 않은 매개변수는 유지됩니다.

액션

PUT /target/<target_id>

인증

필요함

HTTP 헤더

Content-Type=application/json

HTTP Header: Authorization (API Key Token 인증 방식 사용 시)

요청 매개변수

필드	유형	필수 여부	설명
image	String(base64)	예	JPG 및 PNG 형식 이미지를 지원하는 Base64 인코딩 문자열. 이미지 최대 2MB.
active	String	아니오	대상을 활성화하려면 "1", 비활성화하려면 "0". 기본값 "1"
name	String	예	대상 이름. 영문, 숫자, 영문 구두점만 허용. 길이 1~64자
size	String(Float)	예	인식 대상의 너비(cm). 높이는 업로드한 이미지에 따라 자동 계산됩니다. 인식 대상 크기는 가상 콘텐츠 크기와 대응됩니다. 기본값 20
meta	String	예	일반적으로 AR 콘텐츠 정보 저장용. 텍스트 문자열 형식, 기본값 "". 예: 인식 대상 JSON 정보, 이미지 base64 인코딩, 클라우드 저장소 파일 URL. 최대 2MB.
type	String(Float)	예	반드시 문자열 "ImageTarget"로 고정(대소문자 구분).
allowSimilar	String	아니오	유사 이미지 존재 시 강제 추가 허용 여부. 기본값 0. 유사 이미지는 인식에 영향을 줄 수 있으므로 기본값 권장.

참고

• image 최대 2MB 제한.
• meta 최대 2MB 제한.

요청 예시

    PUT /target/e61db301-e80f-4025-b822-9a00eb48d8d2 HTTP/1.1
    Host:
    Date: Mon, 1 Jan 2018 00:00:00 GMT
    Content-Type: application/json
    {
        "active":"1",
        "name":"easyar",
        "size":"5",
        "meta":"496fbbabc2b38ecs3460a...",
        "timestamp": 1514736000000,
        "appKey": "test_app_key",
        "signature": "89985e2420899196db5bdf16b3c2ed0922c0c221"
    }

응답 예시

    HTTP/1.1 200 OK
    Content-Type: application/json
    {
        "statusCode": 0,
        "result": {
          "target": {
            "targetId":"e61db301-e80f-4025-b822-9a00eb48d8d2",
            "trackingImage":"/9j/4AAQSkZJRgABAQAAAQABAAD/2wBDAAMCAgM..."，
            "name": "easyar",
            "size": "5",
            "meta": "496fbbabc2b38ecs3460a...",
            "type": "ImageTarget",
            "date": "2016-06-15T09:56:30.000Z",
            "active":"1",
            "trackableRate": 0,
            "detectableRate": 0,
            "detectableDistinctiveness"：0,
            "detectableFeatureCount": 0,
            "trackableDistinctiveness": 0,
            "trackableFeatureCount": 0,
            "trackableFeatureDistribution": 0,
            "trackablePatchContrast": 0,
            "trackablePatchAmbiguity": 0
          }
        },
        "timestamp": 1514736000000
    }

응답 필드

필드	설명
statusCode	0: 인증 성공. 자세한 코드는 상태 코드 참조
result	오류 메시지 또는 대상 이미지 정보
timestamp	서버 응답 시간(Unix 타임스탬프, 밀리초 단위)
result.targetId	대상 이미지 고유 ID
result.trackingImage	추적 이미지의 base64 인코딩 문자열
result.name	대상 이름
result.size	인식 대상 너비(cm). 높이는 이미지 비율에 따라 자동 계산됨
result.meta	추가 정보(예: JSON 문자열 base64 인코딩)
result.type	ImageTarget 고정
result.active	"1": 활성화, "0": 비활성화

오류 코드

참조: 상태 코드 및 오류 코드 목록