Target images 삭제

EasyAR는 더 이상 필요하지 않은 recognition images를 처리하는 두 가지 방법인 영구 삭제와 임시 비활성화를 제공합니다. production 환경의 안정성을 보장하려면 다음 작업 설명을 주의 깊게 읽는 것이 좋습니다.

EasyAR Web management center에서 작업

작업 단계: EasyAR Developer Center에 로그인 -> Cloud Recognition Management -> 해당 gallery 선택 -> Manage 클릭하여 gallery 관리 페이지로 이동합니다.
삭제 방법:
- Batch deletion: 목록에서 target images를 선택하고 Delete를 클릭한 뒤 확인합니다.
- Single deletion: target image 상세 페이지로 들어가 페이지 안의 Delete 버튼을 클릭합니다.

삭제 작업 가이드

경고

삭제 작업은 되돌릴 수 없습니다. 삭제를 확인하면 해당 이미지의 모든 feature data 및 관련 정보가 영구적으로 손실됩니다. 먼저 test gallery에서 과정을 검증하는 것이 좋으며, production 환경에서 직접 destructive testing을 수행하는 것은 엄격히 금지됩니다.

Best practice: target images 비활성화

대부분의 비즈니스 시나리오에서 특정 이미지를 향후 다시 사용할지 확실하지 않다면 deletion 대신 deactivation을 사용하는 것이 좋습니다.

기능 특성: 비활성화된 target image는 database 목록에 남아 있지만 cloud recognition 검색 과정에는 참여하지 않습니다. 다만 recognition quota는 차지합니다.
Deactivation 방법: 관리 페이지에서 recognition image를 선택하고 Deactivate를 클릭합니다.

Deactivation 작업 가이드

API deactivation: Update target image API를 호출하고 active 속성을 0으로 설정합니다.

API를 사용해 target images 삭제

REST API를 통해 recognition images를 자동으로 정리할 수 있습니다.

준비

시작하기 전에 Delete target image API documentation을 읽고 다음 리소스를 준비하십시오.

CRS AppId
API Key / Secret 또는 Token
Server-end URL (443 포트)
TargetId: 삭제할 target image의 고유 ID입니다. TargetId가 없으면 API는 statusCode: 404 (Target not found)를 반환합니다.

플레이스홀더를 실제 매개변수로 바꾸고 curl 스크립트를 실행하십시오

Your-Server-side-URL → 실제 API Host
Your-Token → 실제 API Key Authorization Token
Your-CRS-AppId → 사용자의 appId
Your-todo-TargetId → 삭제할 target의 targetId

curl -X DELETE "https://<Your Server-side-URL>/target/<Your-todo-TargetId>?appId=<Your-CRS-AppId>" \
  -H "Content-Type: application/json" \
  -H "Authorization: <Your-Token>"

Java 샘플 코드 다운로드

Java Samples Download

Maven 방식으로 프로젝트 가져오기

Step 1. 관련 코드 파일 RemoveTarget.java를 엽니다

Step 2. 전역 변수를 수정하고 preparation checklist의 authentication parameters로 교체합니다

CRS AppId
API Key / API Secret
TARGET_MGMT_URL -> Server-end URL
TARGET_ID -> 삭제할 target의 targetId

public class RemoveTarget {

    private static final String TARGET_MGMT_URL = "https://cn1.crs.easyar.com";
    private static final String CRS_APPID       = "--here is your CRS AppId--";
    private static final String API_KEY         = "--here is your API Key--";
    private static final String API_SECRET      = "--here is your API Secret--";
    private static final String TARGET_ID       = "my_targetid";
    /* TO_DEL_IDs lists all the targetIds to be removed
     * must be separated by ","
     */
    private static final String TO_DEL_IDs = "targetId1,targetId2,targetId3";

    public String remove(Auth auth, String targetId) throws IOException {
        okhttp3.Request request = new okhttp3.Request.Builder()
                .url(auth.getCloudURL()+"/target/"+targetId+"?"+ Common.toParam(
                        Auth.signParam(new JSONObject(), auth.getAppId(), auth.getApiKey(), auth.getApiSecret())
                ))
                .delete()
                .build();
        return new OkHttpClient.Builder().build().newCall(request).execute().body().string();
    }

