
1、线下付款,获取可上传图片次数 2、申请请求接口所需的third_code和secret_key 3、根据接口文档,接入服务
1、按照图片上传次数扣费,上传失败不扣费 2、获取到的secret_key请妥善保管,不可外传 3、所有修复成功的图片本站将保留1小时后自动删除,如需持久化存储请下载至自有系统
1、code=200固定为成功,code=9000固定为失败 2、code=9000时,如需进一步业务判断,可根据errno参数 接口url:http://sdkphoto.fangtangtv.com
URL /api/third/photo/upload Method POST Header token: 加密生成的token,加密规则见附1 Params field type required commit third_code string Y 线下申请的第三方标识third_code repair_type string Y sr:超分,sr;repair:超分+修复;sr,repair,colour:超分+修复+上色;bg:证件照换底色 file file Y 上传的文件file rgb string N 当repair_type=bg时必传,色值格式:255,255,255(代表白色)
curl --location --request POST 'XXXXXX/api/third/photo/upload' \ --header 'token: XXXXX' \ --form 'repair_type="bg"' \ --form 'third_code="XXXXXX"' \ --form 'file=@"/Users/max/Downloads/7c7a7c7964e02f022c6e7aeae12c8786.jpg"' \ --form 'rgb="255,255,255"'
field commit
img_url 上传图片的url
mdf 图片的唯一标识
{
"code": 200,
"data": {
"img_url": "https://photo.fangtangtv.com/static/img/6720978a-b256-49fc-b717-81efe6e298d8_out.jpg",
"mdf": "40b37f58db153e5149f008421797714e"
}
}
errno commit
9999 请求参数token不合法
9101 剩余下载次数为0
9001 传入参数错误
9005 文件上传类型不支持
9006 上传失败
9009 图片异常,处理失败
{
"code": 9000,
"errno": 9005,
"msg": "文件上传类型不支持"
}URL /api/third/photo/status Method POST Header token: 加密生成的token,加密规则见附1 Params field type required commit third_code string Y 线下申请的第三方标识third_code mdf string Y 文件唯一标识
curl --location --request POST 'XXXXXX/api/third/photo/status' \ --header 'token: XXXXX' \ --form 'mdf="XXXXX"' \ --form 'third_code="XXXX"'
field commit
msg 描述
status 100:图片处理中;200:图片处理完成
{
"code": 200,
"data": {
"msg": "图片处理完成",
"status": 200
}
}
errno commit
9002 图片不存在
500 其他错误
{
"code": 9000,
"errno": 9002,
"msg": "图片不存在,请确认图片是否上传成功"
}
URL /api/third/photo/download Method POST Header token: 加密生成的token,加密规则见附1 Params field type required commit third_code string Y 线下申请的第三方标识third_code mdf string Y 文件唯一标识
curl --location --request POST 'XXXXX/api/third/photo/download' \ --header 'token: XXXXX' \ --form 'mdf="XXXXX"' \ --form 'third_code="XXXXX"'
field commit
url 图片下载地址
{
"code": 200,
"data": {
"url": "https://photo.fangtangtv.com/static/life_img/40b37f58db153e5149f008421797714e01100.jpg"
}
}
errno commit
9002 图片不存在
500 其他错误
{
"code": 9000,
"errno": 9002,
"msg": "数据已失效,请重新上传"
}
URL /api/third/company/nums Method POST Header token: 加密生成的token,加密规则见附1 Params field type required commit third_code string Y 线下申请的第三方标识third_code
curl --location --request POST 'XXXXX/api/third/company/nums' \ --header 'token: XXXXX' \ --form 'third_code="XXXXX"'
field commit
code 第三方标识third_code
nums 剩余上传次数
{
"code": 200,
"data": {
"code": "hiliad",
"nums": 98
}
}
errno commit
9002 数据未找到
500 其他错误
{
"code": 9000,
"errno": 9002,
"msg": "数据未找到"
}1、拿到服务方提供的secret_key,再生成一个当前时间戳time
secret_key = 'hiliad'
time = '1629962357'
2、secret_key + time,两字符串拼接,再md5,得到参数mds
mds = hashlib.md5((secret_key + time).encode("utf8")).hexdigest()
mds = '5484490c8e797dabe52af90ab8bd1e50'
3、最终的token等于 mds + ',' + time
token = '5484490c8e797dabe52af90ab8bd1e50,1629962357'
注:生成的时间戳会在2分钟后失效,请每次请求接口都重新生成时间戳