对接流程
由无界魔镜管理员在魔镜后台开通商户。
魔镜API商户需线下和商务对接进行充值，购买次数以及模版，由管理员在魔镜后台分配次数和模版。
开通成功后，用户登陆[ 魔镜后台 ](https://mirror-admin.wujieai.com/)获取密钥，通过密钥调通API鉴权流程，详见下方Demo。
API接入遇到问题时，建议优先向我们反馈响应Header中的TRACE_ID以快速定位问题。API异常码见文末列表。
签名流程
签名步骤
平台提供appid和公私钥，API接入方根据这个信息先完成鉴权签名流程，每个API的请求头都需要加上。
可参考下方签名代码demo。
签名失效时间为5分钟。
创建签名原文{"appId":"appId","timestamp":当前时间戳} （字段按字母顺序排序），使用私钥进行 SHA256withRSA 签名，再进行Base64处理。
在Request Header中的添加 Authorization 字段，字段值格式为
{"secretKeyVersion":"1","appId":"你的appid","sign":"签名sign", "original": "签名原文"}
API鉴权成功，Http状态码会返回200
:::highlight purple
Demo见此链接
go-sdk
https://gate.wujieai.net/wj-open/v1
:::
:::highlight purple
Http状态码
| 状态码 |
描述 |
| 400 |
参数不合法 |
| 401 |
权限不足 |
| 403 |
签名鉴权不通过 |
| 405 |
请求方式错误 |
| 429 |
请求API限流 |
| 415 |
传参的资源类型错误，需正确设置content-type:application/json |
| ::: |
|
:::highlight purple
业务响应报文
业务返回值http状态码都是200，业务异常在body下面的code上标识
{
"code": "200",
"data": {
//数据
},
"message": "success",
"success": true
}
```
{
"code": "101001",
"data": null,
"message": "token无效",
"success": false
}
```
常出现于key加密不正确或与uid（token）不匹配
```
{
"code": "20010001",
"data": null,
"message": "非法参数",
"success": false
}
```
:::
:::highlight purple
回调机制
部分异步任务接口，在提交请求时，若填写**notify_url**字段，则在任务完成时，会将结果信息送往此地址。
具体回调内容，见各接口文档。
### 回调重试规则
1. 支持5级重试时间: 5, 10, 30, 60, 120 (单位：秒)，也就是分别会在5s、10s、30s...时进行回调重试
2. 当回调通知方返回"success"时，我们会认为您已经成功处理回调，并终止重试
### 回调验签
1. 从 Headers 的 Authorization 字段中获取签名原文original和签名后的字符串sign
2. 使用公钥验签，方法同上
`MFwwDQYJKoZIhvcNAQEBBQADSwAwSAJBAJxv9d5dRpaW7sB16Rx6OtIw7AaWj4JUslPYM4JVEfZDWni1MjjU7LGnToYmUkgxlP2SACCVxLyHVm40kM1DGUcCAwEAAQ==`
** 注：回调场景必须使用该公钥验签！**
:::
## 异常码
|异常码|描述|
| ---- | ---- |
21060002|作画剩余张数不足