    public String removeMultiTargets(Auth auth, String targetIds) throws IOException {
        JSONObject params = new JSONObject().put("targetId", targetIds);
        Auth.signParam(params, auth.getAppId(), auth.getApiKey(), auth.getApiSecret());
        RequestBody requestBody = FormBody.create(MediaType.parse("application/json; charset=utf-8")
                , params.toString());
        okhttp3.Request request = new okhttp3.Request.Builder()
                .url(auth.getCloudURL() + "/targets")
                .delete(requestBody)
                .build();
        return new OkHttpClient.Builder().build().newCall(request).execute().body().string();
    }
    public static void main(String[] args) throws IOException{
        Auth accessInfo  =  new Auth(CRS_APPID, API_KEY, API_SECRET, TARGET_MGMT_URL);
        System.out.println(new RemoveTarget().remove(accessInfo, TARGET_ID));
        System.out.println(new RemoveTarget().removeMultiTargets(accessInfo, TO_DEL_IDs));
    }
}

Step 3. Main 실행

NodeJS sample 코드를 다운로드합니다

NodeJS Samples Download

Step 1. 키 파일 keys.json 설정

CRS AppId
API Key / API Secret
to-delete-targetId

{
  "appId": "--here is your appId for CRS App Instance for SDK 4--",
  "apiKey": "--here is your api key which is create from website and which has crs permission--",
  "apiSecret": "--here is your api secret which is create from website--"
}

Step 2. 실행하고 키 파일 및 Server-end URL 지정

node bin/deleteTarget <to-delete-targetId> -t <Server-end-URL> -c keys.json

var argv = require('yargs')
    .usage('Usage: $0 [targetId] -t [host] -c [keys]')
    .demand(1)
    .default('t', 'http://localhost:8888').alias('t', 'host')
    .default('c', 'keys.json').alias('c', 'keys')
    .help('h').alias('h', 'help')
    .epilog('copyright 2015, sightp.com')
    .argv;

var fs = require('fs');

var targetId = argv._[0];
var host = argv.host;
var keys = JSON.parse(fs.readFileSync(argv.keys));

var farmer = require('../farmer')(host, keys.appKey, keys.appSecret);

farmer.deleteTarget(targetId)
.then(function(resp) {
    console.log(resp.result.targetId);
})
.fail(function(err) {
    console.log(err);
});

deleteTarget 은 cloud 서비스 API 를 호출합니다. sample 코드는 farmer.js 에 있습니다.

function deleteTarget(targetId) {
    return Q.promise(function(resolve, reject) {
        request.del(host + '/target/' + targetId)
        .query(signParams())
        .end(done(resolve, reject));
    });
}

PHP 샘플 코드를 다운로드합니다.

PHP Samples Download

Step 1. 엔트리 코드 demo.php를 엽니다.

Step 2. 전역 변수를 수정하고 준비한 목록의 인증 매개변수로 바꿉니다.

CRS AppId
API Key / API Secret
Server-end URL
toDeleteTargetId

<?php
include 'EasyARClientSdkCRS.php';
$apiKey = 'API Key';
$apiSecret = 'API Secret';
$crsAppId = 'CRS AppId'
$crsCloudUrl = 'https://cn1-crs.easyar.com';
$toDeleteTargetId = 'to-delete-targetId';

$sdk = new EasyARClientSdkCRS($apiKey, $apiSecret, $crsAppId, $crsCloudUrl);

$rs = $sdk->delete($toDeleteTargetId);
if ($rs->statusCode == 0) {
  print_r($rs->result);
} else {
  print_r($rs);
}

Step 3. php demo.php를 실행합니다.

관련 코드 파일 delete_target.py를 만들고 전역 변수를 수정한 다음 실행합니다

pip install requests
python delete_target.py

import time
import hashlib
import requests

