中心认证服务远程调用安全接口-欢迎使用Connections.docVIP

说明 该系统存在两种部署模式，即图片模式，文件模式。 上传接口说明 协议 系统提供http协议的远程调用.客户端调用并同步返回响应。 请求 请求以POST方式. 远程服务地址url格式为: http://[server]/[app]/upload/[type]/[catalog] 其中: server为服务器地址和端口. app 当部署模式为图片时，应用名称为image 当部署模式为文件时，应用名称为file type为接口类型，取值如下： system 系统图片/附件上传 user 用户图片/附件上传 catalog为图片类型，取值如下： 当type=system时，取值参见附录一。 当type=user时，取值参见附录二。 请求的body编码为utf8. 参数说明如下: 参数名 类型 描述 zoom text 1、图片模式下，当请求type=user时，该参数值为 none，系统只对该图片保存原始文件，不做任何处理； normal，保存原图和normal尺寸图片 thumb，保存原图和thumb图片 spec1--- spec8，保存原图和定制图片 缺省，保存原图和所有默认规格图片(自定义只含spec1) 2、图片模式下，当type=system时，该参数值为 缺省，保存原始图片文件； smallicon，保存小图标(smallicon)和原始图片； largeicon，保存大图标 (largeicon)和原始图片； 3、文件模式下，该参数可为空。 注意：该参数值可以有多个，参数值之间采用逗号隔开 Userid text 当用户上传头像时必需，此时type=system，取值为用户在系统中的唯一32位编码，头像上传后文件类型转换为jpg，文件名为该32位编码。编码必须由字母和数字组成，若包含其它字符或者长度不符合要求，则文件名由系统自动生成。 File file 可包含一个或多个，使用file参数时，要求： 1、请求报文头包括enctype= multipart/form-data 2、不可使用imgstr参数 imgstr text 可包含一个或多个，参数值为文件内容BASE64编码字符串，使用该参数时，要求 1、请求报文头不可包括enctype= multipart/form-data 2、不可使用file参数 图片规格说明如下： 图片规格名称 图片分类 默认规格明细 默认quality 用途说明 smallicon 系统图片 50x50 100% 小尺寸，如应用图标显示 largeicon 系统图片 110x110 100% 大尺寸，如应用图标显示 thumb 用户图片 宽边长120 50% 缩略图（等比例缩放） normal 用户图片 宽边长800 70% 标准尺寸（等比例缩放） spec1 用户图片 10x10 50% 自定义规格(默认等比例缩放) spec2 用户图片 10x10 50% 自定义规格(默认等比例缩放) spec3 用户图片 10x10 50% 自定义规格(默认等比例缩放) spec4 用户图片 10x10 50% 自定义规格(默认等比例缩放) spec5 用户图片 10x10 50% 自定义规格(默认等比例缩放) spec6 用户图片 10x10 50% 自定义规格(默认等比例缩放) spec7 用户图片 10x10 50% 自定义规格(默认等比例缩放) spec8 用户图片 10x10 50% 自定义规格(默认等比例缩放) 注意：若需要重新定义每种规格图片的格式，可采取”图片规格名称:宽;高;质量”的形式，如”smallicon:600;400;50”即要求smallicon规格的图片宽为600，高为400，quality=50%。 响应 响应报文MIME类型为text/html;charset=utf-8. 响应报文content部分: 请求产生异常. 返回6位错误编码 999999 未知异常! 900001 参数(catalog):系统资源分类不能为空! 900002 请求数据的size超出了规定的大小! 900003 文件的size超出了规定的大小! 900004 文件传输出现错误,例如磁盘空间不足等! 900005 无效的请求类型,即请求类型enctype != multipart/form-data! 900006 文件拷贝到目标目录出现异常! 900007 图片处理出现异常! 请求成功. 返回上传资源引用相对路径，多个文件以逗号分割，示例如下： /system/[catalog]/[picid].jpg /system/avatar/[userid].jpg /user/[catalog]/[date]/[picid].jpg 其中，date格式为yyyy/M