旧暦、六曜を取得できるAPIを無料で提供しています。 |
|
|
|
■ 障害が発生していました
レンタルサーバーさんがサーバーを移転してくれたようですが
仕様が大きく変わり、動かなくなっていました
サンプルも修正しています(文字コードの処理が無くなっただけですが)
|
|
■ 暦APIとは
リクエストされた日付の 旧暦、十二支、十支、節気、六曜等の情報をjsonデータを提供します。
使用料金は必要ありません。 無償での提供になります。
|
|
■ 仕様
・リクエストURL
https://koyomi.zingsystem.com/api/
https://koyomi.zing2.org/api/(2022年5月ぐらいで廃止するかもしれません 上記に変更しておいてください)
|
・リクエストパラメータ
パラメータ名 |
項目名 |
必須 |
備考 |
mode |
取得区分 |
○ |
d:日単位 、 m:月単位 |
cnt |
取得数 |
○ |
取得区分=d 取得する日数 1~365が指定可能
取得区分=m 取得する月数 1~12が指定可能
|
targetyyyy |
年 |
○ |
yyyy
*1~2200までが指定可能です。
|
targetmm |
月 |
○ |
mm |
targetdd |
日 |
△ |
dd 取得区分がdの場合のみ必須 mの場合は無視 |
・レスポンス
フィールド名 |
項目名 |
必須 |
備考 |
datelist |
日付リスト |
○ |
yyyy-mm-dd 形式 |
以下日付ごとに配列 |
|
week |
曜日 |
○ |
月 火 水 木 金 土 日(ツェラーの公式使用) |
|
inreki |
陰暦 |
○ |
"睦月", "如月", "弥生", "卯月", "皐月", "水無月","文月", "葉月", "長月", "神無月", "霜月", "師走" |
|
zyusi |
十支 |
○ |
"甲","乙","丙","丁","戊","己","庚","辛","壬","癸" |
|
zyunisi |
十二支 |
○ |
"子","丑","寅","卯","辰","巳","午","未","申","酉","戌","亥" |
|
eto |
干支 |
○ |
"子","丑","寅","卯","辰","巳","午","未","申","酉","戌","亥" |
|
gengo |
元号 |
○ |
"令和","平成","昭和","大正","明治" |
|
wareki |
和暦 |
○ |
|
|
sekki |
節気 |
|
"春分","清明","穀雨","立夏","小満","芒種","夏至","小暑","大暑","立秋","処暑","白露", "秋分","寒露","霜降","立冬","小雪","大雪","冬至","小寒","大寒","立春","雨水","啓蟄" |
|
kyurekiy |
旧暦 年 |
○ |
|
|
kyurekim |
旧暦 月 |
○ |
|
|
kyurekid |
旧暦 日 |
○ |
|
|
rokuyou |
六曜 |
○ |
"大安","赤口","先勝","友引","先負","仏滅" |
|
holiday |
祝日 |
|
1948年~2045年まで |
・サンプルレスポンス
{
"datelist":{
"2015-12-01":{
"week":"火",
"inreki":"師走",
"zyusi":"辛",
"zyunisi":"亥",
"eto":"未",
"gengo":"平成",
"wareki":27,
"sekki":"",
"kyurekiy":2015,
"kyurekim":10,
"kyurekid":20,
"rokuyou":"大安",
"holiday":""
},
"2015-12-02":{
"week":"水",
"inreki":"師走",
"zyusi":"壬",
"zyunisi":"子",
"eto":"未",
"gengo":"平成",
"wareki":27,
"sekki":"",
"kyurekiy":2015,
"kyurekim":10,
"kyurekid":21,
"rokuyou":"赤口",
"holiday":""
}
}
}
|
・エラー
フィールド名 |
項目名 |
必須 |
備考 |
err |
エラーコード |
○ |
400:必須エラー
401:パラメータ値エラー
|
mes |
エラーメッセージ |
○ |
|
・サンプルレスポンス
{
"err":400,
"mes":"必須パラメータが指定されていません。"
}
|
|
|