圖檔上傳接口接入流程

場景說明：

該接口一般是結合口碑開店或商戶會員卡産品使用，需要将商戶需要使用的圖檔或視訊上傳支付寶伺服器，生成對應的圖檔ID，然後調用對應的接口配置相應的圖檔。

一、文檔位址

官方文檔位址：[url]https://docs.open.alipay.com/api_3/alipay.offline.material.image.upload[/url]

二、開發前準備工作

調用步驟：[url]https://openclub.alipay.com/read.php?tid=12194&fid=69[/url]

注意事項：1、支援沙箱測試；2、不需簽約，但需要添加功能；3、支援第三方調用。

注：應用中沒有對應的圖檔上傳功能，該功能的添加是根據對應産品添加，如口碑開店、商戶會員卡等。

三、接口調用請求示例

1、參數說明

（1）image_type：目前隻支援bmp,png,jpeg,jpg,gif 5個類型

（2）image_name：圖檔/視訊名稱

（3）image_content：圖檔/視訊二進制内容，圖檔/視訊大小不能超過5M

該參數是設定圖檔檔案的路徑，Windows請填寫絕對路徑，不支援相對路徑；Linux支援相對路徑。

2、JAVA版本請求示例

AlipayClient alipayClient = new DefaultAlipayClient(AlipayConfig.URL ,AlipayConfig.APPID,AlipayConfig.RSA_PRIVATE_KEY,"json",AlipayConfig.CHARSET,AlipayConfig.ALIPAY_PUBLIC_KEY,"RSA2");			AlipayOfflineMaterialImageUploadRequest request = new AlipayOfflineMaterialImageUploadRequest();									request.setImageType("jpg"); //圖檔類型，目前支援bmp,png,jpeg,jpg,gif 5個類型									request.setImageName("煜雨");											FileItem ImageContent = new FileItem("C:/Users/Public/Pictures/Sample Pictures/122.jpg");//圖檔檔案路徑，Windows請填寫絕對路徑，不支援相對路徑；Linux支援相對路徑									request.setImageContent(ImageContent);								 //request.setImagePid("2088021822217233");						AlipayOfflineMaterialImageUploadResponse response = alipayClient.execute(request);						//alipayResponse.getImageId() 擷取圖檔資源ID						//alipayResponse.getImageUrl() 擷取圖檔通路連結                			if(response.isSuccess()){                					System.out.println("調用成功");                			} else {                					System.out.println("調用失敗");                			}                				System.out.println(response.getBody());           

響應參數：

調用成功{"alipay_offline_material_image_upload_response":{"code":"10000","msg":"Success","image_id":"-BQdFtaWQ5G9C-pu8bf4ogAAACMAAQED","image_url":"https:\/\/oalipay-dl-django.alicdn.com\/rest\/1.0\/image?fileIds=-BQdFtaWQ5G9C-pu8bf4ogAAACMAAQED&zoom=original"},"sign":"o6YTatnaar6KAq2qhGEUYCYRXrNfmZ68TksdxlSOhf0Ar1XGM0HUEzkM6X7vfgihDSUh0alWFQZLmKmkYhPSNzvwLWXpDV9qO1ps8+3RNgi+LdfVSl2NA3Okdvxk/ovM9ibx2kvatlUhFyrcSPswPLJDdEcowgFDiaQm3aFhysG8t0Y5nBDHbyTWL5SQ1cC3yPD0AfPzRX5QnxW8fxlxtQMCJCiI+vf9yvq2oQpjpTprkvp0Zj2Jx3/09Lc4UTk/TjjcyJQVqMZFBQxUaayGk+GiP7+eRGyuA0gxFlzfIkkcCpkI6HfgkRJXkeUQgvdhOImv/EURTOmWpsJ0EcptUQ=="}           

3、PHP版本請求示例

include_once './config.php'; //引入config中配置的APPID和密鑰資訊require_once 'AopSdk.php';   //引入SDK$aop->method='alipay.offline.material.image.upload';$request = new AlipayOfflineMaterialImageUploadRequest ();$request->setImageType("jpg");$request->setImageName("煜雨");$cc='C:/Users/Public/Pictures/Sample Pictures/122.jpg';$request->setImageContent("@".$cc);$result = $aop->execute ($request);//var_dump($result);echo json_encode($result,JSON_UNESCAPED_UNICODE);//列印完整的響應參數資訊           

