API 문서

무료 Unicode 기호 API. 인증 불필요. JSON 응답.

무료 인증 불필요 JSON OpenAPI ↗

기본 URL

https://symbolfyi.com/api/

GET

기호 상세

Unicode 속성 및 모든 인코딩 표현을 포함한 기호의 전체 정보를 가져옵니다.

/api/symbol/{slug}/

파라미터

slug	기호 슬러그 (예: black-heart-suit)

예시

curl https://symbolfyi.com/api/symbol/black-heart-suit/

{
  "character": "♥",
  "name": "Black Heart Suit",
  "codepoint": "U+2665",
  "slug": "black-heart-suit",
  "category": "Card Suits",
  "block": "Miscellaneous Symbols",
  "script": "Common",
  "general_category": "So",
  "keywords": "heart, love, card, suit",
  "encodings": {
    "unicode": "U+2665",
    "html_decimal": "&#9829;",
    "html_hex": "&#x2665;",
    "html_entity": "&hearts;",
    "css": "\\2665",
    "javascript": "\\u2665",
    "python": "\\u2665",
    "java": "\\u2665",
    "utf8_bytes": "E2 99 A5",
    "utf16_bytes": "26 65",
    "url_encoded": "%E2%99%A5"
  },
  "url": "/symbol/black-heart-suit/"
}

GET

기호 검색

이름, 키워드, 별칭, HTML 엔티티로 기호를 검색합니다. 정확한 조회를 위해 단일 문자도 입력할 수 있습니다.

/api/search/?q={query}

파라미터

q	검색어 (이름, 키워드, 또는 문자)

예시

curl "https://symbolfyi.com/api/search/?q=arrow"

{
  "results": [
    {"character": "→", "name": "Rightwards Arrow", "slug": "rightwards-arrow", "codepoint": "U+2192", "category": "Arrows", "url": "/symbol/rightwards-arrow/"},
    {"character": "←", "name": "Leftwards Arrow", "slug": "leftwards-arrow", "codepoint": "U+2190", "category": "Arrows", "url": "/symbol/leftwards-arrow/"},
    {"character": "↑", "name": "Upwards Arrow", "slug": "upwards-arrow", "codepoint": "U+2191", "category": "Arrows", "url": "/symbol/upwards-arrow/"}
  ]
}

GET

카테고리 기호

카테고리 내 모든 기호를 가져옵니다 (최대 200개).

/api/category/{slug}/

파라미터

slug	카테고리 슬러그 (예: arrows, currency, mathematical)

예시

curl https://symbolfyi.com/api/category/currency/

{
  "category": {"name": "Currency", "slug": "currency", "icon": "$"},
  "symbols": [
    {"character": "$", "name": "Dollar Sign", "slug": "dollar-sign", "codepoint": "U+0024", "url": "/symbol/dollar-sign/"},
    {"character": "€", "name": "Euro Sign", "slug": "euro-sign", "codepoint": "U+20AC", "url": "/symbol/euro-sign/"},
    {"character": "£", "name": "Pound Sign", "slug": "pound-sign", "codepoint": "U+00A3", "url": "/symbol/pound-sign/"}
  ]
}

GET

문자 인코딩

모든 Unicode 문자의 Unicode 정보 및 인코딩 표현을 가져옵니다. 선별된 기호뿐 아니라 모든 Unicode 문자에 적용됩니다.

/api/encode/?char={character}

파라미터

char	임의의 Unicode 문자 (여러 문자 입력 시 첫 번째 문자 사용)

예시

curl "https://symbolfyi.com/api/encode/?char=★"

{
  "character": "★",
  "name": "BLACK STAR",
  "codepoint": "U+2605",
  "category": "So",
  "category_name": "Symbol, other",
  "block": "Miscellaneous Symbols",
  "script": "Common",
  "encodings": {
    "unicode": "U+2605",
    "html_decimal": "&#9733;",
    "html_hex": "&#x2605;",
    "html_entity": "",
    "css": "\\2605",
    "javascript": "\\u2605",
    "python": "\\u2605",
    "java": "\\u2605",
    "utf8_bytes": "E2 98 85",
    "utf16_bytes": "26 05",
    "url_encoded": "%E2%98%85"
  }
}

사용 안내

✓ 어떤 목적으로도 무료 사용 가능
✓ API 키 또는 인증 불필요
✓ 브라우저 요청에 CORS 활성화
✓ OpenAPI 3.1 명세는 다음에서 확인 가능: /api/openapi.json
⚠ 요청 빈도를 적절히 유지해 주세요