【9/30㊎予定】「今日は何の日API」ご利用の皆さまへ、バージョン1.0の提供終了と2.0への移行のお知らせ

【注意】本記事は古い情報を含んでいます。「今日は何の日API」の現状は最新記事にてご確認ください。

9月とはいえ残暑厳しい折柄、皆さまいかがお過ごしでしょうか。
早速表題の件ですが、Heroku無料枠の廃止にともない😭、「今日は何の日API」はバージョン2.0に移行いたします。

切り替え期間は2022年9月30日(金)21:00〜23:59の間。

10月1日(土)よりリクエストURL(v1→v2)・データ構造・リクエストのコードが以下のように変わります。また同日以降、旧バージョン(1.0)はご利用いただけなくなりますので、ご注意ください。

import requests
import datetime


today = datetime.date.today()
mmdd = today.strftime('%m%d')

url = "https://wazka.jp/v2/anniv/" + mmdd

r = requests.get(url).json()

print(r['_items'][0]['anniv1'])

#2月14日なら"バレンタインデー"
#値がないパラメータは空文字""を返します

ちなみに、バージョンアップしたからといって、何か新しい機能が付与されるわけではありません。Herokuから引っ越しただけ。レスポンスが向上してリクエストのコードがシンプルになったのが、せめてもの救いです。

基本的な使い方・考え方も旧バージョンと一緒で、それぞれのリクエストURLの末尾に月日(mmdd形式、例えば1月1日なら0101)を加えてリクエストすることで、同日の情報(記念日・MD・誕生花)をJSON形式で返します。WEBでのマーケティング、広報、販促にご利用いただけます。

以下は3種それぞれの説明です。

記念日API

特定の日付に対応する記念日を返すAPI。
祝日・祭日などの情報は含まれません。また例えば「ボージョレ解禁日(11月の第3木曜日)」のように、第○番目の○曜日などとカウントされる記念日も含まれないことにご注意ください。特定の日付に対応する記念日のみ、最大で5つ返します。

リクエストURL

https://wazka.jp/v2/anniv/

レスポンス サンプル

{
  "_count": 1,
  "_last": null,
  "_items": [
    {
      "anniv1": "ポッキー&プリッツの日",
      "anniv2": "介護の日",
      "anniv3": "サッカーの日",
      "anniv4": "くつしたの日",
      "anniv5": "電池の日",
      "key": "316",
      "mmdd": "1111"
    }
  ]
}

レスポンスフィールド

MD販促API

特定の日付に対応するMD(MerchanDising)を返すAPI。
MDカレンダーとして活用可能ですが、52週のカレンダーではないことにご注意ください。日曜や祝祭日の切れ目は明確ではありません。毎年使い回すことを想定しているので、年ごとの気候や時事の変化は考慮に入れない、ざっくりとした構成です。関東地方の比較的小規模なショッピングセンターを想定した内容です。

リクエストURL

https://wazka.jp/v2/md/

レスポンス サンプル

{
  "_count": 1,
  "_last": null,
  "_items": [
    {
      "fashion1": "冬物(プロパー)",
      "fashion2": "",
      "food1": "冬メニュー",
      "food2": "クリスマスメニュー",
      "gift1": "クリスマスギフト",
      "gift2": "お歳暮",
      "key": "316",
      "life1": "クリスマス",
      "life2": "寒さ対策",
      "mmdd": "1111"
    }
  ]
}

レスポンスフィールド

誕生花API

特定の日付に対応する誕生花とその花言葉を返すAPI。

リクエストURL

https://wazka.jp/v2/birthflower/

レスポンス サンプル

{
  "_count": 1,
  "_last": null,
  "_items": [
    {
      "flower": "アジアンタム",
      "key": "316",
      "lang": "天真爛漫",
      "mmdd": "1111"
    }
  ]
}

レスポンスフィールド

Twitterデモアカウント

Twitterでデモアカウントを作成しました。毎日、記念日・MD・誕生花をつぶやいてます。

https://twitter.com/grd09607765

使用例として、レスポンスを検索ワード化して、別のAPIを叩けば、季節のおすすめ商品なども紹介できます。これもデモで実施しています(たまにハズレがありますが)。参考までにご覧ください。

【最後に】利用者へのお願い

ご利用の際は、どちらか1つだけでもご協力、お願いいたします。

お願い1. リンク

ご利用のアカウントから本ページへのリンクをお願いいたします。直リンクでもpowered by whatistodayAPIでも、何でも結構です。

https://note.com/sooz/n/n0f85c8dee503

お願い2. 投げ銭

以下の「気に入ったらサポート」よりお願いします。amazonのリストでも受け付ております。

https://www.amazon.co.jp/hz/wishlist/ls/2XR581SJNMC49/

Heroku無料枠廃止は、個人開発者にとっては悩みの種ですね。私も正直悩みました。有料プランで続けようか…いっそプロジェクトを畳んじゃおうか…。でも自分の個人開発史を思い返すと「初めは無料でやろうとしてたけど、何だかんだで有料になった」というパターンがとても多かったんです。このダメな流れに流されてはダメです。

そういうわけで、もうちょっとがんばってみることにしました。

サービスの安定的な運用と成長のために、応援いただければ幸いです。

2022.9.16　「競馬の日」に　sooz