請求先住所参照API（BillingAddressAPI）

2021年8月3日をもちましてYahoo! ID連携 v1の新規の登録を終了いたしました。
2022年4月27日にYahoo! ID連携 v1の利用を終了いたしますのでv2への移行が必要です。
v2の移行方法はこちらよりご確認ください。

請求先住所参照API（BillingAddressAPI）

このAPIを利用するためにはYahoo!ウォレット FastPayの本番申し込みが必要です。

BillingAddress APIは、Yahoo!ウォレットに登録されているユーザーの住所情報を取得できる属性情報取得APIです。ユーザーがYahoo!ウォレットに登録されていない場合、Yahoo! Japan IDに登録されている住所情報を返却します。
BillingAddress APIにリクエストを送るためには利用申請が必要です。Yahoo!ウォレット FastPayのこちらを参照いただき、ステップにそって導入ください。
ウェブAPI共通で利用するアクセストークンのリクエスト方法およびエラーレスポンスの仕様については、APIアクセス実装方法を参照してください。

リクエスト

URL： https://fastpay.yahooapis.jp/v1/address
サポートするHTTPメソッド： GET

サンプルリクエスト

GET /v1/address HTTP/1.1
Host: fastpay.yahooapis.jp
Authorization: Bearer 2OBRckZjTT5a3aKD......(中略).........mT1oULUNOuUlw3

レスポンス

HTTPコード

200

レスポンスパラメーター

サンプルレスポンス

HTTP/1.1 200 OK
Content-Type: application/json

{
  "given_name#ja-Kana-JP": "タロウ",
  "given_name#ja-Hani-JP": "太郎",
  "family_name#ja-Kana-JP": "ヤフウ",
  "family_name#ja-Hani-JP": "矢風",
  "address": {
    "postal_code": "1076211",
    "region": "東京都",
    "locality": "港区",
    "street_address": "赤坂９ー７ー１ミッドタウン・タワー１Ｆ",
    "street_address_block": "赤坂９ー７ー１",
    "street_address_building": "ミッドタウン・タワー１Ｆ",
  }
  "phone_number": "00012345678"
}

エラーレスポンス

access_tokenが無効の場合は以下のレスポンスを返します。

HTTP/1.1 401 Authorization Required
Content-Type: application/json

{
  "Error": {
    "Message": "Please provide valid credentials. Bearer realm=\"yahooapis.jp\", error=\"invalid_token\", error_description=\"expired token\""
  }
}

その他エラーについてはこちらをご確認ください。

よくある質問（FAQ）

属性情報が空で返却されます。

ユーザーが未登録のデータについては空文字列として返却されます。