2 Star 1 Fork 0

易保全 / jzq_sdk_php

Create your Gitee Account
Explore and code with more than 6 million developers,Free private repositories !:)
Sign up
Clone or Download
Cancel
Notice: Creating folder will generate an empty file .keep, because not support in Git
Loading...
README.md

jzq_sdk_php

#一、环境依赖

##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'方式。

Repository Comments ( 0 )

Sign in for post a comment

About

君子签http接口restful的php sdk expand collapse
PHP
MIT
Cancel

Releases

No release

Contributors

All

Activities

Load More
can not load any more
PHP
1
https://gitee.com/ebaoquan/jzq_sdk_php.git
git@gitee.com:ebaoquan/jzq_sdk_php.git
ebaoquan
jzq_sdk_php
jzq_sdk_php
master

Search

141041 ab9339c7 1850385 141043 25c028d5 1850385