国内精品久久久久影院日本,日本中文字幕视频,99久久精品99999久久,又粗又大又黄又硬又爽毛片

郵便番號(hào)-住所検索API

郵便番號(hào)データをパラメータに含めてリクエストを送信することで、都道府県、市區(qū)町村のデータをJSONフォーマットで返卻するシンプルなサービスです。
通常のHTTPリクエストAPIに加えて、SDKを利用したJSONPリクエストにも対応しています。詳しくはSDKの項(xiàng)を御覧ください。

データベースを使わず、靜的なファイルベースでのレスポンスなので、割と高速に動(dòng)作します。
利用規(guī)約に同意頂ける方のみご利用ください。また、當(dāng)サイトやAPIに関する質(zhì)問(wèn)はフォームを用意していませんので、@sgmtqq までmensionなど頂ければお答えできると思います。

改訂履歴

APIについて

郵便番號(hào)-住所対応表は、日本郵便サイトで配布されているKEN_ALL.CSVのデータを解析して生成しています。毎月の1日の深夜に対応表を生成しなおしますので、比較的新しいデータで検索が可能です。


リクエストURI

GET https://api.zipaddress.net/

上記URIに以下のパラメータを付加してリクエストを送信して下さい。

パラメータ

パラメータ名 概要 必須/任意 取りうる値と形式 初期値
zipcode 検索したい郵便番號(hào) 必須 xxx-xxxx(ハイフン付き)
またはxxxxxxx(ハイフン無(wú)し7桁)の形式
-
lang 日本語(yǔ)またはローマ字指定 任意 ja または rome ja
callback JSONPリクエストのコールバック関數(shù)
このパラメータを付加したリクエストは、
自動(dòng)的にJSONPリクエストと判別されます。
任意 JavaScriptの関數(shù)名として有効な文字列 -

※リクエスト/レスポンス共に文字コードはUTF-8です。

HTTPリクエスト

通常のHTTPリクエスト(リクエストに"callback"パラメータを含めない)に対しては、JSONデータをそのまま返卻します。

リクエスト:
https://api.zipaddress.net/?zipcode=453-0809
レスポンス:
HTTP/1.1 200 OK
...
Conent-Type: application/json; charset=UTF-8
...

{"code":200,"data":{"pref":"\u611b\u77e5\u770c","address":"\u540d\u53e4\u5c4b\u5e02\u4e2d\u6751\u533a\u4e0a\u7c73\u91ce\u753a","city":"\u540d\u53e4\u5c4b\u5e02\u4e2d\u6751\u533a","town":"\u4e0a\u7c73\u91ce\u753a","fullAddress":"\u611b\u77e5\u770c\u540d\u53e4\u5c4b\u5e02\u4e2d\u6751\u533a\u4e0a\u7c73\u91ce\u753a"}}
            

JSONPリクエスト

"callback"パラメータを含めたリクエストの場(chǎng)合、JavaScriptの実行形式でレスポンスが返卻されます。

リクエスト:
https://api.zipaddress.net/?zipcode=453-0809&callback=sample
レスポンス:
HTTP/1.1 200 OK
...
Content-Type: application/javascript; charset=UTF-8
...

sample({"pref":"\u611b\u77e5\u770c","address":"\u540d\u53e4\u5c4b\u5e02\u4e2d\u6751\u533a\u4e0a\u7c73\u91ce\u753a","city":"\u540d\u53e4\u5c4b\u5e02\u4e2d\u6751\u533a","town":"\u4e0a\u7c73\u91ce\u753a","fullAddress":"\u611b\u77e5\u770c\u540d\u53e4\u5c4b\u5e02\u4e2d\u6751\u533a\u4e0a\u7c73\u91ce\u753a"}, false);
            

※レスポンスはUnicode形式にエンコードされています。

HTTPリクエスト

プロパティ名 概要 データ形式 備考
code ステータスコード "200"などの數(shù)値文字列 -
data 実際の返卻データ Object
  • pref: 都道府県の文字列
  • city: 市區(qū)町村の文字列
  • town: 町域名の文字列
  • address: 市區(qū)町村の文字列(cityとtownを結(jié)合したもの)
  • fullAddress: 都道府県+市區(qū)町村+町域名の結(jié)合文字列
message リクエスト失敗時(shí)のメッセージ 文字列 codeプロパティが"200"以外の場(chǎng)合にのみセットされます

APIはリクエストに対して全て200を返卻するので、住所が見(jiàn)つかった、もしくはエラーなどの判定は、レスポンスのcodeプロパティにより判定してください。


JSONPリクエスト

callbackパラメータを?qū)g行する形式で返卻されます。callback関數(shù)は以下の様な引數(shù)を2つ渡す形式で実行されます:

callback(object response, boolean err);

それぞれの引數(shù)は、以下のようなデータを取ります。

