# Generated by ShowAPI OpenAPI generator
# source: market/856
# generated-at: 2026-07-06T07:37:20.941Z
openapi: 3.0.3
info:
  title: 黄历运势
  description: 我们的API服务专业、准确，帮助您更好地规划日常生活和重要事宜，如选择吉日、避免冲煞等。无论是对于传统信仰的遵循，还是对日常生活规划的辅助，黄历运势API是您的理想选择。立即使用黄历运势API，让专业的黄历信息为您的生活带来更多和谐与顺利。
  termsOfService: https://www.showapi.com/helpcenter/view#/4019/2
  version: 1.0.0
servers:
  - url: https://route.showapi.com
paths:
  /856-4:
    x-pointCode: 4
    x-mode: mapping
    x-read-timeout: 5
    x-connect-timeout: 5
    post:
      summary: 吉神凶煞
      description: 吉神凶煞查询api接入点支持从1901年1月1日至今年（当前年份）的查询。
      responses:
        "200":
          description: 成功响应
          content:
            application/json:
              schema:
                allOf:
                  - $ref: "#/components/schemas/ShowapiResEnvelope"
                  - type: object
                    properties:
                      showapi_res_body:
                        type: object
                        properties:
                          yuezhi:
                            type: string
                            description: 月支
                          yueqisha:
                            type: string
                            description: 月七煞
                          fantaisui:
                            type: string
                            description: 犯太岁
                          esbx:
                            type: string
                            description: 二十八宿
                          caishen:
                            type: string
                            description: 财神
                          yuesansha:
                            type: string
                            description: 月三煞
                          niansansha:
                            type: string
                            description: 年三煞
                          jiuxing:
                            type: string
                            description: 九星
                          nianqisha:
                            type: string
                            description: 年七煞
                          wuhou:
                            type: string
                            description: 物候
                          ret_code:
                            type: number
                            description: 0为成功，扣除次数；其余为失败，不扣除次数
                          rilu:
                            type: string
                            description: 日禄
                          rikongwang:
                            type: string
                            description: 日空亡
                          zhongdong:
                            type: string
                            description: 仲冬
                          niankongwang:
                            type: string
                            description: 年空亡
                          suipowei:
                            type: string
                            description: 岁破位
                          risansha:
                            type: string
                            description: 日三煞
                          niantaisui:
                            type: string
                            description: 年太岁
                          zhishen12:
                            type: string
                            description: 十二值神
                          zhiri12:
                            type: string
                            description: 十二值日
                          tjjs:
                            type: string
                            description: 推荐吉时
                          yueling:
                            type: string
                            description: 月令
                          msg:
                            type: string
                            description: 描述
                          riqisha:
                            type: string
                            description: 日七煞
                          xishen:
                            type: string
                            description: 喜神
                          yinguishen:
                            type: string
                            description: 阴贵神
                          fushen:
                            type: string
                            description: 福神
                          yuexiang:
                            type: string
                            description: 月相
                          yuekongwang:
                            type: string
                            description: 月空亡
                          yangguishen:
                            type: string
                            description: 阳贵神
                          yjgx:
                            type: string
                            description: 易经卦象
                          liuyao:
                            type: string
                            description: 六曜
                          taisuiwei:
                            type: string
                            description: 太岁位
                        description: 业务返回体
      operationId: 856_4_POST
      parameters:
        - name: ymd
          in: query
          description: 格式为yyyyMMdd
          required: true
          schema:
            type: string
  /856-3:
    x-pointCode: 3
    x-mode: mapping
    x-read-timeout: 5
    x-connect-timeout: 5
    post:
      summary: 吉时
      description: 吉时查询api接入点支持从1901年1月1日至今年（当前年份）的查询。
      responses:
        "200":
          description: 成功响应
          content:
            application/json:
              schema:
                allOf:
                  - $ref: "#/components/schemas/ShowapiResEnvelope"
                  - type: object
                    properties:
                      showapi_res_body:
                        type: object
                        properties:
                          zi:
                            type: object
                            properties:
                              jixiong:
                                type: string
                                description: 吉凶
                              jishen:
                                type: string
                                description: 吉神
                              shijian:
                                type: string
                                description: 时间
                              xiongshen:
                                type: string
                                description: 凶神
                              shichong:
                                type: string
                                description: 时冲
                              shizhu:
                                type: string
                                description: 时柱
                            description: 子时
                          hai:
                            type: object
                            properties: {}
                            description: 亥时
                          wei:
                            type: object
                            properties: {}
                            description: 未时
                          cheng:
                            type: object
                            properties: {}
                            description: 辰时
                          you:
                            type: object
                            properties: {}
                            description: 酉时
                          wu:
                            type: object
                            properties: {}
                            description: 午时
                          si:
                            type: object
                            properties: {}
                            description: 巳时
                          xu:
                            type: object
                            properties: {}
                            description: 戌时
                          chou:
                            type: object
                            properties: {}
                            description: 丑时
                          yin:
                            type: object
                            properties: {}
                            description: 寅时
                          shen:
                            type: object
                            properties: {}
                            description: 申时
                          mao:
                            type: object
                            properties: {}
                            description: 卯时
                          ret_code:
                            type: string
                            description: 0为成功，扣除次数；其余为失败，不扣除次数
                        description: 业务返回体
      operationId: 856_3_POST
      parameters:
        - name: ymd
          in: query
          description: 格式为yyyyMMdd
          required: true
          schema:
            type: string
  /856-2:
    x-pointCode: 2
    x-mode: mapping
    x-read-timeout: 5
    x-connect-timeout: 5
    post:
      summary: 黄历
      description: 黄历查询api接入点支持从1901年1月1日至今年（当前年份）的查询。
      responses:
        "200":
          description: 成功响应
          content:
            application/json:
              schema:
                allOf:
                  - $ref: "#/components/schemas/ShowapiResEnvelope"
                  - type: object
                    properties:
                      showapi_res_body:
                        type: object
                        properties:
                          nongli:
                            type: string
                            description: 农历
                          zhishen:
                            type: string
                            description: 值神
                          jieqi24:
                            type: string
                            description: 当前月包含的24节气
                          nayin:
                            type: string
                            description: 纳音
                          tszf:
                            type: string
                            description: 胎神占方
                          ret_code:
                            type: number
                            description: 0为成功，扣除次数；其余为失败，不扣除次数
                          shengxiao:
                            type: string
                            description: 生肖
                          rulueli:
                            type: string
                            description: 儒略历
                          xsyj:
                            type: string
                            description: 凶神宜忌
                          xingzuo:
                            type: string
                            description: 星座
                          ganzhi:
                            type: string
                            description: 干支
                          dizhi:
                            type: string
                            description: 地支
                          pzbj:
                            type: string
                            description: 彭祖百忌
                          zhiri:
                            type: string
                            description: 值日
                          msg:
                            type: string
                            description: 描述
                          gongli:
                            type: string
                            description: 公历
                          jsyq:
                            type: string
                            description: 吉神宜趋
                          ji:
                            type: string
                            description: 忌
                          jieri:
                            type: string
                            description: 节日
                          qixiang:
                            type: string
                            description: 气象
                          chongsha:
                            type: string
                            description: 冲煞
                          yi:
                            type: string
                            description: 宜
                          wxcy:
                            type: string
                            description: 五行穿衣
                        description: 业务返回体
      operationId: 856_2_POST
      parameters:
        - name: ymd
          in: query
          description: 格式为yyyyMMdd
          required: true
          schema:
            type: string
components:
  securitySchemes:
    AppKeyAuth:
      type: apiKey
      in: query
      name: appKey
      description: 从 ShowAPI 控制台获取的 appKey，管理地址：https://www.showapi.com/console#/myApp
  schemas:
    ShowapiResEnvelope:
      type: object
      description: ShowAPI 统一返回包裹（业务数据位于 showapi_res_body）
      properties:
        showapi_res_code:
          type: integer
          description: API 返回的状态码
        showapi_res_error:
          type: string
          description: API 返回的错误信息
        showapi_res_id:
          type: string
          description: API 请求的唯一标识
        showapi_fee_num:
          type: integer
          description: API 调用计费次数
security:
  - AppKeyAuth: []
externalDocs:
  url: https://www.showapi.com/apiGateway/view/856?tab=book
x-apiCode: "856"
x-is-own: false
x-is-op: false
