1. 日历-查黄历（almanacs-almancInfo）

1.1 请求

黄历运势查询

请求报文样例：

  1. {
  2.   "slots": {
  3.     "beginDate": {
  4.       "name": "beginDate",
  5.       "slotType": "string",
  6.       "values": [
  7.         {"real":"2019-01-07"}
  8.       ]
  9.     },
  10.     "endDate": {
  11.       "name": "endDate",
  12.       "slotType": "string",
  13.       "values": [
  14.         {"real":"2019-01-08"}
  15.       ]
  16.     }
  17.   }
  18. }

成员名称描述是否必选类型取值范围
beginDate起始时间否DateFormatString/
endDate结束时间，与起始时间间隔不得超过100天。否DateFormatString/

1.2 响应

查询一段时间内每天的黄历信息。

响应报文样例：

  1. {
  2.     "almanacInfo": [{
  3.             "yangli": "2018-10-17",
  4.             "nongli": "二零一八年九月初九",
  5.             "ganzhi": "戊戌年 壬戌月 壬午日",
  6.             "shengxiao": "狗",
  7.             "yi": "造车器 嫁娶 订盟 纳采",
  8.             "ji": "搬家 出行",
  9.             "riwuxing": "井泉水 建执位",
  10.             "chongsha": "冲羊(丁未)煞东",
  11.             "baiji": "丑不冠带",
  12.             "jishen": "岁德合,季分,金堂,三合,四相,天恩,月恩",
  13.             "xiongshen": "白虎中,勾陈,官符,时阴,死气,横天,木马,死符",
  14.             "xingxiu28": "毕月乌宿星",
  15.             "zhishen": "勾陈",
  16.             "taishen": "厨灶栖外正南",
  17.             "shen12": "除执位",
  18.             "caishen": "正东",
  19.             "xishen": "正东",
  20.             "fushen": "正东",
  21.             "zi": "凶",
  22.             "chou": "凶",
  23.             "yin": "凶",
  24.             "mao": "凶",
  25.             "chen": "凶",
  26.             "si": "凶",
  27.             "wu": "吉",
  28.             "wei": "吉",
  29.             "you": "吉",
  30.             "xu": "吉",
  31.             "hai": "吉",
  32.             "shen": "凶",
  33.             "xdwURL": "https://aaa.bbb.ccc/index.html"
  34.         },
  35.         {
  36.             "yangli": "2018-10-18",
  37.             "nongli": "二零一八年九月初九",
  38.             "ganzhi": "戊戌年 壬戌月 壬午日",
  39.             "shengxiao": "狗",
  40.             "yi": "造车器 嫁娶 订盟 纳采",
  41.             "ji": "搬家 出行",
  42.             "riwuxing": "井泉水 建执位",
  43.             "chongsha": "冲羊(丁未)煞东",
  44.             "baiji": "丑不冠带",
  45.             "jishen": "岁德合,季分,金堂,三合,四相,天恩,月恩",
  46.             "xiongshen": "白虎中,勾陈,官符,时阴,死气,横天,木马,死符",
  47.             "xingxiu28": "毕月乌宿星",
  48.             "zhishen": "勾陈",
  49.             "taishen": "厨灶栖外正南",
  50.             "shen12": "除执位",
  51.             "caishen": "正东",
  52.             "xishen": "正东",
  53.             "fushen": "正东",
  54.             "zi": "凶",
  55.             "chou": "凶",
  56.             "yin": "凶",
  57.             "mao": "凶",
  58.             "chen": "凶",
  59.             "si": "凶",
  60.             "wu": "吉",
  61.             "wei": "吉",
  62.             "you": "吉",
  63.             "xu": "吉",
  64.             "hai": "吉",
  65.             "shen": "凶",
  66.             "xdwURL": "https://aaa.bbb.ccc/index.html"
  67.         },
  68.         {
  69.             "yangli": "2018-10-19",
  70.             "nongli": "二零一八年九月初九",
  71.             "ganzhi": "戊戌年 壬戌月 壬午日",
  72.             "shengxiao": "狗",
  73.             "yi": "造车器 嫁娶 订盟 纳采",
  74.             "ji": "搬家 出行",
  75.             "riwuxing": "井泉水 建执位",
  76.             "chongsha": "冲羊(丁未)煞东",
  77.             "baiji": "丑不冠带",
  78.             "jishen": "岁德合,季分,金堂,三合,四相,天恩,月恩",
  79.             "xiongshen": "白虎中,勾陈,官符,时阴,死气,横天,木马,死符",
  80.             "xingxiu28": "毕月乌宿星",
  81.             "zhishen": "勾陈",
  82.             "taishen": "厨灶栖外正南",
  83.             "shen12": "除执位",
  84.             "caishen": "正东",
  85.             "xishen": "正东",
  86.             "fushen": "正东",
  87.             "zi": "凶",
  88.             "chou": "凶",
  89.             "yin": "凶",
  90.             "mao": "凶",
  91.             "chen": "凶",
  92.             "si": "凶",
  93.             "wu": "吉",
  94.             "wei": "吉",
  95.             "you": "吉",
  96.             "xu": "吉",
  97.             "hai": "吉",
  98.             "shen": "凶",
  99.             "xdwURL": "https://aaa.bbb.ccc/index.html"
  100.         }
  101.     ]
  102. }

