faso-dev/saflan-sdk

dev-main 2023-01-11 09:43 UTC

This package is auto-updated.

Last update: 2024-09-23 14:39:07 UTC


README

此包旨在通过提供一组类和函数来简化SAFLAN API的使用。

要求

在使用此包之前,您需要一个有效的API登录名和密码。您还需要安装以下要求

  • PHP 7.4或更高版本
  • composer
  • ext-json
  • ext-curl

安装

您可以使用composer安装此包

composer require faso-dev/saflan-sdk

用法

安装完包后,您可以在代码中使用它

	require __DIR__ . '/vendor/autoload.php';
	
	use FasoDev\SaflanSdk\Saflan\Config\Config;
	use FasoDev\SaflanSdk\Saflan\Config\DataCode;
	use FasoDev\SaflanSdk\Saflan\Credentials\Credentials;
	use FasoDev\SaflanSdk\Saflan\SaflanClient;
	
	$config = Config::auth(new Credentials('username', 'password'))
	                ->defineSslVerification(false)
	                ->defineTimeout(30)
	                ->defineBaseEndPoint('http://www.saflan-bf.com:7170/saflanentreprise')
	;
	
	$saflan = SaflanClient::loadConfig($config);
	
	$creditResponse = $saflan->credit()->chargeWithStandard(1000, ['702000000', '702000001']);
	$mobileMoneyCreditDataResponse = $saflan->credit()->chargeWithMobileMoney(1000, ['702000000', '702000001']);
	$mobileDataResponse = $saflan->mobileData()->charge(DataCode::MOOV_PROMO_10Go_9500F_30JRS, ['702000000', '702000001']);
	$transactionStatusReponse = $saflan->transaction()->checkStatus('p20220609.478');
  • Credentials 类用于存储您的API登录名和密码。

  • Config 类用于配置客户端,例如定义凭据、基本端点、超时、SSL验证等。

  • SaflanClient 类用于加载配置并与API交互。因此,我们有3个端点方法:credit()mobileData()transaction()

  • credit() 端点方法用于与信用REST API交互,为指定号码购买信用。

  • mobileData() 端点方法用于与移动数据REST API交互,为指定号码购买移动数据。

  • transaction() 端点方法用于与交易REST API交互,检查指定交易的状态。

  • DataCode 类用于定义移动数据的数据代码。

贡献

欢迎提交拉取请求。对于重大更改,请先打开一个问题来讨论您想要更改的内容。

请确保适当地更新测试。

许可证

MIT

致谢

FasoDev