黄历运势
万维易源 官方文档
根据输入日期,查看某一天的黄历运势
基本说明:
接口地址:http://route.showapi.com/856-1
返回格式:json
请求方式:get/post
请求示例:0
请求参数说明:
名称 类型 必填 说明
date String 选填 某天黄历,日期格式yyyyMMdd
返回参数说明:
名称 类型 说明
gongli String 公历日期
ongli String 农历日期
ganzhi String 干支
ayi String 纳音
hengxiao String 生肖
xingzuo String 星座
heng12 String 十二神
zhiri String 值日
chongsha String 冲煞
tszf String 胎神吉方
zbj String 彭祖百忌
jrhh String 今日合害
yi String
ji String
jsyq String 吉神宜趋
jieqi24 String 24节气
jieri String 节日
t23 String 子时 23-1
t1 String 丑时 1-3
t3 String 寅时 3-5
t5 String 卯时 5-7
t7 String 辰时 7-9
t9 String 巳时 9-11
t11 String 午时 11-13
t13 String 未时 13-15
t15 String 申时 15-17
t17 String 酉时 17-19
t19 String 戌时 19-21
t21 String 亥时 21-23
ret_code String 0为成功,其他失败
JSON返回示例:
{
	"showapi_res_code": 0,
	"showapi_res_error": "",
	"showapi_res_body": {
		"chongsha": "冲猪[正冲癸亥]煞东",
		"ganzhi": "乙未年 庚辰月 己巳日",
		"gongli": "公元 2015年4月23日 星期四",
		"ji": "开光 掘井 开仓",
		"jieqi24": "清明:4月5日 谷雨:4月20日",
		"jieri": "公历节日:  世界图书和版权日 农历节日:  大禹诞",
		"jrhh": "今日与属鸡半三合,与属猴六合,与属猪相冲,与属虎相害,与属虎属猴相刑。",
		"jsyq": "月德 天恩 时德 时阳 福生 司命",
		"nayin": "[年]砂石金 [月]白腊金 [日]大林木",
		"nongli": "二零一五年 三月(小)初五",
		"pzbj": "己不破券二比并亡 巳不远行财物伏藏",
		"ret_code": 0,
		"sheng12": "除执位",
		"shengxiao": "属羊",
		"tszf": "占门床外正南",
		"xingzuo": "金牛座",
		"yi": "结婚 祭祀 祈福 求嗣 出行 出火 拆卸 装修 动土 入宅 搬家 安床 作灶 塞穴 栽种 破土 安葬",
		"zhiri": "明堂(黄道日)"
		"t1": "\r\n 吉凶:吉\r\n 时柱:乙丑(海中金)\r\n 冲煞:冲羊煞东\r\n 正冲:己未(1979 2039)\r\n 时宜:祈福 求嗣 订婚 嫁娶 求财 开市 交易 安床 修造 盖屋 移徙\r\n 时忌:赴任 出行\r\n 吉神:三合 玉堂 唐符\r\n 凶煞:不遇\r\n 财喜:财神东南 喜神西北\r\n",
		"t11": "\r\n 吉凶:吉\r\n 时柱:庚午(路旁土)\r\n 冲煞:冲鼠煞北\r\n 正冲:甲子(1924 1984)\r\n 时宜:赴任 出行 求财 见贵 订婚 嫁娶 入宅 开市 安葬 祈福\r\n 时忌:修造 动土\r\n 吉神:日禄 青龙 天贵\r\n 凶煞:地兵\r\n 财喜:财神正东 喜神西北\r\n",
		"t13": "\r\n 吉凶:吉\r\n 时柱:辛未(路旁土)\r\n 冲煞:冲牛煞西\r\n 正冲:乙丑(1925 1985)\r\n 时宜:祭祀 祈福 酬神 订婚 嫁娶 出行 求财 入宅 安葬 修造 盖屋 移徙 作灶 安床\r\n 时忌:\r\n 吉神:福星 武曲 明堂 太阳\r\n 凶煞:\r\n 财喜:财神正南 喜神西南\r\n",
		"t15": "\r\n 吉凶:凶\r\n 时柱:壬申(剑锋金)\r\n 冲煞:冲虎煞南\r\n 正冲:丙寅(1926 1986)\r\n 时宜:求嗣 求财 嫁娶 安葬\r\n 时忌:祭祀 祈福 斋醮 开光 赴任 出行\r\n 吉神:罗纹 交贵 六合\r\n 凶煞:路空\r\n 财喜:财神正南 喜神正南\r\n",
		"t17": "\r\n 吉凶:凶\r\n 时柱:癸酉(剑锋金)\r\n 冲煞:冲兔煞东\r\n 正冲:丁卯(1927 1987)\r\n 时宜:求嗣 订婚 嫁娶 求财 开市 交易 安床\r\n 时忌:朱雀须用 凤凰符制 否则 诸事不宜 祭祀 祈福 斋醮 开光 赴任 出行\r\n 吉神:三合 长生\r\n 凶煞:朱雀 路空\r\n 财喜:财神正南 喜神东南\r\n",
		"t19": "\r\n 吉凶:吉 旬空\r\n 时柱:甲戌(山头火)\r\n 冲煞:冲龙煞北\r\n 正冲:戊辰(1928 1988)\r\n 时宜:祈福 订婚 嫁娶 开市 安葬\r\n 时忌:赴任 出行 求财\r\n 吉神:金匮 福德\r\n 凶煞:旬空\r\n 财喜:财神东南 喜神东北\r\n",
		"t21": "\r\n 吉凶:吉 旬空\r\n 时柱:乙亥(山头火)\r\n 冲煞:冲蛇煞西\r\n 正冲:己巳(1929 1989)\r\n 时宜:\r\n 时忌:日时相冲 诸事不宜\r\n 吉神:天德 驿马 宝光\r\n 凶煞:日破 旬空\r\n 财喜:财神东南 喜神西北\r\n",
		"t23": "\r\n 吉凶:凶\r\n 时柱:甲子(海中金)\r\n 冲煞:冲马煞南\r\n 正冲:戊午(1978 2038)\r\n 时宜:祭祀 祈福 酬神 出行 求财 见贵 订婚 嫁娶 修造 安葬 青龙 赴任\r\n 时忌:白虎须用 麒麟符制 否则 诸事不宜\r\n 吉神:贵人 大进 贪狼\r\n 凶煞:白虎\r\n 财喜:财神东南 喜神东北\r\n",
		"t3": "\r\n 吉凶:凶\r\n 时柱:丙寅(炉中火)\r\n 冲煞:冲猴煞北\r\n 正冲:庚申(1980 2040)\r\n 时宜:赴任 出行 求财 见贵 祭祀 祈福 酬神\r\n 时忌:上梁 盖屋 入殓\r\n 吉神:天官 喜神 国印\r\n 凶煞:天兵\r\n 财喜:财神正西 喜神西南\r\n",
		"t5": "\r\n 吉凶:凶\r\n 时柱:丁卯(炉中火)\r\n 冲煞:冲鸡煞西\r\n 正冲:辛酉(1981 2041)\r\n 时宜:入宅 安葬 求财 嫁娶\r\n 时忌:赴任 出行 修造 动土\r\n 吉神:天赦 贪狼\r\n 凶煞:元武\r\n 财喜:财神正西 喜神正南\r\n",
		"t7": "\r\n 吉凶:吉\r\n 时柱:戊辰(大林木)\r\n 冲煞:冲狗煞南\r\n 正冲:壬戌(1982 2042)\r\n 时宜:作灶 修造 赴任 见贵 求财 出行 嫁娶 进人口 移徙 安葬\r\n 时忌:祭祀 祈福 斋醮 酬神\r\n 吉神:司命 右弼\r\n 凶煞:狗食 六戊\r\n 财喜:财神正北 喜神东南\r\n",
		"t9": "\r\n 吉凶:凶\r\n 时柱:己巳(大林木)\r\n 冲煞:冲猪煞东\r\n 正冲:癸亥(1983 2043)\r\n 时宜:求嗣 嫁娶 移徙 入宅 开市 交易 安葬 见贵 求财\r\n 时忌:赴任 出行 修造 开光\r\n 吉神:帝旺 左辅\r\n 凶煞:勾陈 大退\r\n 财喜:财神正北 喜神东北\r\n"

	}
}
服务级错误码参照
错误码 说明
-1 系统调用错误
-2 可调用次数或金额为0
-3 读取超时
-4 服务端返回数据解析错误
-5 后端服务器DNS解析错误
-6 服务不存在或未上线
-1000 系统维护
-1002 showapi_appid字段必传
-1003 showapi_sign字段必传
-1004 签名sign验证有误
-1005 showapi_timestamp无效
-1006 app无权限调用接口
-1007 没有订购套餐
-1008 服务商关闭对您的调用权限
-1009 调用频率受限
-1010 找不到您的应用
-1011 子授权app_child_id无效
-1012 子授权已过期或失效
-1013 子授权ip受限
完整教学代码示例
public static void main(String path[]) throws Exception {
URL u = new URL("http://route.showapi.com/856-1?showapi_appid%3Dmyappid%26date%3D20150423%26showapi_sign%3Dmysecret");
InputStream in = u.openStream();
ByteArrayOutputStream out = new ByteArrayOutputStream();
try {
byte buf[] = new byte[1024];
int read = 0;
while ((read = in .read(buf)) > 0) {
out.write(buf, 0, read);
}
} finally {
if ( in != null) {
in .close();
}
}
byte b[] = out.toByteArray();
System.out.println(new String(b, "utf-8"));
}
<?php
/**
 * Created by PhpStorm.
 * User: FZS
 * Time: 2019/3/15 17:50
 */
