astelbe/sdk-php

用于PHP网站访问Astel API和电信数据的SDK


README

这是一个轻量级的Astel API客户端库,适用于PHP。SDK最适合实现一些自己的功能。例如:电信产品目录列表、选项、比较、订购和销售报告的联合优惠。整个Astel.be网站都是使用此SDK和API作为数据源编写的。

您可以使用此SDK实现自己的网站,或者使用易于集成的现成工具 - 网络集成模块。这些模块可以通过在您的代码中插入一些HTML标签注入到任何面向互联网的应用程序或网站中。

Astel SDK安装

通过Composer安装。

$ composer require astelbe/sdk-php

然后在您的PHP代码中使用它

require_once 'vendor/autoload.php';

或者,简单下载我们的代码存档并将其上传到您的应用程序。

使用方法

请参阅我们的开发者网站以获取更多示例。

Astel SDK初始化

// All methods require authentication. To get your Astel API Private Token credentials, contact us

require_once 'vendor/autoload.php';

use AstelSDK\Model\Partner;
use AstelSDK\Model\Brand;

$envParticle = ''; // '' for production, 'sta' for staging env
$apiToken = '12345abcde'; // API Private Token provided by Astel
$isDebug = false; // For more debug info
$logPath = null; // Null for no logs, a valid writable path for file logs
$isPrivate = true; // Default private / professionnal param (Optionnal)
$language = 'FR'; // Default language used by the page (Optionnal)

$AstelApiContext = new AstelSDK\AstelContext($envParticle, $apiToken, $isDebug, $logPath);
$AstelApiContext->setIsPrivate($isPrivate);
$AstelApiContext->setLanguage($language);

// Utils debug function registering
AstelSDK\AstelContext::registerUtilsFunctions();

现在您已准备好调用API并检索数据。

产品示例

$Product = AstelSDK\Model\Product::getInstance();

$products = $Product->find('all', [
	'_embed' => 'play_description,commission,web',
	'brand_id' => 3 // VOO
]);

debug($products);

$productVOOOne = $Product->find('first', [
	'id' => '1999', // VOO One
	'_embed' => 'play_description,commission,web',
]);

debug($productVOOOne);

它检索所有VOO产品及其完整描述、相关佣金和现金回扣以及产品页面的Web链接,第二个示例检索单个产品:Voo One。

折扣示例

$Discount = Discount::getInstance();

$discounts = $Discount->find('all', [
	'brand_id' => 3,
	'_embed' => 'subscription_periods/product/commission,subscription_periods/product/web',
	'order' => '-weight',
	'count' => 50,
]);

debug($discounts);

它检索前50个活跃的VOO折扣,按权重排序并检索相关递归模型:subscription_periods/product/commission和subscription_periods/product/web。

支持的平台

  • PHP 7.0或更高版本

如何贡献

欢迎所有提交。Fork存储库,阅读此README文件的其余部分,并进行一些更改。一旦完成更改,发送pull请求。谢谢!

需要帮助?发现错误?

如果您需要任何帮助,请提交问题。当然,您可以随时提交包含错误修复或更改的pull请求。

如有更多信息或帮助集成,请随时联系Astel,邮箱:direction@astel.be