색상 추출 샘플예제

색상 추출 추가

  • REQUEST (CURL / GET)

curl --request GET \
     --url https://apis.openapi.sk.com/urbanbase/v1/space/extractor \
     --header 'Accept: application/json' \
     --header 'Content-Type: application/json' \
     --header 'appKey: My Project의 Project Key'
  • REQUEST (CURL / POST)

curl --request POST \
     --url https://apis.openapi.sk.com/urbanbase/v1/space/extractor \
     --header 'Accept: application/json' \
     --header 'Content-Type: application/json' \
     --header 'appKey: My Project의 Project Key'
  • REQUEST (SAMPLE CODE)

POST /space/extractor

headers: {
    "Content-Type": "application/json",
    “appkey”: “{appkey}”   
}
body: {
    "image_path": "https://upload.wikimedia.org/wikipedia/commons/thumb/c/cf/Wohnzimmer_2007.jpg/220px-Wohnzimmer_2007.jpg"
}
  • RESPONSE (200 / JSON)

{
  "code": "00000",
  "message": "success",
  "data": {
    "space_image_uuid": "2c36bfce-6019-4236-bf84-82cde39bbb15",
    "image_path": "https://upload.wikimedia.org/wikipedia/commons/thumb/c/cf/Wohnzimmer_2007.jpg/220px-Wohnzimmer_2007.jpg",
    "created_date": "2021-01-11T01:32:29.268Z",
    "results": [
      {
        "r": 54,
        "g": 24,
        "b": 8,
        "proportion": 0.08854166666666667
      },
      {
        "r": 137,
        "g": 75,
        "b": 26,
        "proportion": 0.1916232638888889
      },
      {
        "r": 181,
        "g": 122,
        "b": 63,
        "proportion": 0.2752097800925926
      },
      {
        "r": 225,
        "g": 171,
        "b": 105,
        "proportion": 0.3245804398148148
      },
      {
        "r": 252,
        "g": 239,
        "b": 207,
        "proportion": 0.12004484953703703
      }
    ]
  }
}
  • RESPONSE (400/ JSON)

{
  "code": "12001",
  "message": "Invalid image_path"
}
  • RESPONSE (PARAMETERS)

Name

Type

Mandatory

Example

Description

code

Number

Y

응답 상태 코드

message

String

Y

응답 상태 설명

data

object

Y

데이터 정보

space_image_uuid

String

Y

범용 고유 식별자(UUID)

image_path

String

Y

이미지 경로

created_date

Date

Y

컬러 분석 데이터 생성 시간

results

Ojbect

Y

컬러 분석 결과

r

Number

N

RGB 컬러의 red decimal code (0 ~ 255 사이의 정수)

g

Number

N

RGB 컬러의 green decimal code (0 ~ 255 사이의 정수)

b

Number

N

RGB 컬러의 blue decimal code (0 ~ 255 사이의 정수)

proportion

Number

N

이미지에서 해당 color가 차지하는 비율 (0 ~ 1)



색상 추출 조회

  • REQUEST (CURL / GET)

curl --request GET \
     --url https://apis.openapi.sk.com/urbanbase/v1/space/extractor/%7Bspace_image_uuid%20%7D \
     --header 'Accept: application/json' \
     --header 'appKey: My Project의 Project Key'
  • REQUEST (CURL / POST)

curl --request POST \
     --url https://apis.openapi.sk.com/urbanbase/v1/space/extractor/%7Bspace_image_uuid%20%7D \
     --header 'Accept: application/json' \
     --header 'appKey: My Project의 Project Key'
  • REQUEST (SAMPLE CODE)

GET /space/analyzer/2c36bfce-6019-4236-bf84-82cde39bbb15

headers: {
    "Content-Type": "application/json",
    “appkey”: “{appkey}”   
}
  • RESPONSE (200 / JSON)

{
  "code": "00000",
  "message": "success",
  "data": {
    "space_image_uuid": "2c36bfce-6019-4236-bf84-82cde39bbb15",
    "image_path": "https://upload.wikimedia.org/wikipedia/commons/thumb/c/cf/Wohnzimmer_2007.jpg/220px-Wohnzimmer_2007.jpg",
    "created_date": "2021-01-11T01:32:29.268Z",
    "results": [
      {
        "r": 54,
        "g": 24,
        "b": 8,
        "proportion": 0.08854166666666667
      },
      {
        "r": 137,
        "g": 75,
        "b": 26,
        "proportion": 0.1916232638888889
      },
      {
        "r": 181,
        "g": 122,
        "b": 63,
        "proportion": 0.2752097800925926
      },
      {
        "r": 225,
        "g": 171,
        "b": 105,
        "proportion": 0.3245804398148148
      },
      {
        "r": 252,
        "g": 239,
        "b": 207,
        "proportion": 0.12004484953703703
      }
    ]
  }
}
  • RESPONSE (400/ JSON)

{
  "code": "40000",
  "message": "Not Found"
}
  • RESPONSE (PARAMETERS)

Name

Type

Mandatory

Example

Description

code

Number

Y

응답 상태 코드

message

String

Y

응답 상태 설명

data

Object

Y

데이터 정보

space_image_uuid

String

Y

범용 고유 식별자(UUID)

image_path

String

Y

이미지 경로

created_date

Date

Y

컬러 분석 데이터 생성 시간

results

Object

Y

컬러 분석 결과

r

Number

N

RGB 컬러의 red decimal code (0 ~ 255 사이의 정수)

g

Number

N

RGB 컬러의 green decimal code (0 ~ 255 사이의 정수)

n

Number

N

RGB 컬러의 blue decimal code (0 ~ 255 사이의 정수)

proportion

Number

N

이미지에서 해당 color가 차지하는 비율 (0 ~ 1)