本文へ移動

変更履歴

サービスの版は、serverInfo.version(MCP)と info.version(OpenAPI)で分かります。日付は日本時間です。1.0より前は、マイナーバージョンで項目名が変わることがあります。そのような変更には 変更 と付けています。

  • 修正: RESTのリストの項目(extra_holidays など)を、同じ名前で繰り返せるようにしました(a=1&a=2)。これまでは、最後の値だけが使われ、誤った答えが、エラーなしで返っていました。そのほかの項目の繰り返しは、最後の値を黙って使わずに、400(invalid_input)にします。__proto__ のような名前も、MCPと同じく、知らない項目として断ります。
  • 修正: normalize_address が、先頭に「字」「大字」の付いた町域(例:与那国町字与那国)に合うようになりました。これまでは、市区町村までしか合いませんでした。省いたことは、答えの notes に書きます。
  • 変更: 404・405 の答えに type(not_found・method_not_allowed)が付きます。OpenAPIの Error.type にも、rate_limited・not_found・method_not_allowed を足しました。
  • 変更: 和暦のRESTの道筋は /v1/japanese-era/to-era(西暦→和暦)と /v1/japanese-era/from-era(和暦→西暦)になりました。和暦の答えの項目は、入力のとおりの input_era・input_era_year と、正しい和暦の actual です。0.8.0 では to-date / from-date でした。
  • from_japanese_era が、末尾の曜日((水)・水曜日)とローマ字の元号名(Reiwa 8.10.7)を読みます。曜日が合わないと weekday_mismatch が付きます。おかしな漢数字と200を超える年は、入力の誤りです。
  • list_holidays が total・returned・truncated を返します(count は当面残します)。
  • 運用:公開中のデータより古いデータでは公開しません。毎月の更新を3日と10日に動かします。新しさの限度(郵便番号60日・法人番号50日)を、公開前の関門と公開中の確認でそろえました。国税庁からのダウンロードに時間切れを設けました。
  • 追加: to_japanese_era と from_japanese_era。元号の初日は、大正 1912-07-30、昭和 1926-12-25、平成 1989-01-08、令和 2019-05-01。1873-01-01から対応します。元号の範囲の外の日付は変換して outside_era で知らせ、現在の元号での将来の日付には assumes_current_era が付きます。
  • 追加: すべての答えに、機械が読める flags(estimated・unverified・truncated・not_found・closed・excluded_from_search・exact_match_only・partial・ambiguous・city_not_found・ambiguous_city)。
  • 変更: 一覧は total / returned / truncated(search_corporation_by_name は count → total)。法人の閉鎖は is_closed(名前の検索の closed から改名し、番号の照会にも追加)。check_business_day が reason_code(weekend・holiday・bank_closure・extra_holiday)を返す。normalize_address が、いつも address・municipality_code・city_candidates を返す。
  • エラーの文で、入力の誤り(Invalid input)とサーバー側の問題(Server error)を分けました。RESTは type も返します。
  • 毎週の確認で、データの新しさも確かめます。
  • MCPの instructions に、ツールの使い分けと、法人番号の出典の示し方を書きました。search_postal_code で town が0件のときの案内を足しました。
  • 追加: search_corporation_by_name(国税庁のデータの前方一致の検索)。
  • 追加: lookup_corporate_number(国税庁の全件データ。PDL1.0の表示つき)。
  • 追加: normalize_address(町域まで)。
  • 郵便番号の照会が、日本郵便の大口事業所の個別番号にも対応しました(offices、office_name での検索)。
  • 追加: lookup_postal_code と search_postal_code。公開を自動にしました。
  • 最初の版:暦の6ツール(list_holidays・check_business_day・add_business_days・count_business_days・adjust_to_business_day・last_business_day_of_month)を、MCPとRESTで。

運営:Momonga