# --- 전역 변수 구성 ---
API_KEY = "YOUR_API_KEY"
API_SECRET = "YOUR_API_SECRET"
APP_ID = "YOUR_APP_ID"
HOST = "https://crs-cn1.easyar.com" 
TARGET_ID = "TARGET_ID"

def main():
    timestamp = str(int(time.time() * 1000))
    
    params = {
        'apiKey': API_KEY,
        'appId': APP_ID,
        'timestamp': timestamp
    }

    sorted_keys = sorted(params.keys())
    sign_str = "".join([f"{k}{params[k]}" for k in sorted_keys]) + API_SECRET
    signature = hashlib.sha256(sign_str.encode('utf-8')).hexdigest()

    url = f"{HOST}/target/{TARGET_ID}"
    final_params = {**params, 'signature': signature}

    print(f"Requesting DELETE {url}...")
    response = requests.delete(url, params=final_params)
    print(f"Response: {response.text}")

if __name__ == "__main__":
    main()

관련 코드 파일 main.go를 새로 만들고 global variables를 수정한 다음 실행합니다

go run main.go

main.go:

package main

import (
  "crypto/sha256"
  "fmt"
  "io"
  "net/http"
  "sort"
  "strconv"
  "time"
)

var (
  ApiKey    = "YOUR_API_KEY"
  ApiSecret = "YOUR_API_SECRET"
  AppId     = "YOUR_APP_ID"
  Host      = "https://crs-cn1.easyar.com"
  TargetId  = "TARGET_ID"
)

