Documentação da API

API de símbolos Unicode gratuita. Nenhuma autenticação necessária. Respostas em JSON.

Gratuito Nenhuma autenticação necessária JSON OpenAPI ↗

URL base

https://symbolfyi.com/api/

GET

Detalhe do símbolo

Obter informações completas sobre um símbolo, incluindo propriedades Unicode e todas as representações de codificação.

/api/symbol/{slug}/

Parâmetros

slug	Slug do símbolo (ex. black-heart-suit)

Exemplo

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

Pesquisar símbolos

Pesquisar símbolos por nome, palavra-chave, alias ou entidade HTML. Também aceita um único caractere para pesquisa exata.

/api/search/?q={query}

Parâmetros

q	Consulta de pesquisa (nome, palavra-chave ou caractere)

Exemplo

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

Símbolos de categoria

Obter todos os símbolos de uma categoria (máx. 200).

/api/category/{slug}/

Parâmetros

slug	Slug de categoria (ex. arrows, currency, mathematical)

Exemplo

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

Codificar caractere

Obter informações Unicode e todas as representações de codificação para qualquer caractere. Funciona com qualquer caractere Unicode, não apenas símbolos selecionados.

/api/encode/?char={character}

Parâmetros

char	Qualquer caractere Unicode (o primeiro caractere é usado se vários forem fornecidos)

Exemplo

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"
  }
}

Notas de uso

✓ Livre para uso em qualquer finalidade
✓ Nenhuma chave de API ou autenticação necessária
✓ CORS habilitado para requisições do navegador
✓ Especificação OpenAPI 3.1 disponível em /api/openapi.json
⚠ Por favor, seja razoável com as taxas de requisição