Consulte la versión en inglés.
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分钟后失效,请每次请求接口都重新生成时间戳