//----------------------------------
// 易源 黄历运势 调用类
//----------------------------------
class freeApi{
    private $apiId = false; //易源appid
    private $apiSecret = false; //易源secret
    private $apiUrl = 'http://route.showapi.com/856-1';
    public function __construct($apiid,$secretkey){
        $this->apiId = $apiid;
        $this->apiSecret = $secretkey;
    }
    /**
     * url拼接
     * @return string
     */
    private function handleParam($paramArr,$showapi_secret){
        $paraStr = "";
        $signStr = "";
        ksort($paramArr);
        foreach ($paramArr as $key => $val) {
            if ($key != '' && $val != '') {
                $signStr .= $key.$val;
                $paraStr .= $key.'='.urlencode($val).'&';
            }
        }
        $signStr .= $showapi_secret;//排好序的参数加上secret,进行md5
        $sign = strtolower(md5($signStr));
        $paraStr .= 'showapi_sign='.$sign;//将md5后的值作为参数,便于服务器的效验
        return '?'.$paraStr;
    }
    /**
     * 将JSON内容转为数据,并返回
     * @param string $content [内容]
     * @return array
     */
    public function returnArray($content){
        return json_decode($content,true);
    }
    /**
     * 获取 黄历运势 结果
     * @return array
     */
    public function getResult(){
        $paramArr = [
            'showapi_appid'=> $this->apiId,
            'date'=> "20150423"
        ];
        return $this->returnArray($this->freeApiCurl($this->apiUrl.$this->handleParam($paramArr,$this->apiSecret)));
    }
    /**
     * 请求接口返回内容
     * @param  string $url [请求的URL地址]
     * @param  string $params [请求的参数]
     * @param  int $ipost [是否采用POST形式]
     * @return  string
     */
    public function freeApiCurl($url,$params=false,$ispost=0){
        $ch = curl_init();
        curl_setopt( $ch, CURLOPT_HTTP_VERSION , CURL_HTTP_VERSION_1_1 );
        curl_setopt( $ch, CURLOPT_HTTP_VERSION , CURL_HTTP_VERSION_1_1 );
        curl_setopt( $ch, CURLOPT_USERAGENT , 'free-api' );
        curl_setopt( $ch, CURLOPT_CONNECTTIMEOUT , 60 );
        curl_setopt( $ch, CURLOPT_TIMEOUT , 60);
        curl_setopt( $ch, CURLOPT_RETURNTRANSFER , true );
        if( $ispost )
        {
            curl_setopt( $ch , CURLOPT_POST , true );
            curl_setopt( $ch , CURLOPT_POSTFIELDS , $params );
            curl_setopt( $ch , CURLOPT_URL , $url );
        }
        else
        {
            if($params){
                curl_setopt( $ch , CURLOPT_URL , $url.'?'.$params );
            }else{
                curl_setopt( $ch , CURLOPT_URL , $url);
            }
        }
        $response = curl_exec( $ch );
        if ($response === FALSE) {
            return false;
        }
        curl_close( $ch );
        return $response;
    }
}
//推荐使用npm安装使用sdk: npm install --save showapi-sdk
'use strict';