成员名称描述是否必选类型取值范围
almanacInfo/是AlmanacInfoItem[]最大Item数：100

1.3 结构

AlmanacInfoItem：

成员名称描述是否必选类型取值范围
yangli阳历日期阳历日期（日期，格式如：2018-10-01。对应查询时间范围的每一天）是DateFormatString/
nongli农历日期农历日期。如：二零一八年八月(大)初九。是string最大长度：64
ganzhi干支干支。如：戊戌狗年 辛酉月 辛酉日。是string最大长度：128
shengxiao生肖生肖（如：狗）是string最大长度：8
yi黄历运势（宜），多个时空格分隔。如：沐浴 破屋 治病。是string最大长度：128
ji黄历运势（忌），多个时空格分隔。如：搬家 结婚。是string最大长度：128
riwuxing日五行日五行，多个时空格分隔。如井泉水 建执位是string最大长度：64
chongsha冲煞冲煞。 如：冲羊（丁未）煞东。是string最大长度：64
baiji彭祖百忌，多个时空格分隔。如：癸不词讼 丑不冠带是string最大长度：128
jishen吉神宜趋，多个时逗号分隔。如：岁德合，季分，金堂，三合，四相，天恩，月恩。是string最大长度：128
xiongshen凶神宜忌，多个时逗号分隔。如：白虎中，勾陈，官符，时阴，死气，横天，木马，死符。是string最大长度：128
xingxiu28二十八星宿。如：毕月乌宿星是string最大长度：64
zhishen值神。如：勾陈（黑道日）是string最大长度：64
taishen胎神。如：厨灶栖外正南是string最大长度：64
shen12十二神。如：除执位是string最大长度：64
caishen诸神方位（财神）。如：正东是string最大长度：32
xishen诸神方位（喜神）。如：正东是string最大长度：32
fushen诸神方位（福神）。如：正东是string最大长度：32
zi时辰宜忌（子时）是string枚举值： 凶，吉
chou时辰宜忌（丑时）是string枚举值： 凶，吉
yin时辰宜忌（寅时）是string枚举值： 凶，吉
mao时辰宜忌（卯时）是string最大长度：128
chen时辰宜忌（辰时）是string枚举值： 凶，吉
si时辰宜忌（巳时）是string枚举值： 凶，吉
wu时辰宜忌（午时）是string枚举值： 凶，吉
wei时辰宜忌（未时）是string枚举值： 凶，吉
shen时辰宜忌（申时）是string枚举值： 凶，吉
you时辰宜忌（酉时）是string枚举值： 凶，吉
xu时辰宜忌（戌时）是string枚举值： 凶，吉
hai时辰宜忌（亥时）是string枚举值： 凶，吉
xdwURL现代文h5 URL， 跳转至黄历详情。是string最大长度：256

2. 日历-查假期（holiday-holidayInfo）

