<?php
	$openApiURL = "http://aiopen.etri.re.kr:8000/FaceDeID";
	$accessKey = "YOUR_ACCESS_KEY";
	$type = "1";     // 얼굴 비식별화 기능 "1"로 설정
	$filePath = "IMAGE_FILE_PATH";
	$imageContents = base64_encode( file_get_contents($filePath ) );

	$request = array(	
		"argument" => array (
			"type" => $type,
			"file" => $imageContents
		)
	);

	try {
		$server_output = "";
		$ch = curl_init();
		$header = array(
			"Content-Type:application/json; charset=UTF-8",
			"Authorization":{$accessKey}
		);
		curl_setopt($ch, CURLOPT_HTTPHEADER, $header);
		curl_setopt($ch, CURLOPT_URL, $openApiURL);
		curl_setopt($ch, CURLOPT_VERBOSE, true);
		
		curl_setopt($ch, CURLOPT_POST, 1);
		curl_setopt($ch, CURLOPT_POSTFIELDS, json_encode ( $request) );

		$server_output = curl_exec ($ch);
		if($server_output === false) {
			echo "Error Number:".curl_errno($ch)."\n";
			echo "Error String:".curl_error($ch)."\n";
		}

		curl_close ($ch);
	} catch ( Exception $e ) {
		echo $e->getMessage ();
	}

	echo "result = " . var_dump($server_output);
?>

JSON parsing을 위해 jsoncpp 라이브러리를 사용하여 제공하고 있습니다. jsoncpp 라이브러리에 대한 자세한 설명은 https://github.com/open-source-parsers/jsoncpp 에서 확인 하실 수 있습니다.

HTTP 통신을 위해 curl 라이브러리를 사용하여 제공하고 있습니다. curl 라이브러리에 대한 자세한 설명은 https://curl.haxx.se/libcurl 에서 확인 하실 수 있습니다.

컴파일을 위해서는 아래와 같이 추가된 LIB에 대한 옵션을 추가해야 합니다.

g++ (c++파일명) (JSONCPP)/json/json.h (JSONCPP)/json/json-forwards.h (JSONCPP)/jsoncpp.cpp -I(CURL)/include -lcurl

  
#include <curl/curl.h>
#include <json/json.h>
#include <iostream>
#include <string>
#include <memory.h>
#include <fstream>
#include <math.h>


#define LENFRAME  800

using namespace std;

size_t writeDataFunc(void *ptr, size_t size, size_t nmemb, string stream);
string base64_encode(unsigned char const* , unsigned int len);

static const string base64_chars =
        "ABCDEFGHIJKLMNOPQRSTUVWXYZ"
        "abcdefghijklmnopqrstuvwxyz"
        "0123456789+/";
int main() {
  char* openApiURL = (char*)"http://aiopen.etri.re.kr:8000/FaceDeID";
  char* imageFilePath = (char*)"IMAGE_FILE_PATH";
  string accessKey = "YOUR_ACCESS_KEY";
  string type = "1";     // 얼굴 비식별화 기능 "1"로 설정

  Json::Value request;
  Json::Value argument;
  FILE* fp = fopen(imageFilePath, "rt" );
  unsigned char sbuf[LENFRAME];
  unsigned int nRead = 0;
  unsigned int nWrite = 0;

  unsigned char* imageBytes;
  unsigned char* newimageBytes;
  while ( 0 < ( nRead = fread( sbuf, sizeof( char ), LENFRAME, fp ) ) ) {
    newimageBytes = new unsigned char[nWrite + nRead];
    if ( 0 < nWrite ) {
      memcpy(newimageBytes, imageBytes, nWrite * sizeof(char));
    }
    memcpy(newimageBytes + nWrite, sbuf, nRead * sizeof(char));
    nWrite = nWrite + nRead;
    imageBytes = new unsigned char[nWrite];
    memcpy(imageBytes, newimageBytes, nWrite * sizeof(char));
  }
  fclose(fp);

  argument["type"] = type;
  argument["file"] = base64_encode( imageBytes , nWrite);

  request["argument"] = argument;

  CURL *curl;
  curl_slist* responseHeaders = NULL;
  curl = curl_easy_init();

  if( curl == NULL ) {
  } else {
                responseHeaders = curl_slist_append( responseHeaders , "Content-Type: application/json; charset=UTF-8" ) ;
                responseHeaders = curl_slist_append( responseHeaders , ("Authorization: " + accessKey).c_str() ) ; 
    string requestJson = request.toStyledString();
    long statusCode;
    string response;

    curl_easy_setopt(curl, CURLOPT_URL, openApiURL);
    curl_easy_setopt(curl, CURLOPT_HTTPHEADER, responseHeaders ) ;
    curl_easy_setopt(curl, CURLOPT_TIMEOUT, 60);
    curl_easy_setopt(curl, CURLOPT_CUSTOMREQUEST, "POST");
    curl_easy_setopt(curl, CURLOPT_POSTFIELDS, requestJson.c_str());
    curl_easy_setopt(curl, CURLOPT_WRITEFUNCTION, writeDataFunc);
    curl_easy_setopt(curl, CURLOPT_WRITEDATA, &response);

    curl_easy_perform(curl);

    curl_easy_getinfo(curl, CURLINFO_RESPONSE_CODE, &statusCode);
    curl_easy_cleanup(curl);

    cout << "[responseCode] " << statusCode << endl;
    cout << "[responBody]" << endl;
    cout << response << endl;
  }

  return 0;
}

size_t writeDataFunc(void *ptr, size_t size, size_t nmemb, string stream) {
  size_t realsize = size * nmemb;
  string temp(static_cast<const char*>(ptr), realsize);
  stream.append(temp);
  return realsize;
}

