README

简介

欢迎使用法大大开发者工具套件（SDK），PHP SDK 是法大大电子合同和电子签云服务开放平台（FASC OPEN API）的配套工具。

版本说明

FASC.openAPI 产品目前存在两个子版本号：v5.0、v5.1，均在持续迭代维护。

当前页面SDK基于FASC.openAPI v5.1子版本开发，如需使用FASC.openAPI v5.0版本SDK，请访问：

https://gitee.com/fadada-cloud/fasc-openapi-php-sdk/tree/v5.0

目录结构

SDK项目层级

fasc-openapi-php-sdk
    - src
        - FddCloud
            - bean //里面放的是所有API的对象参数
	            - message //里面放的是所有事件回调的对象参数
	            - req //里面放的是所有接口请求的对象参数
            - constants //里面放的是接口url地址和应用的配置信息
            - client //对应接口各个模块的client，接入方可以参考下面用例初始化client后调用
            - utils //里面是封装好工具类，接入方开发人员可以参考

SDK 目前支持以下模块，对应 client 可支持具体的业务方法：

安装

推荐使用 composer 进行安装。可以使用 composer.json 声明依赖，或者运行下面的命令。SDK 包已经放到这里 fadada/fasc-openapi-php-sdk 。

$ composer require fadada/fasc-openapi-php-sdk

依赖环境

PHP 7.0.10 版本及以上

使用方法

    /** 引入自动加载 */
    require_once __DIR__ . '/../vendor/fadada/fasc-openapi-php-sdk/autoload.php';

调用示例

读取应用APP_ID的全局配置文件

   use FddCloud\constants\OpenApiConfig;
   
   /**读取配置文件**/
   $apiConfigFile = 'api_config.php';
   $openApiConfig = new OpenApiConfig($apiConfigFile);
   $app_id = $openApiConfig->getConfig()['app_id'];
   $app_secret = $openApiConfig->getConfig()['app_secret'];
   $service_url = $openApiConfig->getConfig()['service_url'];
   $time_out = $openApiConfig->getConfig()['time_out'];
   $debug = $openApiConfig->getConfig()['debug'];

接入方初始化一个client，比如调用账号相关，通过client来发起请求。

   use FddCloud\client\Client;
   
   $client = new Client(
           $app_id,$app_secret,$service_url,$time_out,$debug
       );

接入方获取accessToken

   /** 获取accessToken */
   $serviceClient = new ServiceClient($client);
   $response = $serviceClient->getAccessToken();
   print_r($response . "\n");
   $res = json_decode($response);

获取个人用户授权接口示例

    use FddCloud\bean\req\user\GetUserAuthUrlReq;
	
	/**获取userClient**/
    $userClient = new UserClient($client);
    
    $getUserAuthUrlReq = new GetUserAuthUrlReq();
    # 个人用户在应用中的唯一标识，长度最大64个字符
    $getUserAuthUrlReq->setClientUserId("");
    # 个人用户的法大大帐号，仅限手机号或邮箱，长度最大30个字符。如该手机号或邮箱未注册法大大，则用户会以此作为注册账号
    $getUserAuthUrlReq->setAccountName("");
    $getUserAuthUrlReq->setNonEditableInfo($nonEditableInfo);
    $authScope = ["ident_info", "seal_info", "signtask_init", "signtask_info", "signtask_file","file_storage"];
    $getUserAuthUrlReq->setAuthScopes($authScope);
    # 重定向地址,即用户在返回的页面上完成操作后重定向跳转到该地址，并且附带上参数。该地址是应用系统的地址，以实现用户交互在应用系统和法大大平台之间的连贯性。长度最大500个字符
    $getUserAuthUrlReq->setRedirectUrl(urlencode("https://www.163.com/"));
    # 小程序的重定向地址（微信和支付宝），长度最大1000个字符。
    # 使用场景：小程序中集成该页面，操作完成后跳转地址为小程序原生页面路径，如"/pages/index/index"，系统判断在小程序环境会跳转至该地址。
    # 注：需要进行编码，若非原生页面路径请使用redirectUrl字段
    $getUserAuthUrlReq->setRedirectMiniAppUrl("");
    $response = $client->getUserAuthUrl($accessToken, $getUserAuthUrlReq);
    print_r($response . "\n");

版本更新日志

https://dev.fadada.com/updata-log/

参考

FASC OpenAPI (服务端) 接口文档 v5.1

https://dev.fadada.com/api-doc/ALGPB7Z1FD/TA0WHTSXQYL0NQRB/5-1

fadada / fasc-openapi-php-sdk

Maintainers

Details