kenall-js は日本の郵便番号・住所検索APIサービス「ケンオール」のクライアントライブラリです。
APIドキュメントはこちらをご覧ください。
kenall-jsはブラウザでそのまま利用可能なスタンドアロンのJavaScriptバンドルとしても、Node.jsのモジュールとしても利用することができます。
Note
v2.0.0より、Internet Explorerはサポートされなくなりました。
スクリプトを利用するHTMLファイルに
<script type="text/javascript" src="スクリプトバンドルの場所"></script>を記載すると、(以降に読み込まれた<script>タグの中で) windowオブジェクトにkenallオブジェクトが追加され、kenallオブジェクトのKENALLプロパティの値としてKENALLコンストラクタが利用可能になります。コンストラクタに対してnewを適用することで、KENALLオブジェクトを扱うことができるようになります。
スクリプトバンドルは事前にブラウザからアクセス可能な場所にアップロードする必要があることに留意してください。
<script type="text/javascript">
function fill(form) {
// APIキーはダッシュボードから取得してください
const k = new kenall.KENALL('API_KEY_DAYO');
const postalCode = form.elements["postalcode"].value;
k.getAddress(postalCode).then(
function (address) {
const firstCandidate = address.data[0];
form.elements["prefecture"].value = firstCandidate["prefecture"];
}
).catch(function () {
alert("API呼び出しに失敗しました");
});
}
</script>のように利用してください。
なお、最新のスクリプトバンドルのURLとして、以下を使うこともできます。可能な限り問題が発生しないよう配慮しますが、このURLの場所から常にバンドルをダウンロードできるかどうかは保証できません。
以前のバージョン:
- https://js.kenall.jp/2023-01-15/kenall.js
- https://js.kenall.jp/2022-02-11/kenall.js
- https://js.kenall.jp/2021-05-28/kenall.js
- https://js.kenall.jp/2022-11-25/kenall.js
- https://js.kenall.jp/2024-02-09/kenall.js
- https://js.kenall.jp/2024-04-05/kenall.js
プロジェクトのディレクトリで
$ npm i @ken-all/kenall
を実行します。
const { KENALL } = require('@ken-all/kenall');
// APIキーはダッシュボードから取得してください
const api = new KENALL('API_KEY_DAYO');
api.getAddress(postalCode).then(
r => {
console.log(r);
}
).catch(
e => {
console.error(e);
}
);$ npm run build
を実行すると、生成されたjsファイルがdist/配下に出力されます。
$ npm run bundle
を実行すると、ブラウザ向けバンドルファイルがdist/配下に出力されます。
$ npm run test