数独谜题生成
请求Header:
名称 | 值 | |
---|---|---|
Content-Type | application/x-www-form-urlencoded |
请求参数说明:
名称 | 必填 | 类型 | 说明 | |
---|---|---|---|---|
key | 是 | string | 在个人中心->我的数据,接口名称上方查看 | |
difficulty | 否 | string | 难度级别, easy(简单)、normal(普通)、hard(困难)、veryhard(非常困难); 默认easy |
请求代码示例:
curl -k -i -d "key=您申请的AppKey&difficulty=easy" http://apis.juhe.cn/fapig/sudoku/generate
<?php
$url = "http://apis.juhe.cn/fapig/sudoku/generate";
$params = [
"key" => "您申请的AppKey", # 在个人中心->我的数据,接口名称上方查看
"difficulty" => "easy", # 难度级别, easy(简单)、normal(普通)、hard(困难)、veryhard(非常困难); 默认easy
];
$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/sudoku/generate"
params = {
"key":"您申请的AppKey", # 在个人中心->我的数据,接口名称上方查看
"difficulty":"easy", # 难度级别, easy(简单)、normal(普通)、hard(困难)、veryhard(非常困难); 默认easy
}
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/sudoku/generate"
// 接口请求参数
params := map[string]string{
"key":"您申请的AppKey", // 在个人中心->我的数据,接口名称上方查看
"difficulty":"easy", // 难度级别, easy(简单)、normal(普通)、hard(困难)、veryhard(非常困难); 默认easy
}
// 请求头设置
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/sudoku/generate",
method: "GET", // GET|POST
headers: {
"Content-Type": "application/x-www-form-urlencoded"
},
// GET 传递此参数
qs:{
key: "您申请的AppKey", // 在个人中心->我的数据,接口名称上方查看
difficulty: "easy", // 难度级别, easy(简单)、normal(普通)、hard(困难)、veryhard(非常困难); 默认easy
},
// POST 传递此参数
body: querystring.stringify({
key: "您申请的AppKey", // 在个人中心->我的数据,接口名称上方查看
difficulty: "easy", // 难度级别, easy(简单)、normal(普通)、hard(困难)、veryhard(非常困难); 默认easy
})
};
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/sudoku/generate";
Map<String, String> params = new HashMap<String, String>();
params.put("key", "您申请的AppKey"); // 在个人中心->我的数据,接口名称上方查看
params.put("difficulty", "easy"); // 难度级别, easy(简单)、normal(普通)、hard(困难)、veryhard(非常困难); 默认easy
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 | string | 返回结果集 | |
puzzle | array | 谜题, 依据下标分别对应数独盘面的个九宫,及每一行对应的九个小格 | |
solution | array | 答案 |
JSON返回示例:JSON在线格式化工具 >
{
"reason": "success",
"result": {
"puzzle": [
[
0,/*为0表示待填空项, 非0表示需要展示出的数值*/
3,
8,
7,
6,
2,
0,
5,
1
],
[
1,
0,
0,
3,
8,
4,
9,
0,
2
],
[
4,
7,
2,
1,
9,
5,
0,
0,
6
],
[
0,
1,
0,
0,
0,
0,
8,
0,
0
],
[
0,
0,
0,
0,
0,
1,
0,
0,
9
],
[
6,
2,
0,
8,
0,
0,
1,
3,
7
],
[
2,
4,
1,
0,
7,
3,
6,
9,
0
],
[
8,
9,
5,
4,
2,
6,
7,
1,
3
],
[
0,
6,
3,
9,
1,
8,
2,
0,
5
]
],
"solution": [
[
9,
3,
8,
7,
6,
2,
4,
5,
1
],
[
1,
5,
6,
3,
8,
4,
9,
7,
2
],
[
4,
7,
2,
1,
9,
5,
3,
8,
6
],
[
5,
1,
9,
6,
3,
7,
8,
2,
4
],
[
3,
8,
7,
2,
4,
1,
5,
6,
9
],
[
6,
2,
4,
8,
5,
9,
1,
3,
7
],
[
2,
4,
1,
5,
7,
3,
6,
9,
8
],
[
8,
9,
5,
4,
2,
6,
7,
1,
3
],
[
7,
6,
3,
9,
1,
8,
2,
4,
5
]
]
},
"error_code": 0
}
服务级错误码参照(error_code):
错误码 | 说明 |
---|
系统级错误码参照:
错误码 | 说明 | 旧版本(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) | 具体错误代码 |