










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分鐘后失效,請每次請求接口都重新生成時間戳