راهنمای احراز هویت

<?php
 
use Basalam\SDK\BasalamClient;
use Basalam\SDK\Auth\PersonalToken;
 
function personalTokenExample(): object
{
    // مقداردهی اولیه با توکن‌های موجود
    $auth = new PersonalToken(
        token: 'your_access_token',
        refreshToken: 'your_refresh_token'
    );
 
    // ایجاد کلاینت احراز هویت شده
    $client = new BasalamClient($auth);
 
    // دریافت اطلاعات کاربر جاری
    $user = $client->getCurrentUser();
    return $user;
}

<?php
 
use Basalam\SDK\BasalamClient;
use Basalam\SDK\Auth\AuthorizationCode;
use Basalam\SDK\Auth\Scope;
 
// مرحله ۱: ایجاد شیء احراز هویت
$auth = new AuthorizationCode(
    clientId: 'your-client-id',
    clientSecret: 'your-client-secret',
    redirectUri: 'https://your-app.com/callback',
    scopes: [
        Scope::CUSTOMER_WALLET_READ,
        Scope::CUSTOMER_ORDER_READ
    ]
);
 
// مرحله ۲: دریافت URL مجوز
$authUrl = $auth->getAuthorizationUrl(state: 'optional_state_parameter');
echo "Visit: {$authUrl}\n";
 
// مرحله ۳: تبادل کد با توکن‌ها (بعد از دریافت کد از کاربر از آدرس برگشتی ثبت‌شده در کلاینت)
$tokenInfo = $auth->getToken(code: 'authorization_code_from_callback');
 
// مرحله ۴: ایجاد کلاینت احراز هویت شده
$client = new BasalamClient($auth);

<?php
 
// مثال با استفاده از Laravel
use Illuminate\Http\Request;
use Illuminate\Support\Facades\Redirect;
use Basalam\SDK\Auth\AuthorizationCode;
 
class AuthController extends Controller
{
    public function login()
    {
        $auth = new AuthorizationCode(
            clientId: 'your-client-id',
            clientSecret: 'your-client-secret',
            redirectUri: 'https://your-app.com/callback'
        );
 
        $authUrl = $auth->getAuthorizationUrl(state: 'user_session_id');
        return Redirect::to($authUrl);
    }
 
    public function callback(Request $request)
    {
        $code = $request->get('code');
        $state = $request->get('state');
 
        $auth = new AuthorizationCode(
            clientId: 'your-client-id',
            clientSecret: 'your-client-secret',
            redirectUri: 'https://your-app.com/callback'
        );
 
        // تبادل کد با توکن‌ها
        $tokenInfo = $auth->getToken(code: $code);
 
        // ذخیره امن توکن‌ها
        // ... ذخیره $tokenInfo->accessToken, $tokenInfo->refreshToken
 
        return 'Authentication successful!';
    }
}

<?php
 
use Basalam\SDK\BasalamClient;
use Basalam\SDK\Auth\ClientCredentials;
use Basalam\SDK\Auth\Scope;
 
// احراز هویت پایه
$auth = new ClientCredentials(
    clientId: 'your-client-id',
    clientSecret: 'your-client-secret',
    scopes: [
        Scope::CUSTOMER_WALLET_READ,
        Scope::VENDOR_PRODUCT_WRITE
    ]
);
 
// ایجاد کلاینت
$client = new BasalamClient($auth);

<?php
 
function clientCredentialsExample(): object
{
    $auth = new ClientCredentials(
        clientId: 'your-client-id',
        clientSecret: 'your-client-secret'
    );
    $client = new BasalamClient($auth);
 
    // دریافت موجودی کاربر
    $balance = $client->getBalance(userId: 123);
 
    return $balance;
}

<?php
 
function tokenManagementExample(): object
{
    $auth = new ClientCredentials(
        clientId: 'your-client-id',
        clientSecret: 'your-client-secret'
    );
 
    // دریافت توکن - اگر منقضی نشده باشد از توکن موجود استفاده می‌کند
    $tokenInfo = $auth->getToken();
 
    return $tokenInfo;
}

<?php
 
use Basalam\SDK\Auth\Scope;
 
// محدوده‌های رایج
Scope::CUSTOMER_WALLET_READ;      // خواندن کیف پول مشتری
Scope::CUSTOMER_WALLET_WRITE;     // نوشتن در کیف پول مشتری
Scope::VENDOR_PRODUCT_READ;       // خواندن محصولات غرفه‌دار
Scope::VENDOR_PRODUCT_WRITE;      // نوشتن محصولات غرفه‌دار
Scope::CUSTOMER_ORDER_READ;       // خواندن سفارشات مشتری
Scope::CUSTOMER_ORDER_WRITE;      // نوشتن سفارشات مشتری

<?php
 
use Basalam\SDK\Auth\ClientCredentials;
use Basalam\SDK\Auth\Scope;
 
$auth = new ClientCredentials(
    clientId: 'your-client-id',
    clientSecret: 'your-client-secret',
    scopes: [
        Scope::CUSTOMER_WALLET_READ,
        Scope::VENDOR_PRODUCT_WRITE,
        Scope::CUSTOMER_ORDER_READ
    ]
);