图片上传接口接入流程

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

目录
相关文章
|
5月前
【微信公众平台对接】有关【上传图文消息内的图片获取URL】调用示例
【微信公众平台对接】有关【上传图文消息内的图片获取URL】调用示例
134 0
|
5月前
|
小程序 API 开发者
【产品上新】接口不报错=API成功接入?不妨“验”一下
【产品上新】接口不报错=API成功接入?不妨“验”一下
46 0
|
1月前
|
缓存 监控 API
淘宝 API 接口使用的技术要点与注意事项
在数字化商业环境中,淘宝API为开发者提供了强大的工具,用于与淘宝平台交互,获取商品信息及处理交易等。本文总结了正确使用API的关键技术要点:注册认证、理解接口文档、遵守调用限制、确保参数准确性、保护数据安全、处理异常、性能优化、版本兼容、合规性及日志监控,帮助开发者实现高效、安全的程序开发。
接口规范 9. 推流认证相关接口
9 推流认证相关接口 9.1.开启推流认证 用途针对某个应用,开启推流认证。开启推流认证后,所有向该应用下的推送直播流的请求都需要做合法性认证,只有认证通过的请求才会允许推送。认证的方法包括token认证和第三方认证。
1210 0
|
5月前
|
JSON 监控 API
在API接口对接中关键示例问题(1)
在API接口对接中,有几个关键的问题需要注意,以确保接口的稳定性、安全性和易用性。以下是这些问题及部分示例代码的简要概述
|
5月前
|
API 开发工具 数据安全/隐私保护
API接口的对接流程和注意事项
随着互联网技术的发展和应用的普及,API接口已经成为不同系统、不同应用之间进行交互和数据交换的重要方式。API接口使得不同的系统能够互相调用对方的功能,提高了系统的灵活性和扩展性。但是,在进行API接口对接的过程中,需要注意一些流程和事项,以确保对接的顺利进行和系统的稳定运行。
|
存储 JSON NoSQL
微信支付链路+封装对接微信API工具类(下)
微信支付链路+封装对接微信API工具类(下)
80 0
|
供应链 数据管理 API
数据api接口就是应用集成吗?
数据 API 接口和应用集成是两个不同的概念,但是它们之间有一定的联系。数据 API 接口是一种用于访问和传输数据的标准化接口,而应用集成则是将不同的应用程序和系统整合在一起,实现数据和业务流程的共享和协同。
|
测试技术 程序员 API
API 接口的对接流程和注意事项
随着互联网技术的发展和数字化时代的到来,API接口已经成为应用程序之间进行数据交换和通信的重要方式。API即应用程序接口,是一种定义、调用和交互的规范,使得不同应用程序之间可以相互调用和共享资源。本文将从程序员的视角出发,详细介绍API接口的对接流程和注意事项。