今日は何の日API リファレンス



「今日は何の日API」は4種のAPIの総称です。


・記念日API

・MD販促API

・誕生花API

・偉人誕生日API

4種ともシンプルな構造で、それぞれのリクエストURLの末尾に月日(mmdd形式、例えば1月1日なら0101)を足してリクエストすることで、同日の情報(記念日・MD・誕生花・偉人誕生日)をJSON形式で返します。WEBでのマーケティング、広報、販促にご利用いただけます。




記念日API


特定の日付に対応する記念日を返すAPI。


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


リクエストURL

https://api.k9r06rlu.me/v3/anniv/


レスポンス サンプル
  • {
  •   "id": 316,
  •   "mmdd": "1111",
  •   "anniv1": "ポッキー&プリッツの日",
  •   "anniv2": "介護の日",
  •   "anniv3": "サッカーの日",
  •   "anniv4": "くつしたの日",
  •   "anniv5": "電池の日"
  • }
レスポンスフィールド
パラメータ 項目名 型 説明
id ID 整数 各項目に割り当てられた一意の整数。
mmdd 月日 文字列(UTF8) 各項目の日付。
anniv1 記念日1 文字列(UTF8) 特定の日付に対応する記念日。
anniv2 記念日2 文字列(UTF8) 特定の日付に対応する記念日。
anniv3 記念日3 文字列(UTF8) 特定の日付に対応する記念日。
anniv4 記念日4 文字列(UTF8) 特定の日付に対応する記念日。
anniv5 記念日5 文字列(UTF8) 特定の日付に対応する記念日。


MD販促API


特定の日付に対応するMD(MerchanDising)を返すAPI。

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


リクエストURL

https://api.k9r06rlu.me/v3/md/


レスポンス サンプル
  • {
  •   "id": 316,
  •   "mmdd": "1111",
  •   "fashion1": "冬物(プロパー)",
  •   "fashion2": "",
  •   "life1": "クリスマス",
  •   "life2": "寒さ対策",
  •   "gift1": "クリスマスギフト",
  •   "gift2": "お歳暮",
  •   "food1": "冬メニュー",
  •   "food2": "クリスマスメニュー"
  • }
レスポンスフィールド
パラメータ 項目名 型 説明
id ID 整数 各項目に割り当てられた一意の整数。
mmdd 月日 文字列(UTF8) 各項目の日付。
fashion1 ファッション1 文字列(UTF8) ファッション商品。春物・夏物・秋物・冬物それぞれのプロパー・セール時期。
fashion2 ファッション2 文字列(UTF8) ファッション商品。"fashion1"と重なる、初夏物・初秋物の時期。
life1 生活1 文字列(UTF8) 生活雑貨など。クリスマス商戦・新生活商戦など。
life2 生活2 文字列(UTF8) 生活雑貨など。"life1"と重なる、暑さ対策・寒さ対策グッズの商戦など。
gift1 ギフト1 文字列(UTF8) ギフト商戦。バレンタイン・ホワイトデー・父の日・母の日などの時期。
gift2 ギフト2 文字列(UTF8) ギフト商戦。"gift1"と重なる、お歳暮・お中元など。予約も含めた時期。
food1 食品1 文字列(UTF8) 食品。春・夏・秋・冬の限定メニューの販売時期。
food2 食品2 文字列(UTF8) 食品。"food1"と重なる、恵方巻やクリスマスメニューなど。予約も含めた時期。


誕生花API


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


リクエストURL

https://api.k9r06rlu.me/v3/birthflower/


レスポンス サンプル
  • {
  •   "id": 316,
  •   "mmdd": "1111",
  •   "flower": "アジアンタム",
  •   "lang": "天真爛漫"
  • }
レスポンスフィールド
パラメータ 項目名 型 説明
id ID 整数 各項目に割り当てられた一意の整数。
mmdd 月日 文字列(UTF8) 各項目の日付。
flower 誕生花 文字列(UTF8) 誕生花の名称。
lang 花言葉 文字列(UTF8) 誕生花の花言葉。


偉人誕生日API


特定の日付に対応する偉人の名前と、プロフィールを返すAPI。


リクエストURL

https://api.k9r06rlu.me/v3/famousbirthday/


レスポンス サンプル
  • {
  •   "id": 316,
  •   "mmdd": "1111",
  •   "lifespan": "1821-1881",
  •   "name": "フョードル・ドストエフスキー"
  •   "profile": "ロシアの作家"
  • }
レスポンスフィールド
パラメータ 項目名 型 説明
id ID 整数 各項目に割り当てられた一意の整数。
mmdd 月日 文字列(UTF8) 各項目の日付。
lifespan 生没年 文字列(UTF8) 偉人の生没年。
name 名前 文字列(UTF8) 偉人の名前。
profile プロフィール 文字列(UTF8) 偉人の簡単な紹介。


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


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


お願い1. リンク

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

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


お願い2. 投げ銭

上記noteリンク先の「気に入ったらサポート」、もしくは以下のamazonのリストよりお願いします。

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



2024.9.9 「救急の日」に sooz



© 2022 SOOZ All rights reserved.