










1、線下付款,獲取可上傳圖片次數(shù) 2、申請(qǐng)請(qǐng)求接口所需的third_code和secret_key 3、根據(jù)接口文檔,接入服務(wù)
1、按照?qǐng)D片上傳次數(shù)扣費(fèi),上傳失敗不扣費(fèi) 2、獲取到的secret_key請(qǐng)妥善保管,不可外傳 3、所有修復(fù)成功的圖片本站將保留1小時(shí)后自動(dòng)刪除,如需持久化存儲(chǔ)請(qǐng)下載至自有系統(tǒng)
1、請(qǐng)求地址: http://sdkphoto.fangtangtv.com 2、code=200固定為成功,code=9000固定為失敗 3、code=9000時(shí),如需進(jìn)一步業(yè)務(wù)判斷,可根據(jù)errno參數(shù)
URL /api/third/uploads Method POST Header token: 加密生成的token,加密規(guī)則見附1 Params field type required commit third_code string Y 線下申請(qǐng)的第三方標(biāo)識(shí)third_code seq string Y 任務(wù)參數(shù), 多值以英文逗號(hào)連接, 可選參數(shù): repair, colour, sr, bg, scratch, defogging type string N 圖像類型, 默認(rèn) people, 可選參數(shù): people, cortoon, landscape, portrait, text file file Y 圖像文件, 可傳多次 rate int N 超分倍數(shù), 默認(rèn) 0, 可選參數(shù): 2, 4, 8 rgb string N 底色值, bg in seq 時(shí)必傳, 可選參數(shù): -1, 1, 235,51,35(紅), 85,142,213(藍(lán)), 255,255,255(白) dpi int N 分辨率, 300DPI則傳300 platform string Y 平臺(tái), 可選參數(shù): 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 圖片的唯一標(biāo)識(shí)
{
"code": 200,
"data": {
"mdf": [
"40b37f58db153e5149f008421797714e"
]
}
}
errno commit
9999 請(qǐng)求參數(shù)token不合法
9101 剩余下載次數(shù)為0
9001 傳入?yún)?shù)錯(cuò)誤
9005 文件上傳類型不支持
9006 上傳失敗
9009 圖片異常,處理失敗
{
"code": 9000,
"errno": 9005,
"msg": "文件上傳類型不支持"
}URL /api/third/status Method POST Header token: 加密生成的token,加密規(guī)則見附1 Params field type required commit third_code string Y 線下申請(qǐng)的第三方標(biāo)識(shí)third_code mdf string Y 文件唯一標(biāo)識(shí) platform string Y 平臺(tái), 可選參數(shù): 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": "獲取任務(wù)狀態(tài)成功",
"status": 200
"mdfs": [
{
"mdf":"9804b4cb5b4740fb26afde5f2831c0f5",
"state": "任務(wù)處理完成",
"src_url": "",
"wmk_url":"",
"icon_url": "",
"res_size": "1080x1366px 146KB"
}
]
}
}
errno commit
9002 圖片不存在
500 其他錯(cuò)誤
{
"code": 9000,
"errno": 9002,
"msg": "圖片不存在,請(qǐng)確認(rèn)圖片是否上傳成功"
}
URL /api/third/download Method POST Header token: 加密生成的token,加密規(guī)則見附1 Params field type required commit third_code string Y 線下申請(qǐng)的第三方標(biāo)識(shí)third_code mdf string Y 文件唯一標(biāo)識(shí)
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 其他錯(cuò)誤
{
"code": 9000,
"errno": 9002,
"msg": "數(shù)據(jù)已失效,請(qǐng)重新上傳"
}
URL /api/third/company/nums Method POST Header token: 加密生成的token,加密規(guī)則見附1 Params field type required commit third_code string Y 線下申請(qǐng)的第三方標(biāo)識(shí)third_code
curl --location --request POST 'XXXXX/api/third/company/nums' \ --header 'token: XXXXX' \ --form 'third_code="XXXXX"'
field commit
code 第三方標(biāo)識(shí)third_code
nums 剩余上傳次數(shù)
{
"code": 200,
"data": {
"code": "hiliad",
"nums": 98
}
}
errno commit
9002 數(shù)據(jù)未找到
500 其他錯(cuò)誤
{
"code": 9000,
"errno": 9002,
"msg": "數(shù)據(jù)未找到"
}1、拿到服務(wù)方提供的secret_key,再生成一個(gè)當(dāng)前時(shí)間戳time
secret_key = 'hiliad'
time = '1629962357'
2、secret_key + time,兩字符串拼接,再md5,得到參數(shù)mds
mds = hashlib.md5((secret_key + time).encode("utf8")).hexdigest()
mds = '5484490c8e797dabe52af90ab8bd1e50'
3、最終的token等于 mds + ',' + time
token = '5484490c8e797dabe52af90ab8bd1e50,1629962357'
注:生成的時(shí)間戳?xí)?分鐘后失效,請(qǐng)每次請(qǐng)求接口都重新生成時(shí)間戳