# 开始
# 前言
说明
api提供证书的创建、查询等接口服务，使用接口之前首先需要开发人员进入证书服务管理端创建应用获取appKey+appSecret，所有接口通过公共参数鉴权
证书服务管理端地址：https://certificate.drgeek.cn
业务参数配置：
说明
不同的业务需要维护到证书中的参数可能会不一致，所以需要先维护好业务对应参数
公共输入参数：
| 参数名 | 示例值 | 参数类型 | 是否必填 | 参数描述 |
|---|---|---|---|---|
| appKey | FyJvld4O | String | 是 | 应用的唯一标识 |
| nonce | 8439965061600648 | String | 是 | 随机数 |
| timestamp | 1658817592 | int | 是 | 时间戳(从1970年1月1日0点0分0秒开始到现在的秒数) |
| sign | e02a8f7a785b52224c0ff49629dedd7a | String | 是 | 加密证书(MD5 32位小写) |
提示
sign 证书的生成规则是MD5(appKey+appSecret+timestamp+nonce+version)
公共输出参数说明：
| 参数 | 示例值 | 是否必须 | 说明 |
|---|---|---|---|
| msg | 是 | 返回消息主体，当code不是200时，返回错误信息 | |
| code | 200 | 是 | 返回状态码 |
状态码说明：
| 状态码 | 说明 |
|---|---|
| 200 | 操作成功 |
| 404 | 未找到服务 |
| 500 | 服务器异常 |
| 10005 | timestamp无效 |
| 10006 | 请求重复 |
| 10007 | 签名效验失败 |
| 10008 | appKey不存在 |
WARNING
所有请求都要以content-type:x-www-form-urlencoded方式传输。
# 创建证书
请求方式：POST
请求地址：
https://certificate-api.drgeek.cn/certificate/api/createCertificate
输入参数说明：
| 参数名 | 示例值 | 参数类型 | 是否必填 | 参数描述 |
|---|---|---|---|---|
| businessId | ********** | String | 是 | 业务ID |
| relationId | ********** | String | 是 | 数据关系ID |
| 动态参数 | ********** | String | 是 | 根据不同的业务场景传入不同的参数 |
输出参数说明：
| 参数 | 示例值 | 是否必须 | 说明 |
|---|---|---|---|
| msg | certificate/template/XkgDr4LR/data/1660894149235.jpg | 是 | 返回证书地址 |
提示
证书真实地址需要自行转换
# 获取证书
请求方式：GET
请求地址：
https://certificate-api.drgeek.cn/certificate/api/getCertificateInfo
输入参数说明：
| 参数名 | 示例值 | 参数类型 | 是否必填 | 参数描述 |
|---|---|---|---|---|
| businessId | 教学活动id | String | 是 | 业务ID |
| relationId | 参与教学活动的人员id | String | 是 | 数据关系ID |
输出参数说明：
| 参数 | 示例值 | 是否必须 | 说明 |
|---|---|---|---|
| msg | certificate/template/XkgDr4LR/data/1660894149235.jpg | 是 | 返回证书地址 |
提示
证书真实地址需要自行转换
# 证书模板维护
请求方式：页面调用
请求地址：
https://certificate-ui.drgeek.cn/template
输入参数说明：
| 参数名 | 示例值 | 参数类型 | 是否必填 | 参数描述 |
|---|---|---|---|---|
| businessId | 教学活动id | String | 是 | 业务ID |
| appKey | XkgDr4LR | String | 是 | 应用的唯一标识 |
| businessKey | 96096abbeee5461289fbb7867857d4be | String | 是 | 业务标识 |
示例： https://certificate-ui.drgeek.cn/template?businessId=123456&appKey=XkgDr4LR&businessKey=96096abbeee5461289fbb7867857d4be
结果： 
提示
如果已经保存过了，下次调用此链接进入修改页面，展示之前已经配置过的数据，替换数据部分可以鼠标拖拽进行移动
# 证书查询
请求方式：页面调用
请求地址：
https://certificate-ui.drgeek.cn/search
输入参数说明：
| 参数名 | 示例值 | 参数类型 | 是否必填 | 参数描述 |
|---|---|---|---|---|
| businessId | 教学活动id | String | 是 | 业务ID |
示例： https://certificate-ui.drgeek.cn/search?businessId=123456
结果： 
提示
查询页面参数在前言业务配置中配置，目前配置查询条件字段仅支持必填且完全匹配才能查询出证书结果，证书支持下载功能