引數(shù) データ
response 住所データのオブジェクト(HTTPリクエストの場(chǎng)合のdataプロパティの値と同じ)。
住所が見(jiàn)つからない、またはエラーの場(chǎng)合はcode,messageをプロパティに持つオブジェクト
err エラーが発生したかどうか。住所が見(jiàn)つかった(成功した)場(chǎng)合はfalse、住所が見(jiàn)つからなかった、またはエラーの場(chǎng)合はtrue

コールバック関數(shù)のハンドリングについてはSDKの項(xiàng)も參考にしてください。

APIリクエストサンプル

郵便番號(hào)453-0809に該當(dāng)する住所を検索し、JSONフォーマットでレスポンスを受け取ります。

リクエスト
https://api.zipaddress.net/?zipcode=4530809
レスポンス
{
  "code":200,
  "data":{
    "pref":"\u611b\u77e5\u770c",
    "address":"\u540d\u53e4\u5c4b\u5e02\u4e2d\u6751\u533a\u4e0a\u7c73\u91ce\u753a",
    "city":"\u540d\u53e4\u5c4b\u5e02\u4e2d\u6751\u533a",
    "town":"\u4e0a\u7c73\u91ce\u753a",
    "fullAddress":"\u611b\u77e5\u770c\u540d\u53e4\u5c4b\u5e02\u4e2d\u6751\u533a\u4e0a\u7c73\u91ce\u753a"
  }
}
            

JSONPリクエストサンプル

郵便番號(hào)453-0809に該當(dāng)する住所を検索し、JSONデータを引數(shù)にコールバック関數(shù)sampleを?qū)g行します。

リクエスト
https://api.zipaddress.net/?zipcode=4530809&callback=sample
レスポンス
sample({
  "pref":"\u611b\u77e5\u770c",
  "address":"\u540d\u53e4\u5c4b\u5e02\u4e2d\u6751\u533a\u4e0a\u7c73\u91ce\u753a",
  "city":"\u540d\u53e4\u5c4b\u5e02\u4e2d\u6751\u533a",
  "town":"\u4e0a\u7c73\u91ce\u753a",
  "fullAddress":"\u611b\u77e5\u770c\u540d\u53e4\u5c4b\u5e02\u4e2d\u6751\u533a\u4e0a\u7c73\u91ce\u753a"
}, false);
            
コールバック関數(shù)sample
window.sample = function(obj, err) {
  if ( err ) {
    return alert(obj.message); // エラー表示
  }
  
  // 住所表示処理
  document.querySelector('[name=pref]').value    = obj.pref;
  document.querySelector('[name=address]').value = obj.address;
};
            

SDKについて

JSONPリクエストを簡(jiǎn)便にするJavaScript SDKを利用することができます。

SDKの読み込み

以下のURIからJavaScriptファイルを読み込みます。

https://api.zipaddress.net/sdk/zipaddr.min.js

SDKが使用する名前空間

SDKが読み込まれると、「window.ZA」というモジュールが作られます。名前空間の衝突に注意してください。

SDKを使ったJSONPリクエスト

郵便番號(hào)送信のシンプルなリクエストと、要素を指定するお任せなリクエストと2パターンが利用できます。

シンプルなリクエスト(コールバック処理を自分でやりたい方向け)

引數(shù)に郵便番號(hào)とコールバック関數(shù)を渡すだけの簡(jiǎn)単なリクエストです。その代わり、エラー処理や取得した住所データのセットは自分でやらないといけません。
郵便番號(hào)の呼び出しにフックして、何か処理を挾みたい時(shí)にはこちらの方法をオススメします。

サンプルコード
// jQueryなら$とかやってください
document.addEventListener('DOMContentLoaded', function() {
  
  // 検索ボタンなど
  var btn = document.getElementById('zipaddr');
  // 郵便番號(hào)データ
  var zipcode = document.getElementById('zipcode');

  // クリックイベントでリクエスト
  btn.addEventListener('click', function() {
    // リクエスト
    ZA.request(zipcode.value, function(data, err) {
      // エラーがあったか見(jiàn)つからない
      if ( err ) {
        return alert(data.message);
      }

      // データセット
      document.getElementById('address').value = data.fullAddress;
    });
  });
}, false);
            

ZA.request()がSDKリクエストを行う部分です。ページ內(nèi)に複數(shù)検索ブロックがあっても動(dòng)作します。詳しくはSDKリファレンスを參照して下さい。

お任せリクエスト(自動(dòng)的にセットまでしたい方向け)

AjaxZip2みたいに最初にセットする要素などのパラメータをセットしてイベント監(jiān)視するタイプです。こちらも複數(shù)ブロックに対しても動(dòng)作可能です。

お任せリクエストの場(chǎng)合、city及びtownの値は使用できません。

