SDK و کتابخانه‌ها

وضعیت SDKها

در نسخه فعلی بسته رسمی جداگانه‌ای در npm یا PyPI منتشر نشده است. APIها بر پایه HTTP و JSON هستند و می‌توان آن‌ها را با ابزارهای استاندارد هر زبان مصرف کرد.

TypeScript

یک wrapper کوچک، کنترل status و قرارداد پاسخ را در یک نقطه متمرکز می‌کند.

type ApiResponse<T> =
  | { status: "success"; data: T }
  | { status: "error"; message: string }

export async function getHealth() {
  const response = await fetch("https://tusihub.ir/api/health")
  if (!response.ok) throw new Error(`Health check failed: ${response.status}`)
  return response.json()
}

Python

برای health check به کتابخانه خارجی نیاز نیست و urllib استاندارد کافی است.

import json
from urllib.request import Request, urlopen

request = Request(
    "https://tusihub.ir/api/health",
    headers={"Accept": "application/json"},
)

with urlopen(request, timeout=10) as response:
    payload = json.load(response)
    print(payload["status"])

قواعد یک کلاینت پایدار

wrapper شما باید ساده، قابل تست و مستقل از UI باقی بماند.

• timeout را برای همه درخواست‌های شبکه مشخص کنید
• پاسخ را پیش از استفاده با schema اعتبارسنجی کنید
• credential را فقط در محیط سرور نگه دارید
• خطاها را بدون ثبت payload حساس log کنید