ForHosting KIT · 開発者向けツール

絵文字ショートコード検索

絵文字ショートコードは、ソースコード、チャットの書き出し、テンプレート、リリースノート、自動処理で便利です。ただし、:smile: のような名前は、読者が最終的に目にする文字そのものではありません。この検索機能は、コロンで囲まれた完全なショートコードを受け取り、対応するUnicode絵文字をすぐに返します。照合は完全一致で、結果は常に同じになり、端末内の固定表だけで処理されます。メッセージサービスへの問い合わせ、似た名前の推測、不正な入力の自動修正は行いません。未知のコードには明確な入力エラーを返すため、公開前に壊れたテンプレートを発見できます。

● Beta無料・ブラウザ内で実行

無料で実行 API仕様を見る

ご利用方法ウェブAPIメールTelegramアプリ近日

調べたいショートコードを完全な形で入力します

先頭と末尾にコロンを付けたコードを1つ指定してください。たとえば :smile:、:rocket:、:+1: です。名前には小文字を使い、照合は完全一致で行われます。実際の運用で完全なトークンを求めることには理由があります。smile のような単語は通常の文章にも現れますが、コロンで囲まれた形なら、絵文字への置換を意図していると明確に判断できます。結果には、送信したショートコードと対応するUnicode文字の両方が含まれます。そのため、スクリプトは確認可能な記録を残しながら、文字を直接利用できます。サービス名、言語設定、出力エンコーディングを指定する必要はありません。UnicodeはJSONテキストとして返され、文書への挿入、メッセージへのコピー、データベースへの保存、後続処理への受け渡しができます。入力がない場合、大文字や空白を含む場合、どちらかのコロンが欠けている場合、または対応表に存在しない場合は、要求が明示的に失敗します。この厳密な動作により、偶然の単語や入力ミスが理由不明の置換につながることを防げます。

完全一致の対応表とUnicode出力を理解します

ショートコードの語彙は慣習であり、Unicode自体の機能ではありません。このツールは、GitHubやSlackで親しまれている形式を参考にした、固定かつ版管理された対応表を使います。一般的な表情、身振り、記号、物、食べ物、動物、天気、スポーツの名前を収録しています。表が固定されているため、自動処理を繰り返しても再現性があります。同じ有効なトークンからは、必ず同じUnicodeコードポイント列が返ります。ハートや警告記号など、一部の絵文字には、絵文字表示を指定する異体字セレクターが含まれます。画面上では1文字に見えても、返り値はその列を保ちます。ただし、OS、ブラウザー、フォント、メッセージアプリはそれぞれ独自の画像を使うため、見た目は環境によって変わることがあります。この検索は、任意のUnicode文字名の変換、説明文による検索、肌の色の追加、ワークスペースに登録された独自絵文字の解釈には対応しません。そのような用途では対象サービスの一覧をご利用ください。ここでは、未知の名前を推測せずエラーにすることで、生成内容を予測可能にし、テスト時に古いトークンを見つけやすくしています。

テンプレートや自動処理で安全に利用します

よくある使い方は、設定可能なステータスアイコンをテンプレートの保存前に検証することです。設定されたトークンをこの機能へ送り、検索に成功したら返された絵文字を保持し、失敗したら編集担当者へエラーを表示します。ビルドツールでも、リリースノートのメタデータ、文書のテストデータ、通知ルール、小規模なコンテンツレコードに同じ確認を適用できます。1回の要求で1項目だけを解決するため、置換する場所を利用者が明確に管理できます。段落全体を走査しないので、コード例、URL、時刻、たまたまコロンを含む文章を意図せず変更することはありません。ブラウザーでの利用は無料で、API要求は1回 $0.002 です。実装はネットワークへ接続せず、データも保存しません。そのため、チャット事業者の稼働状況やアカウント設定に依存しません。一括処理では、呼び出し側で重複トークンを除き、異なるショートコードごとに解決し、安定した回答をコンテンツ処理系の版とともに保存してください。無効入力の応答は疑問符への置換ではなく検証失敗として扱うことをお勧めします。元のトークンを残すと、原因の特定と修正が容易になります。

活用例

通知テンプレートを検証する

