下载企业自定义印章

接口说明

[!NOTE]
下载企业自定义上传的公章图片

http请求方式

[!NOTE]
POST application/x-www-form-urlencoded

http请求地址

[!NOTE]
$SERVICE_URL/v2/user/entSignDown #其中$SERVICE_URL为生产或测试的地址

http请求参数

除公共必填参数外，还需要传以下参数

参数	类型	是否必填	默认值	说明
email	string	?		企业用户邮箱,不传入将公章附与API商户
signId	string	?		公章ID（signId和sysSign 二选一）
sysSign	int	?		1,下载系统生成的标准图形章（signId和sysSign 二选一）

代码实现

JAVA实现

RequestUtils requestUtils=RequestUtils.init(SERVICE_URL,APP_KEY,APP_SECRET);//建议生成为spring bean
//构建请求参数
Map<String,Object> params=new HashMap<>();
params.put("email","XXXX@XX.XXX");
params.put("signId",1);
ResultInfo<JSONObject> ri= requestUtils.doPost("/v2/user/entSignDown",params);

PHP实现

//初始化合同参数
$request=array(
    "email" => "yifanxiang@163.com", //TODO * 企业注册的邮箱
    "signId" => 557, //TODO * 公章ID
);
//发起请求
$response=$requestUtils->doPost("/v2/user/entSignDown",$request);
Assert::notNull($response,"返回的结果不能为空");
Assert::isTrue($response->success,"处理错误:".CommonUtil::json_encode($response));
file_put_contents("/test001.png", base64_decode($response->data->entSignDate));//保存到本地
printf("保存成功");

http返回参数

[!NOTE]
返回response为application/json的数据，其字段说明如下

参数	类型	是否必返回	说明
success	bool	*	成功true；异常false
msg	string	?	异常时，返回异常原因
resultCode	string	?	异常时返回
data	object	?	公章文件信息,成功时返回

[!NOTE]
data 为JSON结构，其字段说明如下

参数	类型	是否必返回	说明
entSignDate	string	*	公章文件内容base64String字符串

[!NOTE]
返回结果，参考：

//正确响应：
{"data":{"entSignDate":"MIITRAIBAzCCEv4G=="},"success":true}
//错误响应：
{"msg":"企业邮箱用户不存在","resultCode":"ACCOUNT_NOT_EXISTS","success":false}

results matching ""

No results matching ""