‏SDK رسمی تایپ‌اسکریپتی برای API توییتر (X)

تو این صفحه اومده که پلتفرم X (همون توییتر سابق) یه SDK رسمی تایپ‌اسکریپتی به اسم XDK منتشر کرده که کار با API این شبکه رو ساده‌تر می‌کنه. نقطهٔ قوت اصلیش اینه که کل endpointها و پارامترها تایپ کامل دارن، پس موقع کد زدن خود ادیتور بهت میگه چی درسته و چی غلط — دیگه لازم نیست پکیج تایپ جدا نصب کنی.

برای احراز هویت سه روش رو پشتیبانی می‌کنه: Bearer Token برای کارهای فقط‌خوندنی و دادهٔ عمومی، و OAuth 1.0a و OAuth 2.0 برای عملیات‌هایی که به اکانت یه کاربر خاص گره خوردن. ساختن کلاینت هم خیلی سرراسته؛ کافیه یه config با توکن بدی و یه نمونه از Client بسازی:

import { Client } from '@xdevplatform/xdk';

const client = new Client({ bearerToken: 'your-bearer-token' });
const userResponse = await client.users.getByUsername('XDevelopers');
console.log(userResponse.data?.username);

یکی از بخش‌های جذابش صفحه‌بندیه. به‌جای اینکه خودت توکن صفحهٔ بعدی رو دستی مدیریت کنی، با paginatorهای آماده می‌تونی هر endpointی که جواب صفحه‌بندی‌شده برمی‌گردونه رو wrap کنی و بعد یا دستی صفحه‌به‌صفحه جلو بری، یا با یه حلقهٔ for await روی همهٔ آیتم‌ها پیمایش کنی. خطاها و محدودیت نرخ (rate limit) هم با یه فلگ مثل rateLimited قابل تشخیصه که بدونی کِی باید عقب بکشی.

بخش استریم هم اجازه می‌ده به فید بلادرنگ پست‌ها وصل شی و خود SDK قطعی اتصال رو با reconnect خودکار مدیریت می‌کنه. ضمناً چون از پیاده‌سازی crypto خالص جاوااسکریپتی و fetch بومی استفاده می‌کنه، روی Node.js، مرورگرهای مدرن و React Native بدون polyfill اضافه کار می‌کنه.

نکات کلیدی:

• XDK یه SDK رسمی تایپ‌اسکریپتی از خود X برای کار با API توییتره
• سه روش احراز هویت: Bearer Token، OAuth 1.0a و OAuth 2.0
• صفحه‌بندی خودکار با paginator و پشتیبانی از پیمایش async
• استریم بلادرنگ با اتصال مجدد خودکار و تشخیص rate limit
• روی Node.js، مرورگر و React Native بدون polyfill اضافه اجرا می‌شه