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

API آرامیت

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

اولین درخواست
curl https://panel.arameet.ir/api/me/ \
  -H "Authorization: Bearer ara_pat_XXXXXXXXXXXX"
۱

توکن بساز

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

دسترسی API روی پلن‌های اشتراکی فعاله. اگه فضای کاریت روی پلن دیگه‌ایه، دکمه ساخت توکن غیرفعاله. اگه پلن بعدا پایین بیاد، توکن‌های ساخته‌شده هم از کار می‌افتن. مقایسه پلن‌ها
۲

احراز هویت

توکن رو توی هدر Authorization بفرست. توکن با اختیارات خودت کار می‌کنه — نه بیشتر.

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

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

۳

تسک بساز

متد POST با بدنه JSON. تنها فیلد اجباری workspace است؛ عنوان، توضیح، اولویت، مهلت، موضوع، مسئول‌ها و برچسب‌ها همه اختیارین. جواب، خودِ تسکِ ساخته‌شده‌ست — شناسه‌ای که برمی‌گردونه همونیه که برای ویرایش بعدی با PATCH /tasks/<id>/ لازم داری.

ساخت تسک
curl -X POST https://panel.arameet.ir/api/tasks/ \
  -H "Authorization: Bearer ara_pat_XXXXXXXXXXXX" \
  -H "Content-Type: application/json" \
  -d '{"workspace":"<uuid>","title":"بازطراحی صفحه فرود","priority":"high"}'

به چی دسترسی داری

جلسه‌ها
فهرست و جزئیات جلسه، به‌همراه رونوشت، خلاصه و صورت‌جلسه.
تسک‌ها
کل برد، ساخت و ویرایش تسک، و گفتگوی هر کارت.
یادداشت‌ها
یادداشت‌های خودت، جدا یا وصل به یک جلسه.
فضای کاری و موضوع
فضاهای کاری‌ات و پوشه‌هایی که همه‌چیز زیرشون دسته‌بندی می‌شه.

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

چیزهایی که خوبه بدونی

صفحه‌بندی
فهرست‌های بلند ۵۰تایی صفحه‌بندی می‌شن — با ?page=.
توکن رو مثل گذرواژه نگه دار
توی مخزن کد نذارش. لو رفت، از پروفایل باطلش کن — بلافاصله از کار می‌افته.
خطاها — همیشه یک JSON با کلید detail
۴۰۱توکن نامعتبره یا باطل شده.
۴۰۲پلن این فضای کاری اجازه نمی‌ده.
۴۰۳به این فضای کاری دسترسی نداری.
۴۲۹از سقف درخواست در دقیقه رد شدی.

چیزی که لازم داری اینجا نیست؟

این صفحه بخش پایدار API رو پوشش می‌ده. اگه به مسیر دیگه‌ای نیاز داری یا جایی گیر کردی، بهمون ایمیل بزن: hello@arameet.ir

همین امروز اولین جلسه‌ات رو هوشمند کن

رایگان شروع کن، فایل یه جلسه رو آپلود کن و چند دقیقه بعد صورت‌جلسه و تسک‌هاش رو تحویل بگیر.