وصل کردن هوش مصنوعی به Abrivo ویژهٔ Pro

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

۱. کلید API بساز

اول باید حساب Pro داشته باشی. بعد برو تنظیمات → دسترسی API و یک کلید جدید بساز. کلید فقط یک‌بار نشون داده می‌شه، همون‌جا کپیش کن.

۲. راه‌های اتصال

۳. اتصال با MCP (Claude / ChatGPT)

1. در Claude: تنظیمات → Connectors → Add custom connector.
2. آدرس سرور: https://abrivo.ir/mcp
3. هدر احراز هویت: Authorization: Bearer <کلید API خودت>
4. بعد از وصل شدن، کافیه توی چت بگی: «این فایل رو توی آبریوو آپلود کن و لینکش رو بده».

ابزارهای در دسترس مدل: get_account، list_files، get_file، delete_file، share_file، و upload_from_url (وقتی فایل یه لینک قابل‌دسترسی داره — مثلاً لینک دانلود فایل تلگرام — مدل به‌جای رد کردن بایت‌های فایل از این ابزار استفاده می‌کنه).

۴. اتصال با REST API (مثلاً یک ربات تلگرام)

سناریوی «یه فایل بفرست به ربات، بگو آپلودش کن آبریوو، لینک بگیر» دقیقاً همینه: بک‌اند ربات، فایل رو از تلگرام می‌گیره و مستقیم با کلید API آپلود می‌کنه — بدون نیاز به MCP.

آپلود مستقیم فایل

curl -X POST https://abrivo.ir/api/v1/files \
  -H "Authorization: Bearer <API_KEY>" \
  -F "file=@/path/to/file.zip"

آپلود از روی لینک (مثلاً لینک فایل تلگرام)

curl -X POST https://abrivo.ir/api/v1/files/from-url \
  -H "Authorization: Bearer <API_KEY>" \
  -H "Content-Type: application/json" \
  -d '{"url": "https://api.telegram.org/file/bot<TOKEN>/<path>", "filename": "video.mp4"}'

پاسخ هر دو حالت یک آبجکت فایل با share_url برمی‌گردونه — همون لینکی که باید به کاربر بدی.

سایر endpointها

• GET /api/v1/me — وضعیت حساب و فضای باقی‌مونده
• GET /api/v1/files — لیست فایل‌ها
• GET /api/v1/files/{id} — جزئیات یک فایل
• DELETE /api/v1/files/{id} — حذف فایل
• POST /api/v1/files/{id}/share — فعال‌سازی/ساخت مجدد لینک اشتراک