2.1 请求

查假期

请求报文样例：

  1. {
  2.     "slots": {
  3.         "holidayName": {
  4.             "name": "holidayName",
  5.             "slotType": "string",
  6.             "values": [{
  7.                 "real": "国庆节"
  8.             }]
  9.         },
  10.         "datetime": {
  11.             "name": "datetime",
  12.             "slotType": "string",
  13.             "values": [{
  14.                 "real": "5月20日"
  15.             }]
  16.         },
  17.         "next": {
  18.             "name": "next",
  19.             "slotType": "string",
  20.             "values": [{
  21.                 "real": "最近一次"
  22.             }]
  23.         },
  24.         "category": {
  25.             "name": "category",
  26.             "slotType": "string",
  27.             "values": [{
  28.                 "real": "法定假日"
  29.             }]
  30.         }
  31.     }
  32. }

成员名称描述是否必选类型取值范围
holidayName指定假期名（参数至少任选一个，可多个。）否string最大长度： 32
datetime年份，月份（参数至少任选一个，可多个。），如5月1日或者2019年5月1日。否string最大长度： 32
next最近、下一次、近来、近期、最近一次等说法（参数至少任选一个，可多个。）否string枚举值：  最近， 下一次， 近期， 最近一次
category节假日类型（法定假日；节日）（参数至少任选一个，可多个。）否string最大长度： 32

2.2 响应

查假期：

  1. {
  2.     "items": [{
  3.         "id": "123",
  4.         "name": "国庆节",
  5.         "duration": "7",
  6.         "holidayEndDate": "2019-10-07",
  7.         "holidayStartDate": "2019-10-01",
  8.         "workDay": "10月1日至7日放假调休，共7天。9月29日（星期日）、10月12日（星期六）上班。",
  9.         "workDayDetails": [
  10.             "2019-09-29",
  11.             "2019-10-12"
  12.         ],
  13.         "vocationDayDetails": [
  14.             "2019-10-01",
  15.             "2019-10-02",
  16.             "2019-10-03",
  17.             "2019-10-04",
  18.             "2019-10-05",
  19.             "2019-10-06",
  20.             "2019-10-07"
  21.         ],
  22.         "date": "2019-10-01",
  23.         "year": "2019",
  24.         "category": "法定假日",
  25.         "link": {
  26.             "webURL": "",
  27.             "deepLink": {
  28.                 "url": "url",
  29.                 "appName": "appName",
  30.                 "appPackage": "appPackage",
  31.                 "minVersion": "",
  32.                 "minAndroidAPILevel": "23"
  33.             },
  34.             "quickApp": {
  35.                 "url": "url",
  36.                 "minPlatformVersion": "",
  37.                 "minVersion": ""
  38.             }
  39.         }
  40.     }]
  41. }

成员名称描述是否必选类型取值范围
items假期是HolidayInfoItem[]最大Item数： 32

almanacs-almancInfo

2.3 请求

黄历运势查询

请求报文样例：

  1. {
  2.     "slots": {
  3.         "beginDate": {
  4.             "name": "beginDate",
  5.             "slotType": "string",
  6.             "values": [{
  7.                 "real": "2019-01-07"
  8.             }]
  9.         },
  10.         "endDate": {
  11.             "name": "endDate",
  12.             "slotType": "string",
  13.             "values": [{
  14.                 "real": "2019-01-08"
  15.             }]
  16.         }
  17.     }
  18. }

成员名称描述是否必选类型取值范围
beginDate起始时间否DateFormatString/
endDate结束时间，与起始时间间隔不得超过100天。否DateFormatString/

2.4 响应

查询一段时间内每天的黄历信息。

