API آراچت

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

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

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

curl https://panel.arahub.app/api/me/workspaces/ \
  -H "Authorization: Bearer ara_pat_XXXXXXXXXXXX"

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

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

موقع فرستادن پیام یه client_id بفرست: اگه درخواست قطع شد و دوباره فرستادیش، آراچت با همون شناسه پیام رو دو بار ثبت نمی‌کنه. بدون این، هر تلاش دوباره یه پیام تازه‌ست.

curl -X POST "https://chat.arahub.app/api/conversations/<public_id>/messages/" \
  -H "Authorization: Bearer ara_pat_XXXXXXXXXXXX" \
  -H "Content-Type: application/json" \
  -d '{"body":"سلام","client_id":"c3f1a0d2-..."}'

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

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