サンプルコード
// jQueryなら$とかやってください
document.addEventListener('DOMContentLoaded', function() {
  
  // 検索ボタンなど
  var btn = document.getElementById('zipaddr');

  // リクエストハンドル生成
  var handle = ZA.register({
                 zip1    : ZA.node('zip1'),
                 zip2    : ZA.node('zip2'),
                 pref    : ZA.node('pref'),
                 address : ZA.node('address')
              });
  // イベント監(jiān)視
  handle.event(btn, 'click');

}, false);
            

ZA.register()でアプリケーションセットを生成します。引數(shù)はハッシュのみ受け付けます。パラメータの種類はSDKリファレンスを參照して下さい。

リファレンス

ZAモジュールについてのメソッドとパラメータ詳細(xì)です。


HTMLElement/null ZA.node(string id/name)

  引數(shù)の文字列をid、またはnameとして持つ要素を取得します。優(yōu)先順位はid→nameです。見(jiàn)つかった場(chǎng)合は要素を、見(jiàn)つからなければnullが戻ります。


object ZipAddr ZA.register(object params)

  引數(shù)に渡したパラメータに従ったZipAddrインスタンスを生成します。引數(shù)によって挙動(dòng)を変更することができます。

パラメータ名概要設(shè)定可能な値デフォルト値
zipMode郵便番號(hào)の取得モードseparate(3桁-4桁分離型)またはcombi(一體型)separate
addrMode取得した住所のセットモードseparate(都道府県-住所分離型)またはcombi(一體型)separate
zip1郵便番號(hào)上3桁入力要素HTMLElementまたはnull
zipModeがseparateの場(chǎng)合は必須
null
zip2郵便番號(hào)下4桁入力要素HTMLElementまたはnull
zipModeがseparateの場(chǎng)合は必須
null
zip郵便番號(hào)全桁入力要素HTMLElementまたはnull
zipModeがcombiの場(chǎng)合は必須
null
pref都道府県入力要素HTMLElementまたはnull
addrModeがseparateの場(chǎng)合は必須
null
address住所入力要素HTMLElementまたはnull
addrModeがseparateの場(chǎng)合は必須
null
lang日本語(yǔ)/ローマ字jaまたはromeja

指定したモードによって、要素の検証が行われます。zipModeまたはaddrModeに対応したパラメータがnullの場(chǎng)合は例外が投げられます。

また、生成されたインスタンスに対して、event()メソッドで検索のトリガーを指定します。

  ZipAddr.event(HTMLElement element, string eventType)

    第一引數(shù)にトリガーとなる要素、第二引數(shù)に起動(dòng)イベント名を指定します。


void ZA.request(string zipCode, function callback[, string lang])

  zipCodeを元に住所を検索し、callbackが実行されます。langには日本語(yǔ)/ローマ字を指定できます。

APIのTLSバージョンについて

HTTPSの設(shè)定見(jiàn)直し、また各種ブラウザの警告表示を受けてTLSv1.2のみを許可するように変更しました。

これにより、SSLv2/SSLv3で接続するようなクライアント、または古いOpenSSLのバージョンを利用しているクライアントからは接続できなくなる可能性があります。予めご了承ください。

PHPではバージョンに依りますが file_get_contents()で警告が出て失敗するという報(bào)告も頂いています。CURL、またはHTTPクライアントライブラリをご利用ください。

CURLでのAPIコールの例
<php

$handle = curl_init("https://api.zipaddress.net?zipcode=900-0012");
curl_setopt($handle, CURLOPT_SSLVERSION, CURL_SSLVERSION_TLSv1);
curl_setopt($handle, CURLOPT_RETURNTRANSFER, true);

$result = curl_exec($handle);
curl_close($handle);

echo $result;
	  

APIご利用規(guī)約

以下の規(guī)約に同意頂ける方のみご利用下さい。また、當(dāng)サイトのサービスを利用した時(shí)點(diǎn)で規(guī)約に同意したものと致します。

  • 個(gè)人?法人?商用?非商用問(wèn)わず無(wú)料でご利用頂けます。リンクなどの設(shè)置も必要ありません。
  • 當(dāng)サイトのコンテンツの無(wú)斷転用は禁止です。また、ファイルの二次配布なども禁止です。
  • APIリクエストに対するレスポンスはベストエフォートです。100%のレスポンスを保証するものではありません。
  • 當(dāng)サイト內(nèi)のサービスを使用したことによる一切の損害等に対し責(zé)任を負(fù)いません。
  • 當(dāng)サイト內(nèi)のサービスが使用できなくなったことによる一切の損害等に対し責(zé)任を負(fù)いません。
  • 作者の都合により、公開(kāi)を中止する場(chǎng)合があります。

基本的に勉強(qiáng)のために作成したものです。何卒ご了承下さい。