اخیرا پروژه‌ای را شروع کردم که از API یک ابزار مدیریت پروژه به نام Asana استفاده می‌کند. پس تصمیم گرفتم معرفی کوتاهی برای هر کسی که می‌خواهد از آن استفاده کند، بنویسم.
با این API، این مقاله می‌تواند مثال خوبی برای یک سرویس که پکیج PHP رسمی خودش را دارد، و نحوه استفاده از آن باشد.
در ابتدا، ظاهر Asana به صورت زیر است. اگر بخواهیم در سطح پایه بگوییم، Asana فقط یک لیست متشکل از عملیات‌ها است.
کار من در اینجا این بود که عملیات را توسط ای‌پی‌آی Asana به لاراول ببرم. حال بیایید همین کار را انجام دهیم:
قدم ۱ - ژتون Asana را بسازید
برای انجام این کار، به صفحه «My Profile Setting» در Asana بروید و به مانند اسکرین شات‌های زیر، با چند کلیک، ژتون مورد نظر را بسازید:
قدم ۲ - از پکیج Asana استفاده کنید
Asana پکیج رسمی PHP خود را دارد: Asana/php-asana. دقت کنید که این پکیج مخصوص لاراول نیست؛ بلکه با هر نوع PHP که استفاده می‌کنید، سازگار است. به عبارتی دیگر، با هر فریم‌وورکی تطابق پیدا می‌کند.
حال آن را در برنامه لاراول خود نصب می‌کنیم:
composer install asana/asana
سپس داخل کنترلر (که البته من پیشنهاد می‌کنم یک AsanaService مجزا بسازید) می‌توانیم این کار را انجام دهیم:
use Asana\Client;
// ...
// از ژتون گرفته شده در مرحله ۱ استفاده می‌کنیم
$asana_client = Client::accessToken(env('ASANA_PERSONAL_ACCESS_TOKEN'));
// دریافت لیست پروژه‌ها
$projects = $asana_client->get('/projects', []);
// دریافت لیست عملیات‌های یک پروژه
$tasks = $asana_client->get('/projects/' . $projects[0] . '/tasks', []);
به همین سادگی! این بود، مثال ساده‌ای برای استفاده از پکیج‌های رسمی.
دیدگاه و پرسش
در حال دریافت نظرات از سرور، لطفا منتظر بمانید
در حال دریافت نظرات از سرور، لطفا منتظر بمانید