SymbolFYI

API文档

免费Unicode符号API。无需身份验证。JSON响应。

免费 无需认证 JSON OpenAPI ↗

基础URL

https://symbolfyi.com/api/
GET

符号详情

获取符号的完整信息,包括Unicode属性和所有编码表示。

/api/symbol/{slug}/

参数

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": "♥",
    "html_hex": "♥",
    "html_entity": "♥",
    "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 类别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字符。

/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": "★",
    "html_hex": "★",
    "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
  • 请合理控制请求频率