오픈 API

GET/api/search?q=crimson&limit=8Copy

이름, 표준 코드, 전통 이름 또는 HEX로 색상을 검색합니다

매개변수

요청 예시

curl "https://www.yanseku.com/api/search?q=crimson&limit=8"

브라우저에서 직접 가져오기 가능(CORS 활성화됨).

응답 예시

{
  "query": "crimson",
  "results": [
    { "name": "BM 1299 Crimson", "hex": "b1625b", "source": "standard", "system": "benjamin_moore", "code": "BM 1299" },
    { "name": "crimson", "hex": "dc143c", "source": "standard", "system": "css_named", "code": "crimson" }
  ]
}

GET/api/color/e63946Copy

색상 프로필: 10가지 형식 + 가장 가까운 명명된 색상 + 8개 표준 시스템 간 매치 + 전통 색상 매치 + 6가지 조화 + 대비

매개변수

요청 예시

curl "https://www.yanseku.com/api/color/e63946"

응답 예시

{
  "hex": "e63946",
  "formats": {
    "rgb": { "r": 230, "g": 57, "b": 70 },
    "hsl": { "h": 355.5, "s": 77.6, "l": 56.3 },
    "hsv": { "h": 355.5, "s": 75.2, "v": 90.2 },
    "cmyk": { "c": 0, "m": 75.2, "y": 69.6, "k": 9.8 },
    "xyz": { "x": 0.352, "y": 0.2019, "z": 0.0784 },
    "lab": { "L": 52.06, "a": 65.72, "b": 34.14 },
    "oklch": { "L": 0.612, "c": 0.208, "h": 22.2 },
    "webSafe": "ff3333",
    "css": { "rgb": "rgb(230, 57, 70)", "hsl": "hsl(355.5, 77.6%, 56.3%)" }
  },
  "named": {
    "closest": { "name": "Paint the Town Red", "hex": "e63045", "deltaE": 1.34, "exact": false },
    "nearest": [ { "name": "Red Radish", "hex": "ee3344", "deltaE": 1.36, "exact": false } ]
  },
  "standards": [
    { "system": "ncs", "systemName": "NCS (Natural Color System)", "code": "NCS S 0570-Y90R", "name": "NCS S 0570-Y90R", "hex": "e6373f", "deltaE": 1.69, "exact": false },
    { "system": "munsell", "systemName": "Munsell (Re-renotation)", "code": "7.5R 6/16", "name": "7.5R 6/16", "hex": "dd3743", "deltaE": 2.02, "exact": false }
  ],
  "traditional": [
    { "name": "火红", "hex": "ff2d51", "cat": "红", "deltaE": 4.88, "exact": false },
    { "name": "银红", "hex": "f05654", "cat": "红", "deltaE": 5.89, "exact": false }
  ],
  "harmony": [
    { "type": "complementary", "colors": ["e63946", "39e6d9"] },
    { "type": "split-complementary", "colors": ["e63946", "39e683", "399de6"] }
  ],
  "contrast": {
    "onWhite": { "ratio": 4.17, "levels": { "aaNormal": false, "aaLarge": true, "aaaNormal": false, "aaaLarge": false } },
    "onBlack": { "ratio": 5.04, "levels": { "aaNormal": true, "aaLarge": true, "aaaNormal": false, "aaaLarge": true } },
    "bestText": "#000000"
  }
}

GET/api/scheme?hex=e63946&mode=triadicCopy

조화 스킴: 기본 색상을 중심으로 6가지 규칙

매개변수

요청 예시

curl "https://www.yanseku.com/api/scheme?hex=e63946&mode=triadic"

응답 예시

{
  "hex": "e63946",
  "mode": "triadic",
  "count": 3,
  "colors": ["e63946", "46e639", "3946e6"]
}

GET/api/contrast?fg=ffffff&bg=e63946Copy

대비 확인: WCAG 비율 + AA/AAA 레벨 + 최적 텍스트 색상

매개변수

요청 예시

curl "https://www.yanseku.com/api/contrast?fg=ffffff&bg=e63946"

응답 예시

{
  "fg": "ffffff",
  "bg": "e63946",
  "ratio": 4.17,
  "label": "AA Large",
  "levels": { "aaNormal": false, "aaLarge": true, "aaaNormal": false, "aaaLarge": false },
  "bestText": "#000000"
}

GET/api/random?count=5Copy

선정된 이름 풀에서 랜덤 색상, 최대 10개

매개변수

요청 예시

curl "https://www.yanseku.com/api/random?count=5"

응답 예시

{
  "count": 3,
  "colors": [
    { "name": "Sea Foam Green", "hex": "c2e4d0" },
    { "name": "Deep Koamaru", "hex": "333366" },
    { "name": "Laser Lemon", "hex": "ffff66" }
  ]
}