响应报文样例：

  1. {
  2.     "almanacInfo": [{
  3.             "yangli": "2018-10-17",
  4.             "nongli": "二零一八年九月初九",
  5.             "ganzhi": "戊戌年 壬戌月 壬午日",
  6.             "shengxiao": "狗",
  7.             "yi": "造车器 嫁娶 订盟 纳采",
  8.             "ji": "搬家 出行",
  9.             "riwuxing": "井泉水 建执位",
  10.             "chongsha": "冲羊(丁未)煞东",
  11.             "baiji": "丑不冠带",
  12.             "jishen": "岁德合,季分,金堂,三合,四相,天恩,月恩",
  13.             "xiongshen": "白虎中,勾陈,官符,时阴,死气,横天,木马,死符",
  14.             "xingxiu28": "毕月乌宿星",
  15.             "zhishen": "勾陈",
  16.             "taishen": "厨灶栖外正南",
  17.             "shen12": "除执位",
  18.             "caishen": "正东",
  19.             "xishen": "正东",
  20.             "fushen": "正东",
  21.             "zi": "凶",
  22.             "chou": "凶",
  23.             "yin": "凶",
  24.             "mao": "凶",
  25.             "chen": "凶",
  26.             "si": "凶",
  27.             "wu": "吉",
  28.             "wei": "吉",
  29.             "you": "吉",
  30.             "xu": "吉",
  31.             "hai": "吉",
  32.             "shen": "凶",
  33.             "xdwURL": "https://aaa.bbb.ccc/index.html"
  34.         },
  35.         {
  36.             "yangli": "2018-10-18",
  37.             "nongli": "二零一八年九月初九",
  38.             "ganzhi": "戊戌年 壬戌月 壬午日",
  39.             "shengxiao": "狗",
  40.             "yi": "造车器 嫁娶 订盟 纳采",
  41.             "ji": "搬家 出行",
  42.             "riwuxing": "井泉水 建执位",
  43.             "chongsha": "冲羊(丁未)煞东",
  44.             "baiji": "丑不冠带",
  45.             "jishen": "岁德合,季分,金堂,三合,四相,天恩,月恩",
  46.             "xiongshen": "白虎中,勾陈,官符,时阴,死气,横天,木马,死符",
  47.             "xingxiu28": "毕月乌宿星",
  48.             "zhishen": "勾陈",
  49.             "taishen": "厨灶栖外正南",
  50.             "shen12": "除执位",
  51.             "caishen": "正东",
  52.             "xishen": "正东",
  53.             "fushen": "正东",
  54.             "zi": "凶",
  55.             "chou": "凶",
  56.             "yin": "凶",
  57.             "mao": "凶",
  58.             "chen": "凶",
  59.             "si": "凶",
  60.             "wu": "吉",
  61.             "wei": "吉",
  62.             "you": "吉",
  63.             "xu": "吉",
  64.             "hai": "吉",
  65.             "shen": "凶",
  66.             "xdwURL": "https://aaa.bbb.ccc/index.html"
  67.         },
  68.         {
  69.             "yangli": "2018-10-19",
  70.             "nongli": "二零一八年九月初九",
  71.             "ganzhi": "戊戌年 壬戌月 壬午日",
  72.             "shengxiao": "狗",
  73.             "yi": "造车器 嫁娶 订盟 纳采",
  74.             "ji": "搬家 出行",
  75.             "riwuxing": "井泉水 建执位",
  76.             "chongsha": "冲羊(丁未)煞东",
  77.             "baiji": "丑不冠带",
  78.             "jishen": "岁德合,季分,金堂,三合,四相,天恩,月恩",
  79.             "xiongshen": "白虎中,勾陈,官符,时阴,死气,横天,木马,死符",
  80.             "xingxiu28": "毕月乌宿星",
  81.             "zhishen": "勾陈",
  82.             "taishen": "厨灶栖外正南",
  83.             "shen12": "除执位",
  84.             "caishen": "正东",
  85.             "xishen": "正东",
  86.             "fushen": "正东",
  87.             "zi": "凶",
  88.             "chou": "凶",
  89.             "yin": "凶",
  90.             "mao": "凶",
  91.             "chen": "凶",
  92.             "si": "凶",
  93.             "wu": "吉",
  94.             "wei": "吉",
  95.             "you": "吉",
  96.             "xu": "吉",
  97.             "hai": "吉",
  98.             "shen": "凶",
  99.             "xdwURL": "https://aaa.bbb.ccc/index.html"
  100.         }
  101.     ]
  102. }

