ebaoquan/junziqian_sdk

There is no license information available for the latest version (2.0.3) of this package.

php ebaoquan/junziqian_sdk

2.0.3 2021-08-18 07:45 UTC

Requires

• php: >=5.6
• ext-curl: *
• ext-iconv: *
• ext-json: *

Unknown License

• huhu

README

一、环境依赖

php版本

php最低版本以composer.json中require.php为准，现为>=5.3.39

以前版本

此程序是对ebq/jzq_api工具类在生产交互使用过程，存在的校验难、验证难等问题的升级解决方案。
重构了君子签的SDK和API服务体系。使用了更简单的签名过程和请求过程，但不失安全性。
php的sdk签名方式支持md5(32位),sha1,sha256等方案

二、安装方式

1.使用composer管理工具安装

首先：composer.json的require中加入"ebaoquan/junziqian_sdk":">=2.0.0"(版本以composer.json中version为准)

然后执行composer update即可(或 php composer.phar update)

composer update

2.没有使用composer工具

请联系对接人员，获取完整包

三、使用

1.开始

1.参考example例子目录，修改例子中的$serviceUrl,$appkey,$appSecret 变量
2.对部份信息填值，然后执行example例子.php即可 
3.不使用example，首先php头：require_once \__DIR\__ . '/../../vendor/autoload.php';这个autoload.php文件(本身项目已使用composer管理则不需要)，其它工具使用时请use引用

2.请求

ping服务

<?php
//引入composer的入口函数,参考composer的使用规范
require_once __DIR__ . '/../../../vendor/autoload.php';
//定义初始化变量，这些变量在生产中请设为全局变量或通用变量
$serviceUrl="http://sandbox.api.junziqian.com";
$appkey="xxxxxxxx";
$appSecret="xxxxxxxxxxxxxxx";
//发起PING请求
$requestUtils=new RequestUtils($serviceUrl, $appkey, $appSecret);
$response=$requestUtils->doPost("/v2/ping");
//处理结果
print_r( CommonUtil::json_encode($response));
Assert::notNull($response,"返回的结果不能为空");
Assert::isTrue($response->success,"处理错误:".CommonUtil::json_encode($response));

使用array直接请求

array请求用于参数简单的情况

//初始化合同参数
$request=array(
    "name" => "易XX",
    "identityCard" => "500240XXXXXXXXXX"
);
//发起请求
$requestUtils=new RequestUtils($serviceUrl, $appkey, $appSecret);
$response=$requestUtils->doPost("/v2/auth/userValid",$request);

使用对象请求

对象请求用于参数复杂的情况

$request=new ApplySignReq();//必须extends至Req2MapInterface类
$request->contractName="合同名称";
$response=$requestUtils->doPost("/v2/sign/applySign",$request);

3.指定签名方式（即生成sign方式,php默认为sha256）

$encryMethod="md5";//md5,sha1,sha256(默认)
$requestUtils=new RequestUtils($serviceUrl, $appkey, $appSecret,$encryMethod);

4.指定时间戳单位（即生成ts方式,php默认为秒为单位）

$tsType=1;//1毫秒,2.秒(默认)
$requestUtils=new RequestUtils($serviceUrl, $appkey, $appSecret,null,$tsType);

php5.3-php5.5之间的版本说明

php5.3与php5.5 不要使用CURLFile，因为这个函数还不存在,而是使用: '@D:/tmp/test.png'方式。