| 接口说明 |
| 生成质量认证二维码图 |
| 请求与响应格式 |
| 关于如何发送HTTP请求与服务端交互并处理响应，请参见：接口调用指南 |
| API |
/sp/idcode/codepic/authen |
| 输入参数说明 |
| 参数名 |
类型 |
是否必须 |
描述 |
| access_token |
String |
是 |
唯一的平台授权key（必填） |
| company_idcode |
String |
是 |
单位主码（必填） |
| code |
String |
是 |
IDcode 码号（必填） |
| use_logo |
int |
是 |
是否嵌入单位 Logo（必填） 0：不嵌入 1：嵌入 |
| unit_logo |
String |
是 |
单位 Logo（将单位 Logo 图片 转换为 base64 |
| margin_type |
int |
是 |
边框样式（必填） 0 无边框 10 圆形边框 20 方形边框 |
| category_id |
int |
是 |
品类 ID（当 margin_type 等 于 10 时必填 |
| code_type |
int |
是 |
码制（必填） 1 QR 码 2 龙贝码 3 DM 码 4 汉 |
| code_size |
int |
是 |
码图尺寸(必填，单位：cm， 只能为 3、5、10 中的一个 |
| code_color |
String |
是 |
码图颜色值（如：黑色的颜色 值为“#000000”，只需要传 |
| time |
String |
是 |
当前时间的毫秒数(必填) |
| hash |
String |
是 |
HTTP通信加密字符串(必填) |
| CodePicBase64 |
String |
是 |
Json 返回结果 |
|
| 输出参数说明 |
| 参数名 |
类型 |
描述 |
| code_pic_base64str |
String |
生成的码图（码图序列化后 base64 字符串） |
| result_code |
String |
结果参数 |
| result_msg |
String |
结果信息 |
|
| 请求示例 |
/sp/idcode/codepic/authen
|
| Response JSON 示例 |
{"code_pic_base64str":生成的码图,"result_code":返回结
果,"result_msg":返回信息}
|
| 状态码说明 |
| 状态码 |
描述 |
| 1 |
成功 |
| 0 |
失败 |
| -1 |
系统繁忙，请稍后再试 |
| 10000 |
参数错误 |
| 10001 |
授权失败，授权 Key 不存在 |
| 10002 |
授权失败，授权 Key 已被禁用 |
| 10003 |
单位信息不存在 |
| 40005 |
单位 logo 上传失败 |
|
