Veuillez vous référer à la version anglaise.
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分钟后失效，请每次请求接口都重新生成时间戳