Table of Contents

새로운 이미지 타겟 생성 | POST /targets

인식 이미지를 업로드하여 새로운 이미지 타겟 생성

Action

POST /targets

인증

필요

HTTP 헤더

Content-Type=application/json

HTTP 헤더: Authorization (API 키 토큰 인증 방식 사용 시)

요청 파라미터

필드 유형 필수 설명
image String(base64) 예 JPG 및 PNG 형식 이미지의 base64 인코딩 문자열. 최대 2MB.
active String 아니오 "1": 타겟 활성화, "0": 타겟 비활성화. 기본값 "1".
name String 예 영문 알파벳, 숫자, 영문 구두점만 허용. 길이 1~64자.
size String(Float) 예 인식 이미지 너비(cm). 높이는 시스템이 자동 계산. 가상 콘텐츠 크기와 연동. 기본값 20.
meta String 예 AR 콘텐츠 정보 저장용 문자열. 기본값 "". 최대 2MB.
type String 예 반드시 "ImageTarget"으로 고정 (대소문자 구분).
allowSimilar String 아니오 유사 이미지 존재 시 강제 추가 허용. 기본값 0. 권장값 유지.
참고
  • image: 최대 2MB
  • meta: 최대 2MB

요청 예시

    POST /targets/ HTTP/1.1
    Host:
    Date: Mon, 1 Jan 2018 00:00:00 GMT
    Content-Type: application/json
    {
        "image":"/9j/4AAQSkZJRgABAQAAAQABAAD/2wBDAAMCAgM...",
        "active":"1",
        "name":"easyar",
        "size":"5",
        "meta":"496fbbabc2b38ecs3460a...",
        "type":"ImageTarget",
        "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",
            "modified":1514735000000,
            "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 base64 인코딩된 추가 정보 (예: JSON 문자열 인코딩)
result.type "ImageTarget" 고정
result.active "1": 활성화, "0": 비활성화

오류 코드

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

메타 사용 설명

  • 동영상 URL 연동
    • meta 필드에 타겟별 연동 동영상 URL 저장 가능
    • 예: https://my_server/my_videos/my_video_001.mp4
    • 애플리케이션에서 타겟 인식 시 meta의 URL로 동영상 다운로드 및 재생
  • 3D 모델 연동
    • meta 필드에 타겟별 3D 모델/Unity 리소스 저장
    • base64 인코딩 또는 모델 URL 저장 가능
    • 타겟 인식 시 3D 모델 렌더링 구현