API接口文档

1. 证书生成接口

调用方式


xxxxxxxxxx
POST /api/
Content-Type: application/x-www-form-urlencoded

请求参数

参数名	类型	必填	说明
nickname	string	是	用户昵称（6个汉字或12个字符，中文自动双字节计算）
qqnum	string	是	QQ号码（5-11位数字，不以0开头）
level	string	是	证书等级（初级/中级/高级）

请求示例


xxxxxxxxxx
curl -X POST "https://kp.foxdice.cn/api/" \
-d "nickname=%E6%B5%8B%E8%AF%95%E7%94%A8%E6%88%B7&qqnum=123456789&level=%E9%AB%98%E7%BA%A7"

成功响应


xxxxxxxxxx
{
  "success": true,
  "data": {
    "id": 4170,
    "nickname": "测试用户",
    "qqnum": "123456789",
    "level": "高级",
    "code": "FOXKP7A8B9C0D1E2",
    "created_at": "2024-03-21 14:30:45",
    "verify_url": "https://kp.foxdice.cn/show?code=FOXKP7A8B9C0D1E2",
    "crt_url": "https://kp.foxdice.cn/generate?code=FOXKP7A8B9C0D1E2"
  }
}

错误代码

HTTP状态码	错误信息	说明
400	缺少必要参数	缺少nickname/qqnum/level任一参数
400	昵称不能超过6个汉字或10个字符	昵称长度验证失败
400	QQ号码格式错误	不符合5-11位数字规则
405	请使用POST方法请求	错误使用GET方法访问接口
429	请求过于频繁	超出频率限制（默认10次/分钟）
500	证书生成失败	数据库写入失败等服务器错误

2. 证书查询接口

调用方式


xxxxxxxxxx
GET /search/?code={证书编码}

请求参数

参数名	类型	必填	说明
code	string	是	证书编码（格式：FOXKP+11位数字字母）

请求示例


xxxxxxxxxx
curl "https://kp.foxdice.cn/search/?code=FOXKP7A8B9C0D1E2"

成功响应


xxxxxxxxxx
{
  "success": true,
  "data": {
    "id": 4170,
    "nickname": "测试用户",
    "qqnum": "123456789",
    "level": "高级",
    "code": "FOXKP7A8B9C0D1E2",
    "created_at": "2024-03-21 14:30:45",
    "verify_url": "https://kp.foxdice.cn/show?code=FOXKP7A8B9C0D1E2",
    "crt_url": "https://kp.foxdice.cn/generate?code=FOXKP7A8B9C0D1E2"
  }
}

错误代码

HTTP状态码	错误信息	说明
400	缺少证书编码参数	未携带code参数
400	无效的证书编码格式	编码不符合格式规则
404	证书不存在	数据库未找到对应记录
429	请求过于频繁	超出频率限制（默认10次/分钟）