📘 اصول اولیه

در اینجا یک مثال از متد getMe() API آورده شده است که می‌توانید برای تست توکن احراز هویت ربات خود استفاده کنید. این متد اطلاعات پایه‌ای در مورد ربات به شکل یک شیء User باز می‌گرداند.

برای جزئیات بیشتر به مستندات getMe مراجعه کنید.

مستقل

require __DIR__.'/vendor/autoload.php';

use EFive\Bale\Api;

$bale = new Api('YOUR BOT TOKEN');
$response = $bale->getMe();

لاراول

استفاده از Facade

use EFive\Bale\Laravel\Facades\Bale;

$response = Bale::getMe();

استفاده از Service Container

در اینجا یک مثال با استفاده از Service Container لاراول یا همان تزریق وابستگی آورده شده است.

<?php

namespace App\Http\Controllers;

use App\Http\Controllers\Controller;
use EFive\Bale\Api;

class BotController extends Controller
{
    protected $bale;

    /**
     * Create a new controller instance.
     *
     * @param  Api  $bale
     */
    public function __construct(Api $bale)
    {
        $this->bale = $bale;
    }

    /**
     * Show the bot information.
     */
    public function show()
    {
        $response = $this->bale->getMe();

        return $response;
    }
}

پردازش پاسخ

پاسخ‌های API ربات Bale در SDK به عنوان اشیاء PHP نمایان می‌شوند. SDK ربات Bale از تمام انواع موجود اشیاء پاسخ با متدهای مختلف پشتیبانی می‌کند. علاوه بر این، تمام اشیاء مرتبط با یک شیء نیز به طور خودکار به شیء پاسخ PHP مناسب نقشه‌برداری می‌شوند.

در مثال بالا، getMe() یک شیء User را باز می‌گرداند.

بنابراین می‌توانیم مقادیر شیء را به این صورت بازیابی کنیم:

$botId = $response->getId();
$firstName = $response->getFirstName();
$username = $response->getUsername();

اطلاعات بیشتر

SDK ربات Bale از API شگفت‌انگیز Collection لاراول برای نقشه‌برداری خودکار داده‌ها استفاده می‌کند.

بنابراین کار با آرایه داده‌ها بسیار ساده‌تر است. از تمام متدهای ذکر شده در مستندات رسمی پشتیبانی می‌کند.