색상 추출 샘플예제

색상 추출 추가

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	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	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)