{"alipay_offline_material_image_upload_response":{"code":"10000","msg":"Success","image_id":"xal969tURAqgeC6EdqejGAAAACMAAQED","image_url":"https:\/\/oalipay-dl-django.alicdn.com\/rest\/1.0\/image?fileIds=xal969tURAqgeC6EdqejGAAAACMAAQED&zoom=original"},"sign":"V6T9rHtF6+IjyU1W7L2LSqXuQBqRLsSFarZl2QO5rUm+3nYo++qpUrIMH43mEnW6e27YC3JaP2ySO0IdeygjzmZrlMDOJE\/DUd+t58wfyEEHftnSdd6ZvLriY7zau2LAZaEQ2AQrZdAP1u6igFYqeb\/6O8bGiH75HEreUFvxT19lng+3zAK8vspeLyYuizFUDQNGKAiK9DMFXj0FsmihtCXK8BTJeafFpXuBVhFNOLlnbOwnr4OP5y\/QXevabE9b8t6Q40rgzKm3LvdFIuyWzNj2YjZTGqC4vIosfIkJ2detXTD0c4SQaS4Nj1CmzkUsTrbn3TUY3prYFHud8PGjwA=="}           

4、.NET版本請求示例

IAopClient client = new DefaultAopClient(config.gatewayUrl, config.app_id, config.private_key, "json", "1.0", "RSA2", config.alipay_public_key, config.charset, false);            AlipayOfflineMaterialImageUploadRequest  request= new AlipayOfflineMaterialImageUploadRequest() ;                                       request.ImageType = "jpg";            request.ImageName = "煜雨測試1";            FileItem ImageContent = new Aop.Api.Util.FileItem("C:/Users/Public/Pictures/Sample Pictures/122.jpg");            request.ImageContent = ImageContent;             AlipayOfflineMaterialImageUploadResponse response=client.Execute(request);             Console.WriteLine(response.Body);           

{"alipay_offline_material_image_upload_response":{"code":"10000","msg":"Success","image_id":"4RhwiJKoTfiUkLQS9lVtXgAAACMAAQQD","image_url":"https://oalipay-dl-django.alicdn.com/rest/1.0/image?fileIds=4RhwiJKoTfiUkLQS9lVtXgAAACMAAQQD&zoom=original"},"sign":"O+TLANRVwF5xrj1YupbmHPRZfoRSu3YrYHEWkJ3+U3Q2qTu0eNOvN/8hHRLedkP9sX5Lvg8y3pA0sIDRYWu5BP6Y3OYTovs0n7eXIGyuoF7HSk1CYEwEiFsXWtMzgd31iVO7v3g0pafQipnL6+NT5B1inw1uNrN7gVIvXBcNZex/iXry1wiiOSFMhOTEe/5K7OpzCmfTldT7uTQkOa3BgQdWpolYQe3SJjV6eORRucNDV/5mWZkmXrRKj5s8QZGUApfwgGadnKue+YE4qz8oNsEn9gBVGoQSLZx3kbkHVqC7O2YeQyPOpKYW5P4ou1PAEIL3Bqtcv0k0Xc8+0tsfMw=="}           

四、常見問題

1.Q:調用圖檔上傳接口出現“ISV權限不足，建議在開發者中心檢查對應功能是否已經添加”，如何處理？

A:在應用中添加【口碑開店】的應用功能即可。

2.Q:image_type參數都可以設定什麼格式？

A:目前支援bmp,png,jpeg,jpg,gif 5個類型。

3.Q:image_content參數是否可以設定相對路徑？

A:該參數是設定圖檔檔案的路徑，Windows請填寫絕對路徑，不支援相對路徑；Linux支援相對路徑。

如果大家在測試過程中遇到問題歡迎在文章下方追問，請按照标準方式提問

标準方式：使用環境（沙箱還是正式環境）+ appid+請求時間（大概時間友善查日志必填）+請求參數+報錯截圖