SDK برای TypeScript

وضعیت

هر چیزی که SDK قرار بود بپوشاند امروز روی HTTP ساده در دسترس است، و نمونه‌های سراسر این مستندات از چیزی جز fetch داخلی استفاده نمی‌کنند. اگر همین حالا کلاینت تایپ‌دار می‌خواهید، سریع‌ترین راه نوشتن یک لایهٔ نازک دور مسیرهای این مرجع است — سطح API آن‌قدر کوچک هست که تولید کلاینت از روی OpenAPI schema هم منطقی باشد.

شکل پیش‌بینی‌شده

شکلی که در نظر بوده، اگر برای ساختاردهی به لایهٔ خودتان کمکتان می‌کند: یک سازندهٔ کلاینت که کلید را نگه می‌دارد، برای هر بخش از API یک فضای نام، و پاسخ‌های تایپ‌داری که پوشش را باز می‌کنند تا فراخوان هرگز خودش با data سروکار نداشته باشد.

همچنین دو شکل خطا را به یک خطای تایپ‌دار یکسان تبدیل می‌کرد، مهلت زمانی و سیاست تلاش دوباره — فقط برای 5xx — داشت، و AbortSignal می‌پذیرفت؛ همان چهار چیزی که هر لایهٔ دست‌نویسی سرانجام به آن‌ها نیاز پیدا می‌کند.

چه چیزی مانع است

هیچ مانع فنی‌ای وجود ندارد؛ فقط ساخته نشده است. REST API که اینجا مستند شده به‌قدر کافی پایدار هست که همین امروز بشود کلاینتی رویش نوشت، و این صفحه وقتی SDK واقعی وجود داشته باشد با مستندات واقعی جایگزین می‌شود.