半角変換 公開API

エンドポイント

• 全角の英数字・記号・スペース・カタカナを半角へ変換します。
• ひらがな・漢字など、変換対象外の文字はそのまま返します。
• 入力上限はUTF-8で20,000バイトです。
• レスポンス形式はJSON、文字コードはUTF-8です。
• CORSに対応しているため、ブラウザのJavaScriptからも呼び出せます。

利用方法

GET（手軽な呼び出し）

curl --get 'https://hankaku.jp/api/convert' \
  --data-urlencode 'text=Ｈｅｌｌｏ　１２３！　カタカナ'

POST（JSON・推奨）

curl 'https://hankaku.jp/api/convert' \
  -H 'Content-Type: application/json' \
  --data '{"text":"Ｈｅｌｌｏ　１２３！　カタカナ"}'

JavaScript

const response = await fetch('https://hankaku.jp/api/convert', {
  method: 'POST',
  headers: { 'Content-Type': 'application/json' },
  body: JSON.stringify({ text: 'Ｈｅｌｌｏ　１２３！　カタカナ' })
});

const data = await response.json();
console.log(data.result); // Hello 123! ｶﾀｶﾅ

Python

import requests

response = requests.post(
    'https://hankaku.jp/api/convert',
    json={'text': 'Ｈｅｌｌｏ　１２３！　カタカナ'}
)
response.raise_for_status()
print(response.json()['result'])

レスポンス

成功時

{
  "success": true,
  "result": "Hello 123! ｶﾀｶﾅ",
  "input": {
    "characters": 15,
    "bytes": 45
  }
}

エラー時

{
  "success": false,
  "error": {
    "code": "MISSING_TEXT",
    "message": "クエリパラメータ \"text\" を指定してください。"
  }
}

主なHTTPステータス

利用ルール

• 個人利用・商用利用のどちらでも利用できます。
• APIキーおよび利用申請は不要です。
• サービスへ過度な負荷を与える大量・連続アクセスは禁止します。必要に応じてアクセスを制限または遮断する場合があります。
• 違法行為、攻撃、迷惑行為、第三者の権利侵害を目的とした利用は禁止します。
• API自体を自分のサービスとして再販売する行為は禁止します。
• 可用性や変換結果を保証するSLAはありません。保守などにより予告なく停止する場合があります。
• 仕様・入力上限・利用ルールは、運用上必要な場合に変更されることがあります。

プライバシーと安全な利用

パスワード、APIキー、個人情報、秘密情報などは送信しないでください。GETでは入力文字列がURLに含まれるため、通常はPOSTの利用をおすすめします。

不正利用対策や障害調査のため、アクセス情報がホスティング事業者のログに記録される場合があります。