节假日安排查询
请求Header:
名称 | 值 | |
---|---|---|
Content-Type | application/x-www-form-urlencoded |
请求参数说明:
名称 | 必填 | 类型 | 说明 | |
---|---|---|---|---|
key | 是 | string | 您申请的appkey | |
date | 是 | string | 指定日期,格式为yyyy-MM-dd,如:2021-05-01 | |
detail | 否 | int | 是否返回详细信息,当值为1时,返回详细信息 |
请求代码示例:
curl -k -i -d "key=您申请的AppKey&date=2021-05-09" http://apis.juhe.cn/fapig/calendar/day
<?php
$url = "http://apis.juhe.cn/fapig/calendar/day";
$params = [
"key" => "您申请的AppKey", # 在个人中心->我的数据,接口名称上方查看
"date" => "2021-05-09", # 指定日期,格式为yyyy-MM-dd,如:2021-05-01
];
$paramsStr = http_build_query($params);
$headers = ["Content-Type" => "application/x-www-form-urlencoded"];
$content = httpRequest($url, $paramsStr,0,$headers);
$result = json_decode($content, true);
if ($result) {
var_dump($result);
// 具体返回示例值,参考返回参数说明、json返回示例
} else {
// 请求异常
}
/**
*
* 发起请求
* @param $url
* @param string $dataStr
* @param int $isPost
* @return bool|string
*/
function httpRequest($url, $dataStr = "", $isPost = 0,$headers=[])
{
$httpInfo = [];
$ch = curl_init();
curl_setopt($ch, CURLOPT_HTTP_VERSION, CURL_HTTP_VERSION_1_0);
curl_setopt($ch, CURLOPT_USERAGENT, "Mozilla/5.0 (Windows NT 5.1) AppleWebKit/537.22 (KHTML, like Gecko) Chrome/25.0.1364.172 Safari/537.22");
curl_setopt($ch, CURLOPT_CONNECTTIMEOUT, 30);
curl_setopt($ch, CURLOPT_TIMEOUT, 30);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
// 请求头
if (!empty($headers)) {
curl_setopt($ch, CURLOPT_HTTPHEADER, $headers);
}
// 跳过证书检查
if (strtolower(mb_substr($url,0,8,"utf-8")) == "https://") {
curl_setopt($ch, CURLOPT_SSL_VERIFYPEER, false); // 跳过证书检查
curl_setopt($ch, CURLOPT_SSL_VERIFYHOST, 2); // 从证书中检查SSL加密算法是否存在
}
if ($isPost) {
curl_setopt($ch, CURLOPT_POST, true);
curl_setopt($ch, CURLOPT_POSTFIELDS, $dataStr);
curl_setopt($ch, CURLOPT_URL, $url);
} else {
curl_setopt($ch, CURLOPT_URL, $url . "?" . $dataStr);
}
//echo $url."?".$dataStr;
$response = curl_exec($ch);
if ($response === false) {
//echo "cURL Error: " . curl_error($ch);
return false;
}
$httpCode = curl_getinfo($ch, CURLINFO_HTTP_CODE);
$httpInfo = array_merge($httpInfo, curl_getinfo($ch));
curl_close($ch);
return $response;
}
#!/usr/bin/python3
# -*- coding: utf-8 -*-
import requests
import json
headers ={"Content-Type": "application/x-www-form-urlencoded"}
url = "http://apis.juhe.cn/fapig/calendar/day"
params = {
"key":"您申请的AppKey", # 在个人中心->我的数据,接口名称上方查看
"date":"2021-05-09", # 指定日期,格式为yyyy-MM-dd,如:2021-05-01
}
resp = requests.get(url,params,headers=headers)
resp_json = json.loads(resp.text)
print(resp_json)
# 具体返回示例值,参考返回参数说明、json返回示例
package main
import (
"fmt"
"io"
"net/http"
"net/url"
"strings"
"time"
)
func main() {
// 接口请求地址
url := "http://apis.juhe.cn/fapig/calendar/day"
// 接口请求参数
params := map[string]string{
"key":"您申请的AppKey", // 在个人中心->我的数据,接口名称上方查看
"date":"2021-05-09", // 指定日期,格式为yyyy-MM-dd,如:2021-05-01
}
// 请求头设置
headers := map[string]string{
"Content-Type": "application/x-www-form-urlencoded",
}
response, err := HttpRequest("GET", url, params, headers, 15)
if err != nil {
fmt.Println("请求异常:", err.Error())
} else {
fmt.Println("请求结果:", response)
}
// 具体返回示例值,参考返回参数说明、json返回示例
}
// http请求发送
func HttpRequest(method, rawUrl string, bodyMaps, headers map[string]string, timeout time.Duration) (result string, err error) {
var (
request *http.Request
response *http.Response
res []byte
)
if timeout <= 0 {
timeout = 5
}
client := &http.Client{
Timeout: timeout * time.Second,
}
// 请求的 body 内容
data := url.Values{}
for key, value := range bodyMaps {
data.Set(key, value)
}
jsons := data.Encode()
if request, err = http.NewRequest(method, rawUrl, strings.NewReader(jsons)); err != nil {
return
}
if method == "GET" {
request.URL.RawQuery = jsons
}
// 增加header头信息
for key, val := range headers {
request.Header.Set(key, val)
}
// 处理返回结果
if response, err = client.Do(request); err != nil {
return "", err
}
defer response.Body.Close()
if res, err = io.ReadAll(response.Body); err != nil {
return "", err
}
return string(res), nil
}
//node request模块安装命令:npm install request
var request = require("request");
var querystring = require("querystring");
const options = {
url: "http://apis.juhe.cn/fapig/calendar/day",
method: "GET", // GET|POST
headers: {
"Content-Type": "application/x-www-form-urlencoded"
},
// GET 传递此参数
qs:{
key: "您申请的AppKey", // 在个人中心->我的数据,接口名称上方查看
date: "2021-05-09", // 指定日期,格式为yyyy-MM-dd,如:2021-05-01
},
// POST 传递此参数
body: querystring.stringify({
key: "您申请的AppKey", // 在个人中心->我的数据,接口名称上方查看
date: "2021-05-09", // 指定日期,格式为yyyy-MM-dd,如:2021-05-01
})
};
request(options, function (error, response, body) {
if (!error && response.statusCode == 200) {
console.log(body); // 请求成功,输出响应内容
// 具体返回示例值,参考返回参数说明、json返回示例
} else {
console.log("请求异常");
}
});
import net.sf.json.JSONObject;
import java.io.*;
import java.net.HttpURLConnection;
import java.net.MalformedURLException;
import java.net.URL;
import java.net.URLEncoder;
import java.util.Map;
import java.util.HashMap;
public class ApiDemo {
public static void main(String[] args) {
// 发送http请求的url
String url = "http://apis.juhe.cn/fapig/calendar/day";
Map<String, String> params = new HashMap<String, String>();
params.put("key", "您申请的AppKey"); // 在个人中心->我的数据,接口名称上方查看
params.put("date", "2021-05-09"); // 指定日期,格式为yyyy-MM-dd,如:2021-05-01
String paramsStr = urlencode(params);
System.out.println(paramsStr);
String response = doGet(url,paramsStr);
// // post请求
// String response = doPost(url,paramsStr);
// 输出请求结果
System.out.println(response);
try {
// 解析请求结果,json:
JSONObject jsonObject = JSONObject.fromObject(response);
System.out.println(jsonObject);
// 具体返回示例值,参考返回参数说明、json返回示例
} catch (Exception e) {
e.printStackTrace();
}
}
// 将map型转为请求参数型
public static String urlencode(Map<String, String> data) {
StringBuilder sb = new StringBuilder();
for (Map.Entry i : data.entrySet()) {
try {
sb.append(i.getKey()).append("=").append(URLEncoder.encode(i.getValue() + "", "UTF-8")).append("&");
} catch (UnsupportedEncodingException e) {
e.printStackTrace();
}
}
return sb.toString();
}
/**
* get方式的http请求
*
* @param httpUrl 请求地址
* @param paramStr 请求参数
* @return 返回结果
*/
public static String doGet(String httpUrl,String paramStr) {
HttpURLConnection connection = null;
InputStream inputStream = null;
BufferedReader bufferedReader = null;
String result = null;// 返回结果字符串
try {
httpUrl += "?"+paramStr;
// 创建远程url连接对象
URL url = new URL(httpUrl);
// 通过远程url连接对象打开一个连接,强转成httpURLConnection类
connection = (HttpURLConnection) url.openConnection();
// 设置连接方式:get
connection.setRequestMethod("GET");
// 设置连接主机服务器的超时时间:15000毫秒
connection.setConnectTimeout(15000);
// 设置读取远程返回的数据时间:60000毫秒
connection.setReadTimeout(60000);
// 设置请求头
connection.setRequestProperty("Content-Type", "application/x-www-form-urlencoded");
// 发送请求
connection.connect();
// 通过connection连接,获取输入流
if (connection.getResponseCode() == 200) {
inputStream = connection.getInputStream();
// 封装输入流,并指定字符集
bufferedReader = new BufferedReader(new InputStreamReader(inputStream, "UTF-8"));
// 存放数据
StringBuilder sbf = new StringBuilder();
String temp;
while ((temp = bufferedReader.readLine()) != null) {
sbf.append(temp);
sbf.append(System.getProperty("line.separator"));
}
result = sbf.toString();
}
} catch (MalformedURLException e) {
e.printStackTrace();
} catch (IOException e) {
e.printStackTrace();
} finally {
// 关闭资源
if (null != bufferedReader) {
try {
bufferedReader.close();
} catch (IOException e) {
e.printStackTrace();
}
}
if (null != inputStream) {
try {
inputStream.close();
} catch (IOException e) {
e.printStackTrace();
}
}
if (connection != null) {
connection.disconnect();// 关闭远程连接
}
}
return result;
}
/**
* post方式的http请求
*
* @param httpUrl 请求地址
* @param paramStr 请求参数
* @return 返回结果
*/
public static String doPost(String httpUrl, String paramStr) {
HttpURLConnection connection = null;
InputStream inputStream = null;
OutputStream outputStream = null;
BufferedReader bufferedReader = null;
String result = null;
try {
URL url = new URL(httpUrl);
// 通过远程url连接对象打开连接
connection = (HttpURLConnection) url.openConnection();
// 设置连接请求方式
connection.setRequestMethod("POST");
// 设置连接主机服务器超时时间:15000毫秒
connection.setConnectTimeout(15000);
// 设置读取主机服务器返回数据超时时间:60000毫秒
connection.setReadTimeout(60000);
// 默认值为:false,当向远程服务器传送数据/写数据时,需要设置为true
connection.setDoOutput(true);
// 设置传入参数的格式:请求参数应该是 name1=value1&name2=value2 的形式。
connection.setRequestProperty("Content-Type", "application/x-www-form-urlencoded");
// 通过连接对象获取一个输出流
outputStream = connection.getOutputStream();
// 通过输出流对象将参数写出去/传输出去,它是通过字节数组写出的
outputStream.write(paramStr.getBytes());
// 通过连接对象获取一个输入流,向远程读取
if (connection.getResponseCode() == 200) {
inputStream = connection.getInputStream();
// 对输入流对象进行包装:charset根据工作项目组的要求来设置
bufferedReader = new BufferedReader(new InputStreamReader(inputStream, "UTF-8"));
StringBuilder sbf = new StringBuilder();
String temp;
// 循环遍历一行一行读取数据
while ((temp = bufferedReader.readLine()) != null) {
sbf.append(temp);
sbf.append(System.getProperty("line.separator"));
}
result = sbf.toString();
}
} catch (MalformedURLException e) {
e.printStackTrace();
} catch (IOException e) {
e.printStackTrace();
} finally {
// 关闭资源
if (null != bufferedReader) {
try {
bufferedReader.close();
} catch (IOException e) {
e.printStackTrace();
}
}
if (null != outputStream) {
try {
outputStream.close();
} catch (IOException e) {
e.printStackTrace();
}
}
if (null != inputStream) {
try {
inputStream.close();
} catch (IOException e) {
e.printStackTrace();
}
}
if (connection != null) {
connection.disconnect();
}
}
return result;
}
}
返回参数说明:
名称 | 类型 | 说明 | |
---|---|---|---|
error_code | int | 状态码 | |
reason | string | 状态描述 | |
result | object | 数据对象 | |
date | string | 阳历日期 | |
status | string | 当天状态标识,1:节假日,2:工作日,null:周末或工作日(可根据week进行判断,也可以直接根据statusDesc进行判断) | |
statusDesc | string | 状态描述,节假日/工作日/周末。1.当status为1时,表示节假日;2.当status为2时,表示工作日;3.当status为null时,如果week为周六或者周日,表示周末,否则表示工作日 | |
week | string | 表示星期几 | |
当detail=1时返回以下字段,仅供参考,非必返回 | |||
animal | string | 属相 | |
avoid | string | 忌 | |
cnDay | string | 星期几 | |
day | string | 阳历日 | |
desc | string | 节日描述,如:母亲节 | |
gzDate | string | 干支纪日,如:丁巳 | |
gzMonth | string | 干支纪月,如:癸巳 | |
gzYear | string | 干支纪年,如:辛丑 | |
isBigMonth | string | 是否大月 | |
lDate | string | 农历日,如:廿八 | |
lMonth | string | 农历月,如:三 | |
lunarDate | string | 农历日,如:28 | |
lunarMonth | string | 农历月,如:3 | |
lunarYear | string | 农历年,如:2021 | |
month | string | 阳历月 | |
oDate | string | 保留字段,可忽略 | |
suit | string | 宜 | |
term | string | 节气 | |
type | string | 保留字段,可忽略 | |
value | string | 节日 | |
year | string | 阳历年 |
JSON返回示例:JSON在线格式化工具 >
{
"reason": "success",
"result": {
"date": "2021-05-09",
"week": "星期日",
"statusDesc": "周末",
"status": null,
"animal": "牛",
"avoid": "订婚.上梁.纳采.盖屋.开仓",
"cnDay": "日",
"day": "9",
"desc": "母亲节",
"gzDate": "丁巳",
"gzMonth": "癸巳",
"gzYear": "辛丑",
"isBigMonth": "1",
"lDate": "廿八",
"lMonth": "三",
"lunarDate": "28",
"lunarMonth": "3",
"lunarYear": "2021",
"month": "5",
"suit": "搬家.装修.开业.结婚.入宅.领证.开工.动土.安床.出行.安葬.开张.作灶.旅游.求嗣.赴任.修造.祈福.祭祀.解除.开市.牧养.纳财.纳畜.开光.嫁娶.移徙.经络.立券.求医.竖柱.栽种.斋醮.求财",
"term": "",
"value": "母亲节",
"year": "2021"
},
"error_code": 0
}
服务级错误码参照(error_code):
错误码 | 说明 | |
---|---|---|
260601 | 参数错误 |
系统级错误码参照:
错误码 | 说明 | 旧版本(resultcode) | |
---|---|---|---|
10001 | 错误的请求KEY | 101 | |
10002 | 该KEY无请求权限 | 102 | |
10003 | KEY过期 | 103 | |
10004 | 错误的OPENID | 104 | |
10005 | 应用未审核超时,请提交认证 | 105 | |
10007 | 未知的请求源 | 107 | |
10008 | 被禁止的IP | 108 | |
10009 | 被禁止的KEY | 109 | |
10011 | 当前IP请求超过限制 | 111 | |
10012 | 请求超过次数限制 | 112 | |
10013 | 测试KEY超过请求限制 | 113 | |
10014 | 系统内部异常(调用充值类业务时,请务必联系客服或通过订单查询接口检测订单,避免造成损失) | 114 | |
10020 | 接口维护 | 120 | |
10021 | 接口停用 | 121 |
错误码格式说明(示例:200201):
2 | 002 | 01 | |
---|---|---|---|
服务级错误(1为系统级错误) | 服务模块代码(即数据ID) | 具体错误代码 |