func main() {
  ts := strconv.FormatInt(time.Now().UnixNano()/1e6, 10)
  params := map[string]string{
    "apiKey":    ApiKey,
    "appId":     AppId,
    "timestamp": ts,
  }

  keys := make([]string, 0, len(params))
  for k := range params { keys = append(keys, k) }
  sort.Strings(keys)

  builder := ""
  for _, k := range keys { builder += k + params[k] }
  builder += ApiSecret
  signature := fmt.Sprintf("%x", sha256.Sum256([]byte(builder)))

  url := fmt.Sprintf("%s/target/%s?apiKey=%s&appId=%s&timestamp=%s&signature=%s", 
    Host, TargetId, ApiKey, AppId, ts, signature)
  
  req, _ := http.NewRequest("DELETE", url, nil)
  resp, _ := http.DefaultClient.Do(req)
  defer resp.Body.Close()
  body, _ := io.ReadAll(resp.Body)
  fmt.Printf("Response: %s
", string(body))
}

Cargo.toml에 reqwest, tokio, sha2, hex dependency를 추가합니다.

cargo run을 실행합니다.

use sha2::{Sha256, Digest};
use std::collections::BTreeMap;
use std::time::{SystemTime, UNIX_EPOCH};

const API_KEY: &str = "YOUR_API_KEY";
const API_SECRET: &str = "YOUR_API_SECRET";
const APP_ID: &str = "YOUR_APP_ID";
const HOST: &str = "https://crs-cn1.easyar.com";
const TARGET_ID: &str = "YOUR_TARGET_ID";

#[tokio::main]
async fn main() -> Result<(), Box<dyn std::error::Error>> {
    let ts = SystemTime::now().duration_since(UNIX_EPOCH)?.as_millis().to_string();

    let mut params = BTreeMap::new();
    params.insert("apiKey", API_KEY);
    params.insert("appId", APP_ID);
    params.insert("timestamp", &ts);

    let mut sign_str = String::new();
    for (k, v) in &params {
        sign_str.push_str(k);
        sign_str.push_str(v);
    }
    sign_str.push_str(API_SECRET);
    
    let mut hasher = Sha256::new();
    hasher.update(sign_str.as_bytes());
    let signature = hex::encode(hasher.finalize());

    let url = format!("{}/target/{}?apiKey={}&appId={}&timestamp={}&signature={}", 
                      HOST, TARGET_ID, API_KEY, APP_ID, ts, signature);
    
    let res = reqwest::Client::new().delete(url).send().await?;
    println!("Response: {}", res.text().await?);
    Ok(())
}

.NET 콘솔 프로젝트를 만듭니다.

dotnet new console
dotnet run

using System;
using System.Collections.Generic;
using System.Linq;
using System.Security.Cryptography;
using System.Text;
using System.Net.Http;

class Program {
    static string API_KEY = "API_KEY";
    static string API_SECRET = "API_SECRET";
    static string APP_ID = "APP_ID";
    static string HOST = "https://crs-cn1.easyar.com";
    static string TARGET_ID = "TARGET_ID";

    static async System.Threading.Tasks.Task Main() {
        string timestamp = DateTimeOffset.Now.ToUnixTimeMilliseconds().ToString();

        var dict = new SortedDictionary<string, string> {
            { "apiKey", API_KEY },
            { "appId", APP_ID },
            { "timestamp", timestamp }
        };

        StringBuilder sb = new StringBuilder();
        foreach (var kv in dict) sb.Append(kv.Key).Append(kv.Value);
        sb.Append(API_SECRET);
        
        string signature = Sha256(sb.ToString());

        using var client = new HttpClient();
        string query = string.Join("&", dict.Select(x => $"{x.Key}={x.Value}")) + $"&signature={signature}";
        string url = $"{HOST}/target/{TARGET_ID}?{query}";
        
        var response = await client.DeleteAsync(url);
        Console.WriteLine($"Result: {await response.Content.ReadAsStringAsync()}");
    }

    static string Sha256(string str) {
        byte[] bytes = SHA256.HashData(Encoding.UTF8.GetBytes(str));
        return BitConverter.ToString(bytes).Replace("-", "").ToLower();
    }
}

실행 환경
- Unity 2020 LTS 이상 버전
- Scripting Backend: Mono 또는 IL2CPP 모두 가능
- API Compatibility Level: .NET Standard 2.1(권장)

Step 1: 이미지 파일 준비

Unity 프로젝트에 디렉터리를 만듭니다.

Assets/
└── Scripts/
     └── DeleteImageTarget.cs

using System.Collections;
using UnityEngine;
using UnityEngine.Networking;

public class DeleteImageTarget : MonoBehaviour
{
    [Header("Config")]
    public string targetId = "Your targetId";
    public string apiBaseUrl = "https://Your-Server-end-URL";
    public string authorizationToken = "YOUR API KEY AUTH TOKEN"; 
    public string crsAppId = "CRS-AppId"; 

    private void Start()
    {
        StartCoroutine(DeleteTarget());
    }

    private IEnumerator DeleteTarget()
    {
     
        string url =
            $"{apiBaseUrl}/target/{targetId}?appId={crsAppId}";

        UnityWebRequest request = UnityWebRequest.Delete(url);
        request.downloadHandler = new DownloadHandlerBuffer();

        request.SetRequestHeader("Content-Type", "application/json");
        request.SetRequestHeader("Authorization", authorizationToken);

        yield return request.SendWebRequest();

        if (request.result == UnityWebRequest.Result.Success)
        {
            Debug.Log("Delete target success:");
            Debug.Log(request.downloadHandler.text);
        }
        else
        {
            Debug.LogError("Delete target failed:");
            Debug.LogError(request.error);
            Debug.LogError(request.downloadHandler.text);
        }
    }
}

Assets 디렉터리 이름에 따라
- 아래 샘플 코드를 복사합니다 DeleteImageTarget.cs
Unity Editor에서:
- 빈 GameObject를 만듭니다
- 이름을 지정합니다 DeleteTarget
- 스크립트를 이 오브젝트에 드래그합니다

Step 3: 매개변수 구성(Inspector)

Inspector 패널에서 다음을 수정합니다.
- Api Url
- Authorization Token
- Crs App Id
- Target Id: 삭제할 target image의 targetId
실행하려면 이 항목들만 수정하면 되며, 준비 체크리스트에서 준비한 매개변수를 입력합니다

Step 4: 실행

Play를 클릭합니다
Console에서 결과를 확인합니다.
- 성공: JSON(targetId 포함) 반환
- 실패: HTTP / 오류 정보

관련 주제:

Table of Contents

Target images 삭제

EasyAR Web management center에서 작업

경고

Best practice: target images 비활성화

API를 사용해 target images 삭제

준비