برای توسعه‌دهنده‌ها

API آراتسک

هر کاری که توی پنل می‌کنی از طریق API هم شدنیه. یه توکن شخصی بساز و از کد خودت پروژه‌ها، بردها و تسک‌ها رو بخون و بساز.

اولین درخواست
curl "https://task.arahub.app/api/projects?workspace=<uuid>" \
  -H "Authorization: Bearer ara_pat_XXXXXXXXXXXX"
۱

توکن بساز

توکن‌ها برای همهٔ محصول‌های آرا یک‌جا ساخته می‌شن: توی آراهاب ← پروفایل ← توکن API یه توکن با نام مشخص بساز. توکن فقط همون یک بار نشون داده می‌شه.

یک توکن برای هر سه محصول کار می‌کنه — آراتسک، آرامیت و آراچت — و دقیقاً همون دسترسی‌هایی رو داره که خودت داری، نه بیشتر.

۲

احراز هویت

توکن رو توی هدر Authorization بفرست.

فضاهای کاری‌ات
curl https://panel.arahub.app/api/me/workspaces/ \
  -H "Authorization: Bearer ara_pat_XXXXXXXXXXXX"

بیشتر مسیرها با ?workspace=<uuid> کار می‌کنن و شناسه‌ش رو از همین جواب برمی‌داری. فضاهای کاری و عضویت‌ها مال آراهابن، برای همین این یک درخواست به آراهاب می‌ره نه به آراتسک.

۳

چی در دسترسه

همون چیزی که توی پنل می‌بینی. فهرست کامل مسیرها، پارامترها و نمونهٔ جواب‌ها توی مستندات زنده‌ست — از روی خود سرویس ساخته می‌شه، پس هیچ‌وقت قدیمی نمی‌مونه.

پروژه‌ها
فهرست و جزئیات پروژه‌های هر فضای کاری.
برد و ستون‌ها
ساختار برد کانبان و ترتیب ستون‌ها.
تسک‌ها
ساخت، ویرایش، جابه‌جایی بین ستون‌ها و آرشیو.
اعضا
اعضای پروژه و نقششون.
۴

خطاها

جواب خطا همیشه یه detail فارسی داره که می‌شه مستقیم به کاربر نشون داد.

۴۰۱توکن نامعتبره یا باطل شده.
۴۰۲پلن این فضای کاری اجازه نمی‌ده.
۴۰۳به این فضای کاری یا پروژه دسترسی نداری.
۴۲۹از سقف درخواست در دقیقه رد شدی.
۵

برای ایجنت‌ها

اگه می‌خوای یه دستیار هوش مصنوعی مستقیم با آراتسک کار کنه، لازم نیست چیزی بنویسی — سرور MCP آرا همین API رو به‌شکل ابزار در اختیارش می‌ذاره.

همین امروز برد اول تیمت رو بساز

رایگان شروع کن، تیمت رو دعوت کن و کارهای این هفته رو همین حالا بذار روی برد.