成员名称描述是否必选类型取值范围
almanacInfo/是AlmanacInfoItem[]最大Item数： 100

2.5 结构

2.5.1 AlmanacInfoItem

成员名称描述是否必选类型取值范围
yangli阳历日期阳历日期（日期，格式如：2018-10-01。对应查询时间范围的每一天。）是DateFormatString/
nongli农历日期农历日期。如：二零一八年八月（大）初九。是

string

最大长度： 64
ganzhi干支干支。如：戊戌狗年 辛酉月 辛酉日是string最大长度： 128
shengxiao生肖生肖（如：狗）是string最大长度： 8
yi黄历运势（宜），多个时空格分隔。如：沐浴 破屋 治病是string最大长度： 128
ji黄历运势（忌），多个时空格分隔。如：搬家 结婚是string最大长度： 128
riwuxing日五行日五行，多个时空格分隔。如井泉水 建执位是string最大长度： 64
chongsha冲煞冲煞。 如：冲羊（丁未）煞东是string最大长度： 64
baiji彭祖百忌，多个时空格分隔。如：癸不词讼 丑不冠带是string最大长度： 128
jishen吉神宜趋，多个时逗号分隔。如：岁德合，季分，金堂，三合，四相，天恩，月恩是string最大长度： 128
xiongshen凶神宜忌，多个时逗号分隔。如：白虎中，勾陈，官符，时阴，死气，横天，木马，死符是string最大长度： 128
xingxiu28二十八星宿。如：毕月乌宿星是string最大长度： 64
zhishen值神。如：勾陈（黑道日）是string最大长度： 64
taishen胎神。如：厨灶栖外正南是string最大长度： 64
shen12十二神。如：除执位是string最大长度： 64
caishen诸神方位（财神）。如：正东是string最大长度： 32
xishen诸神方位（喜神）。如：正东是string最大长度： 32
fushen诸神方位（福神）。如：正东是string最大长度： 32
zi时辰宜忌（子时）是string枚举值：  凶， 吉
chou时辰宜忌（丑时）是string枚举值：  凶， 吉
yin时辰宜忌（寅时）是string枚举值：  凶， 吉
mao时辰宜忌（卯时）是string最大长度： 128
chen时辰宜忌（辰时）是string枚举值：  吉， 凶
si时辰宜忌（巳时）是string枚举值：  吉， 凶
wu时辰宜忌（午时）是string枚举值：  吉， 凶
wei时辰宜忌（未时）是string枚举值：  吉， 凶
shen时辰宜忌（申时）是string枚举值：  吉， 凶
you时辰宜忌（酉时）是string枚举值：  吉， 凶
xu时辰宜忌（戌时）是string枚举值：  吉， 凶
hai时辰宜忌（亥时）是string枚举值：  吉， 凶
xdwURL现代文h5 URL， 跳转至黄历详情。是string最大长度： 256

2.5.2 HolidayInfoItem

假期信息条目

成员名称描述是否必选类型取值范围
name假期名称是string最大长度： 32
duration假期时长是string最大长度： 32
holidayStartDate假期开始时间是DateFormatString/
holidayEndDate假期结束时间是DateFormatString/
workDay工作日安排，如5月1日至3日放假调休，共3天。4月29日（星期六）、4月30日（星期日）上班。同语音播报内容一致。是string最大长度： 256
workDayDetails假期安排中的工作日列表，如29号、30号上班。是DateFormatString[]最大Item数： 20
vocationDayDetails假期安排中的休息日列表，如1号、2号、3号调休。是DateFormatString[]最大Item数： 20
source信源，文本描述，用于品牌漏出。否string最大长度： 32
date节日日期是string最大长度： 32
year年份是string最大长度： 32
category节假日种类是string最大长度： 32
cardLink卡片跳转地址（开发者页面的跳转地址）否Interaction/

3. 日历-查时间（datetime-datetimeInfo）

3.1 请求

请求获取当前时间

暂无成员

3.2 响应

