1、线下付款,获取可上传图片次数 2、申请请求接口所需的third_code和secret_key 3、根据接口文档,接入服务
1、按照图片上传次数扣费,上传失败不扣费 2、获取到的secret_key请妥善保管,不可外传 3、所有修复成功的图片本站将保留1小时后自动删除,如需持久化存储请下载至自有系统
1、请求地址: http://sdkphoto.fangtangtv.com 2、code=200固定为成功,code=9000固定为失败 3、code=9000时,如需进一步业务判断,可根据errno参数
URL /api/third/uploads Method POST Header token: 加密生成的token,加密规则见附1 Params field type required commit third_code string Y 线下申请的第三方标识third_code seq string Y 任务参数, 多值以英文逗号连接, 可选参数: repair, colour, sr, bg, scratch, defogging type string N 图像类型, 默认 people, 可选参数: people, cortoon, landscape, portrait, text file file Y 图像文件, 可传多次 rate int N 超分倍数, 默认 0, 可选参数: 2, 4, 8 rgb string N 底色值, bg in seq 时必传, 可选参数: -1, 1, 235,51,35(红), 85,142,213(蓝), 255,255,255(白) dpi int N 分辨率, 300DPI则传300 platform string Y 平台, 可选参数: pc, h5, mp, ios, baidu, zijie, douyin, alipay clientip string N 客户端IP mdf string N 再次处理, 必传, 可传多次
curl --location --request POST 'http://sdkphoto.fangtangtv.com/api/third/uploads' --header 'token: xxx' --form 'third_code="test"' --form 'seq="bg"' --form 'file=@"/VSCode/image/3c6b4b786c1159441a94e3508c36508b.png"' --form 'rgb="1"' --form 'platform="pc"'
field commit img_url 上传图片的url mdf 图片的唯一标识 { "code": 200, "data": { "mdf": [ "40b37f58db153e5149f008421797714e" ] } }
errno commit 9999 请求参数token不合法 9101 剩余下载次数为0 9001 传入参数错误 9005 文件上传类型不支持 9006 上传失败 9009 图片异常,处理失败 { "code": 9000, "errno": 9005, "msg": "文件上传类型不支持" }
URL /api/third/status Method POST Header token: 加密生成的token,加密规则见附1 Params field type required commit third_code string Y 线下申请的第三方标识third_code mdf string Y 文件唯一标识 platform string Y 平台, 可选参数: pc, h5, mp, ios, baidu, zijie, douyin, alipay
curl --location --request POST 'http://sdkphoto.fangtangtv.com/api/third/status' --header 'token: xxx' --form 'third_code="test"' --form 'mdf="9804b4cb5b4740fb26afde5f2831c0f5"' --form 'platform="pc"'
{ "code": 200, "data": { "msg": "获取任务状态成功", "status": 200 "mdfs": [ { "mdf":"9804b4cb5b4740fb26afde5f2831c0f5", "state": "任务处理完成", "src_url": "", "wmk_url":"", "icon_url": "", "res_size": "1080x1366px 146KB" } ] } }
errno commit 9002 图片不存在 500 其他错误 { "code": 9000, "errno": 9002, "msg": "图片不存在,请确认图片是否上传成功" }
URL /api/third/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 'http://sdkphoto.fangtangtv.com/api/third/download' --header 'token: xxx' --form 'third_code="test"' --form 'mdf="9804b4cb5b4740fb26afde5f2831c0f5"'
field commit url 图片下载地址 { "code": 200, "data": { "url": "https://sdkphoto.fangtangtv.com/api/third/download/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分钟后失效,请每次请求接口都重新生成时间戳