var showapiSdk = require('showapi-sdk');

//设置你测试用的appId和secret,img
var appId='';
var secret='';
//开启debug
//showapiSdk.debug(true);
if(!(appId&&secret)){
  console.error('请先设置appId等测试参数,详见样例代码内注释!')
  return;
}
//全局默认设置
showapiSdk.setting({
  url:"http://route.showapi.com/856-1",//你要调用的API对应接入点的地址,注意需要先订购了相关套餐才能调
  appId:appId,//你的应用id
  secret:secret,//你的密钥
  timeout:5000,//http超时设置
  options:{//默认请求参数,极少用到
    testParam:'test'
  }
})

var request=showapiSdk.request();
request.appendText('date','20150423');
request.post(function(data){
  console.info(data)
})
package main

import (
"showSdk/normalRequest"
"fmt"
)
res := normalRequest.ShowapiRequest("http://route.showapi.com/856-1",my_appId,"my_appSecret")
res.AddTextPara("date","20150423")
//res.AddFilePara("img", "C:\\Users\\showa\\Desktop\\使用过的\\4.png")//文件上传时设置
fmt.Println(res.Post())
# python3.6.5
# 需要引入requests包 :运行终端->进入python/Scripts ->输入:pip install requests
from ShowapiRequest import ShowapiRequest

r = ShowapiRequest("http://route.showapi.com/856-1","my_appId","my_appSecret" )
r.addBodyPara("date", "20150423")
# r.addFilePara("img", r"C:\Users\showa\Desktop\使用过的\4.png") #文件上传时设置
res = r.post()
print(res.text) # 返回信息