当前日期时间信息

  1. {
  2.     "datetime": "20190125122530000",
  3.     "city": "南京",
  4.     "dateOfWeek": "SUN",
  5.     "timezone": "+0800"
  6. }

成员名称描述是否必选类型取值范围
datetime当前日期时间信息是DateTimeFormatString/
city用户所处的城市否string最大长度：20
dateOfWeek一周中的哪一天否string枚举值：  SUN， MON， TUE， WED， THU， FRI， SAT
timezone当前所在时区否string/

3.3 结构

3.3.1 AlmanacInfoItem

成员名称描述是否必选类型取值范围
yangli阳历日期阳历日期（日期，格式如：2018-10-01。对应查询时间范围的每一天）是DateFormatString/
nongli农历日期农历日期。如：二零一八年八月（大）初九。是string最大长度：64
ganzhi干支干支。如：戊戌狗年 辛酉月 辛酉日。是string最大长度：128
shengxiao生肖生肖（如：狗）是string最大长度：8
yi黄历运势（宜），多个时空格分隔。如：沐浴 破屋 治病。是string最大长度：128
ji黄历运势（忌），多个时空格分隔。如：搬家 结婚。是string最大长度：128
riwuxing日五行日五行，多个时空格分隔。如：井泉水 建执位。是string最大长度：64
chongsha冲煞冲煞。 如：冲羊（丁未）煞东。是string最大长度：64
baiji彭祖百忌，多个时空格分隔。如：癸不词讼 丑不冠带。是string最大长度：128
jishen吉神宜趋，多个时逗号分隔。如：岁德合，季分，金堂，三合，四相，天恩，月恩。是string最大长度：128
xiongshen凶神宜忌，多个时逗号分隔。如：白虎中，勾陈，官符，时阴，死气，横天，木马，死符。是string最大长度：128
xingxiu28十八星宿。如：毕月乌宿星。是string最大长度：64
zhishen值神。如：勾陈（黑道日）。是string最大长度：64
taishen胎神。如：厨灶栖外正南。是string最大长度：64
shen12十二神。如：除执位。是string最大长度：64
caishen诸神方位（财神）。如：正东。是string最大长度：32
xishen诸神方位（喜神）。如：正东。是string最大长度：32
fushen诸神方位（福神）。如：正东。是string最大长度：32
zi时辰宜忌（子时）是string枚举值：  凶， 吉
chou时辰宜忌（丑时）是string枚举值：  凶， 吉
yin时辰宜忌（寅时）是string枚举值：  凶， 吉
mao时辰宜忌（卯时）是string最大长度：128
chen时辰宜忌（辰时）是string枚举值：  吉， 凶
si时辰宜忌（巳时）是string枚举值：  吉， 凶
wu时辰宜忌（午时）是string枚举值：  吉， 凶
wei时辰宜忌（未时）是string枚举值：  吉， 凶
shen时辰宜忌（申时）是string枚举值：  吉， 凶
you时辰宜忌（酉时）是string枚举值：  吉， 凶
xu时辰宜忌（戌时）是string枚举值：  吉， 凶
hai时辰宜忌（亥时）是string枚举值：  吉， 凶
xdwURL现代文h5 URL， 跳转至黄历详情。是string最大长度：256

3.3.2 HolidayInfoItem

假期信息条目

成员名称描述是否必选类型取值范围
name假期名称是string最大长度：32
duration假期时长是string最大长度：32
holidayStartDate假期开始时间是DateFormatString/
holidayEndDate假期结束时间是DateFormatString/
workDay工作日安排，如5月1日至3日放假调休，共3天。4月29日（星期六）、4月30日（星期日）上班。同语音播报内容一致。是string最大长度：256
workDayDetails假期安排中的工作日列表，如29号、30号上班。是DateFormatString[]最大Item数：20
vocationDayDetails假期安排中的休息日列表，如1号、2号、3号调休。是DateFormatString[]最大Item数：20
source信源，文本描述，用于品牌漏出。否string最大长度：32
date节日日期是string最大长度：32
year年份是string最大长度：32
category节假日种类是string最大长度：32
link卡片跳转地址（开发者页面的跳转地址）否Interaction/