색상 추출 샘플예제

색상 추출 추가

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

NameTypeMandatoryExampleDescription
codeNumberY응답 상태 코드
messageStringY응답 상태 설명
dataobjectY데이터 정보
space_image_uuidStringY범용 고유 식별자(UUID)
image_pathStringY이미지 경로
created_dateDateY컬러 분석 데이터 생성 시간
resultsOjbectY컬러 분석 결과
rNumberNRGB 컬러의 red decimal code (0 ~ 255 사이의 정수)
gNumberNRGB 컬러의 green decimal code (0 ~ 255 사이의 정수)
bNumberNRGB 컬러의 blue decimal code (0 ~ 255 사이의 정수)
proportionNumberN이미지에서 해당 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)

NameTypeMandatoryExampleDescription
codeNumberY응답 상태 코드
messageStringY응답 상태 설명
dataObjectY데이터 정보
space_image_uuidStringY범용 고유 식별자(UUID)
image_pathStringY이미지 경로
created_dateDateY컬러 분석 데이터 생성 시간
resultsObjectY컬러 분석 결과
rNumberNRGB 컬러의 red decimal code (0 ~ 255 사이의 정수)
gNumberNRGB 컬러의 green decimal code (0 ~ 255 사이의 정수)
nNumberNRGB 컬러의 blue decimal code (0 ~ 255 사이의 정수)
proportionNumberN이미지에서 해당 color가 차지하는 비율 (0 ~ 1)