图片上传接口接入流程

简介: 场景说明:该接口一般是结合口碑开店或商户会员卡产品使用,需要将商户需要使用的图片或视频上传支付宝服务器,生成对应的图片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、支持第三方调用。

场景说明:

该接口一般是结合口碑开店或商户会员卡产品使用,需要将商户需要使用的图片或视频上传支付宝服务器,生成对应的图片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+请求时间(大概时间方便查日志必填)+请求参数+报错截图

目录
相关文章
|
1月前
|
数据采集 监控 安全
各种业务场景调用API代理的API接口教程
API代理的API接口在各种业务场景中具有广泛的应用,本文将介绍哪些业务场景可以使用API代理的API接口,并提供详细的调用教程和代码演示,同时,我们还将讨论在不同场景下使用API代理的API接口所带来的好处。
|
2月前
|
小程序 API 开发者
【产品上新】接口不报错=API成功接入?不妨“验”一下
【产品上新】接口不报错=API成功接入?不妨“验”一下
29 0
|
JSON 安全 算法
API接口安全设计
API接口安全设计
8502 0
API接口安全设计
|
15天前
|
JSON 监控 API
在API接口对接中关键示例问题(1)
在API接口对接中,有几个关键的问题需要注意,以确保接口的稳定性、安全性和易用性。以下是这些问题及部分示例代码的简要概述
|
2月前
|
API 开发工具 数据安全/隐私保护
API接口的对接流程和注意事项
随着互联网技术的发展和应用的普及,API接口已经成为不同系统、不同应用之间进行交互和数据交换的重要方式。API接口使得不同的系统能够互相调用对方的功能,提高了系统的灵活性和扩展性。但是,在进行API接口对接的过程中,需要注意一些流程和事项,以确保对接的顺利进行和系统的稳定运行。
|
7月前
|
存储 JSON NoSQL
微信支付链路+封装对接微信API工具类(下)
微信支付链路+封装对接微信API工具类(下)
63 0
|
8月前
|
供应链 数据管理 API
数据api接口就是应用集成吗?
数据 API 接口和应用集成是两个不同的概念,但是它们之间有一定的联系。数据 API 接口是一种用于访问和传输数据的标准化接口,而应用集成则是将不同的应用程序和系统整合在一起,实现数据和业务流程的共享和协同。
|
8月前
|
Java API
接入微信支付API v3的两种方式
接入微信支付API v3的两种方式
163 0
|
10月前
|
XML 存储 JSON
常用的API接口对接方式和注意事项
常用的API对接方式和注意事项 随着互联网的发展,API(应用程序接口)已经成为了不可或缺的一部分。API允许不同的软件系统进行通信和数据交互,为开发者提供了一种简单、灵活和高效的方式来集成不同的软件系统
|
10月前
|
算法 NoSQL API
微信支付-业务流程图+时序图梳理微信支付链路+封装对接微信API工具类
微信支付-业务流程图+时序图梳理微信支付链路+封装对接微信API工具类
237 0