上传企业自定义公章
服务说明
[!NOTE] 上传企业自定义的公章,可用于合同签署。上传公章规格要求:170*170PX,背景透明,png格式。 若不调此接口,合同上盖的企业章默认使用系统自动根据企业名称生成圆形的图形章。
http请求方式
[!NOTE] POST multipart/form-data
http请求地址
[!NOTE] $SERVICE_URL/v2/user/uploadEntSign #其中$SERVICE_URL为生产或测试的地址
http请求参数
参数 | 类型 | 是否必填 | 默认值 | 说明 |
---|---|---|---|---|
signName | string | * | 企业签章名字 | |
string | ? | 企业用户邮箱(必须与“企业注册认证接口”传入的邮箱一致),不传入将公章附与API商户 | ||
signImgFile | file | * | 盖章图片,不能超2MB,规格:170*170PX,背景透明,png格式 |
代码实现
JAVA实现
//构建请求参数
Map<String,Object> params=new HashMap<>();
params.put("signName","XXXX001");
params.put("email","XXXX@XX.XXX");
params.put("signImgFile",new FileBody(new File("/tmp/test.png")));
ResultInfo<Long> ri= requestUtils.doPost("/v2/user/uploadEntSign",params);
log.info("请求结果:"+ JSONObject.toJSONString(ri));
PHP实现
//构建请求工具
$requestUtils=new RequestUtils($serviceUrl, $appkey, $appSecret);
//初始化合同参数
$request=array(
"signName" => "500XXXXXXXXXXXX", //TODO *
"email" => "500XXXXXXXXXXXX", //TODO 不传则保存在商户下,传入注册的邮箱则上传到指定邮箱企业名下
"signImgFile" => new CURLFile('D:/tmp/test.png',null,"test.png"),
);
$response=$requestUtils->doPost("/v2/user/uploadEntSign",$request);
http返回参数
[!NOTE] 返回response为application/json的数据,其字段说明如下
参数 | 类型 | 是否必返回 | 说明 |
---|---|---|---|
success | bool | * | 成功true;异常false |
msg | string | ? | 异常时,返回异常原因 |
resultCode | int | * | 成功0,其它参考附录 |
data | long | * | 公章ID |
[!NOTE] 返回结果,参考:
//正确响应:
{"signId":"77091","success":true}
//错误响应:
{"msg":"账户信息不存在:XXXX@XX.XXX","resultCode":"ACCOUNT_NOT_EXISTS","success":false}