查询无水印图
描述
本接口用于证件照-查询无水印图的请求,具体效果请看以下文档详情。
版本
1.0
图片要求
图片格式:JPG,PNG
更新日志
调用 URL
正式环境:https://openapi.meitu.com/idphoto/business/v1/query/unwatermarked_images
调用方法
POST
request 的头的类型应包含:Content-Type:application/json
权限
请求参数
| 参数名称 | 类型 | 最大长度 | 是否必传 | 备注 |
|---|---|---|---|---|
| mt_generate_id | string | 200 | 是 | 有水印请求返回的美图生成id |
请求示例
{
"mt_generate_id":"36936"
}返回值说明
成功返回值说明
| 字段名称 | 类型 | 示例值 | 描述 |
|---|---|---|---|
| code | integer | 100000 | 响应状态码 |
| msg | string | 操作成功 | 响应状态码说明 |
| data | object | 响应数据 | |
| data.sd_photo | string | 标清无水印图或基础无水印图(特效API返回的单图对应的无水印图) | |
| data.hd_photo | string | 高清无水印图 | |
| data.typesetting_photo | string | 排版无水印图 |
失败返回值说明
| 字段 | 类型 | 说明 |
|---|---|---|
| data | String | 返回的内容 |
| message | String | 错误信息 |
| code | Int | 错误代码 |
返回值示例
请求成功返回示例
Response Status:200
content-type 为 application/json; charset=utf-8
{
"code": 100000,
"msg": "操作成功",
"data": {
"sd_photo": "http://o%3D",
"hd_photo": "http://%3D",
"typesetting_photo": "http://1234"
},
"log_id": "sPR1rSoaU7bqzuooGjWTzDunw6IsB58k"
}返回状态码
| 状态码 | 说明 |
|---|---|
| 100000 | 成功 |
| 100001 | 参数错误 |
通用的错误代码与信息
详见 API 错误码
注:此接口若返回码为555,表示制作错误但不扣费