string base64_encode(unsigned char const* bytes_to_encode, unsigned int in_len) {
  string ret;
  int i = 0;
  int j = 0;
  unsigned char char_array_3[3];
  unsigned char char_array_4[4];

  while (in_len--) {
  char_array_3[i++] = *(bytes_to_encode++);
  if (i == 3) {
    char_array_4[0] = (char_array_3[0] & 0xfc) >> 2;
    char_array_4[1] = ((char_array_3[0] & 0x03) << 4) + ((char_array_3[1] & 0xf0) >> 4);
    char_array_4[2] = ((char_array_3[1] & 0x0f) << 2) + ((char_array_3[2] & 0xc0) >> 6);
    char_array_4[3] = char_array_3[2] & 0x3f;

    for(i = 0; (i <4) ; i++)
      ret += base64_chars[char_array_4[i]];
    i = 0;
  }
}

  if (i) {
  for(j = i; j < 3; j++)
    char_array_3[j] = '\0';

  char_array_4[0] = (char_array_3[0] & 0xfc) >> 2;
  char_array_4[1] = ((char_array_3[0] & 0x03) << 4) + ((char_array_3[1] & 0xf0) >> 4);
  char_array_4[2] = ((char_array_3[1] & 0x0f) << 2) + ((char_array_3[2] & 0xc0) >> 6);
  char_array_4[3] = char_array_3[2] & 0x3f;

  for (j = 0; (j < i + 1); j++)
    ret += base64_chars[char_array_4[j]];

  while((i++ < 3))
    ret += '=';
  }
  return ret;
    
}

python 3.0을 기준으로 작성되었습니다.

HTTP 통신을 위해 urllib3 라이브러리를 사용하여 제공하고 있습니다. Python 3.0 이하의 버전에서 예제를 실행하기 위해서는 별도로 urllib3의 설치가 필요합니다. 설치에 대한 설명은 https://pypi.python.org/pypi/urllib3 를 참고하시기 바랍니다. urllib3 라이브러리에 대한 자세한 설명은 https://urllib3.readthedocs.io/en/latest/ 에서 확인 하실 수 있습니다.

#-*- coding:utf-8 -*-
  import urllib3
  import json
  import base64
  openApiURL = "http://aiopen.etri.re.kr:8000/FaceDeID"
  accessKey = "YOUR_ACCESS_KEY"
  imageFilePath = "IMAGE_FILE_PATH"
  type = "1";     # 얼굴 비식별화 기능 "1"로 설정
  
  file = open(imageFilePath, "rb")
  imageContents = base64.b64encode(file.read()).decode("utf8")
  file.close()
  
  requestJson = {
    "argument": {
      "type": type,
      "file": imageContents
    }
  }
  
  http = urllib3.PoolManager()
  response = http.request(
    "POST",
    openApiURL,
    headers={"Content-Type": "application/json; charset=UTF-8","Authorization": accessKey},
    body=json.dumps(requestJson)
  )
  
  print("[responseCode] " + str(response.status))
  print("[responBody]")
  print(response.data)

var fs = require('fs');
var openApiURL = 'http://aiopen.etri.re.kr:8000/FaceDeID';
var accessKey = 'YOUR_ACCESS_KEY';
var type = '1';     // 얼굴 비식별화 기능 '1'로 설정
var imageFilePath = 'IMAGE_FILE_PATH';
var imageData;

var imageData = fs.readFileSync(imageFilePath);

var requestJson = {
	'argument': {
		'type': type,
		'file': imageData.toString('base64')
	}
};

var request = require('request');
var options = {
	url: openApiURL,
	body: JSON.stringify(requestJson),
	headers: {'Content-Type':'application/json','Authorization':access_key}
};
request.post(options, function (error, response, body) {
	console.log('responseCode = ' + response.statusCode);
	console.log('responseBody = ' + body);
});

얼굴 비식별화 API는 요청된 입력 이미지에 대해 얼굴 비식별화를 수행한 결과를 JSON 형태의 Text 데이터로 반환합니다.

다음은 정상적인 요청 처리에 대한 HTTP 응답 예입니다.

[HTTP Respone Header]
Access-Control-Allow-Origin:*
Connection:close
Content-Length:50783
Content-Type:application/json; charset=UTF-8

[HTTP Respone Body]
{
    "request_id": "reserved field",
    "result": 0,
    "return_type": "com.google.gson.internal.LinkedTreeMap",
    "return_object": {얼굴 비식별화 결과 JSON}
}

다음은 오류가 발생한 요청 처리에 대한 HTTP 응답 예입니다.

[HTTP Respone Header]
Access-Control-Allow-Origin:*
Connection:close
Content-Length:0
Content-Type:application/json; charset=UTF-8

[HTTP Respone Body]
{
    "request_id": "reserved field",
    "result": -1,
    "reason": {오류 메시지}
}

분석된 결과는 다음과 같은 내용이 포함되어 있습니다.

구분	JSON Key 이름	설명
속성검출 기본정보	bbox	얼굴 비식별화를 위해 검출된 얼굴 영역의 bounding box 좌표 (예) bbox: [55, 45, 205, 232], [x좌표1, y좌표1, x좌표2, y좌표2]
	conf	얼굴 영역 검출에 대한 신뢰도

얼굴 비식별화 검출이 제대로 이루어지지 않았을 경우에는 얼굴 비식별화 검출 결과 대신 오류 메시지가 반환됩니다.

얼굴 비식별화 API의 오류 코드 목록은 다음과 같습니다.