查询无水印图

描述

本接口用于证件照-查询无水印图的请求,具体效果请看以下文档详情。

版本

1.0

图片要求

图片格式:JPG,PNG

更新日志

调用 URL

正式环境:https://openapi.meitu.com/idphoto/business/v1/query/unwatermarked_images

调用方法

POST

request 的头的类型应包含:Content-Type:application/json

权限

开放平台接口签名

请求参数

参数名称类型最大长度是否必传备注
mt_generate_idstring200有水印请求返回的美图生成id

请求示例

{
     "mt_generate_id":"36936"
}

返回值说明

成功返回值说明

字段名称类型示例值描述
codeinteger100000响应状态码
msgstring操作成功响应状态码说明
dataobject响应数据
data.sd_photostring标清无水印图或基础无水印图(特效API返回的单图对应的无水印图)
data.hd_photostring高清无水印图
data.typesetting_photostring排版无水印图

失败返回值说明

字段类型说明
dataString返回的内容
messageString错误信息
codeInt错误代码

返回值示例

请求成功返回示例

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,表示制作错误但不扣费