メッセージテンプレートを保存または公開する前に、設定されたステータス用ショートコードが存在するか確認します。

リリースノートの情報を表示する

:rocket: のようなカテゴリートークンをUnicode文字へ変換し、変更履歴の見出しに使います。

コンテンツのテストデータを確認する

既知のショートコードが正確な絵文字になることを確認し、入力ミスがあれば明確に失敗させます。

よくある質問

入力はどのような形式ですか？

:smile: のように、小文字の名前を両側のコロンで囲んでください。2つのコロンは必須です。

未知のショートコードを指定するとどうなりますか？

認識できないトークンを示す無効入力エラーが返ります。似た名前を推測することはありません。

ワークスペース独自の絵文字にも対応しますか？

いいえ。独自絵文字は特定のサービスや領域に属するため、この固定された標準対応表には含まれません。

別の端末で絵文字の見た目が違うのはなぜですか？

返されるUnicode列は同じですが、OS、フォント、ブラウザー、アプリがそれぞれ独自の図柄を描くためです。

API検索の料金はいくらですか？

API要求は1回 $0.002 です。ブラウザー版は端末内で無料実行できます。

開発者向け — APIアクセス

このページの機能はすべてAPIからも利用できます。自社システムに組み込みたいチーム向けのセクションです。それ以外の方は上のツールをそのままお使いください。

エンドポイント

POSThttps://api.kit.forhosting.com/str/emoji-shortcode-lookup

Bearerトークンで認証し、POST1回でタスクをキューに登録します。結果はWebhookまたは署名付きリンクで受け取れます。

お使いのスタックから呼び出す

curl -X POST https://api.kit.forhosting.com/str/emoji-shortcode-lookup \
  -H "Authorization: Bearer $KIT_KEY" \
  -H "Content-Type: application/json" \
  -d '{"shortcode":":smile:"}'

const res = await fetch("https://api.kit.forhosting.com/str/emoji-shortcode-lookup", {
  method: "POST",
  headers: {
    "Authorization": `Bearer ${process.env.KIT_KEY}`,
    "Content-Type": "application/json"
  },
  body: JSON.stringify({
    "shortcode": ":smile:"
  })
});
const { task_id } = await res.json();

import os, requests

res = requests.post(
    "https://api.kit.forhosting.com/str/emoji-shortcode-lookup",
    headers={"Authorization": f"Bearer {os.environ['KIT_KEY']}"},
    json={
    "shortcode": ":smile:"
},
)
task_id = res.json()["task_id"]

<?php
$res = file_get_contents("https://api.kit.forhosting.com/str/emoji-shortcode-lookup", false, stream_context_create([
  "http" => [
    "method"  => "POST",
    "header"  => "Authorization: Bearer " . getenv("KIT_KEY") . "\r\nContent-Type: application/json",
    "content" => '{"shortcode":":smile:"}',
  ],
]));
$task = json_decode($res, true);

body := bytes.NewBufferString(`{"shortcode":":smile:"}`)
req, _ := http.NewRequest("POST", "https://api.kit.forhosting.com/str/emoji-shortcode-lookup", body)
req.Header.Set("Authorization", "Bearer "+os.Getenv("KIT_KEY"))
req.Header.Set("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)

リクエスト例

{
  "shortcode": ":smile:"
}

レスポンス例

{
  "task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
  "type": "str.emoji_shortcode_lookup",
  "status": "queued",
  "_links": {
    "result": "/tasks/tsk_…/result"
  }
}

非同期APIです。task_idは即時に返ります。ポーリングは1秒あたり1リクエストまでです。

料金

1リクエストあたり$0.002

単価はすべて公開しています。トークン換算や独自クレジットはありません。失敗したタスクは課金されません。

エラー

HTTP	コード	意味
`401`	`unauthorized`	APIキーが無効か、指定されていません。Authorizationヘッダーを確認してください。
`402`	`insufficient_balance`	残高が不足しています。チャージ後に再度お試しください。
`404`	`unknown_type`	指定されたタスクタイプは存在しません。タイプ名を確認してください。
`429`	`rate_limited`	リクエストが多すぎます。しばらく待ってから再度お試しください。

KITの完全なドキュメントを見る →