# مستندات آریانت

> آریانت (Ariaservice، ariaservice.net) ارائه‌دهنده خدمات ابری است. این مستندات وب سرویس‌های عمومی آن روی https://api.ariaservice.net (ابر آریانت، VPS، VPS منطقه‌ای، هاست اشتراکی، سرور اختصاصی و پیامک)، ابزار خط فرمان `arianet` و پرووایدر Terraform با نام `ariaservice/arianet` را پوشش می‌دهد.

- همه وب سرویس‌ها با یک توکن شخصی API کار می‌کنند که به صورت `Authorization: Bearer <token>` فرستاده می‌شود؛ توکن در پنل، در https://cloud.ariaservice.net/users/api-tokens ساخته می‌شود و می‌توان آن را به دسترسی‌ها (scope) و IPهای مشخص محدود کرد.
- هر محصول آدرس پایه و قالب خطای خودش را دارد؛ پیش از فراخوانی، صفحه همان محصول را بخوانید.
- توکن را هرگز در کد سمت کاربر یا مخزن کد نگذارید. هنگام سفارش VPS هدر `Idempotency-Key` و هنگام ارسال پیامک `client_reference` بفرستید تا تکرار درخواست دو بار هزینه نکند.
- عملیات طولانی ناهمگام هستند: پاسخ 201 یا 202 همراه یک action می‌دهند که باید تا رسیدن به وضعیت نهایی بررسی شود.

## شروع

- [مستندات آریانت](https://docs.ariaservice.net/intro.md): نقشه مستندات آریانت - همه وب سرویس‌ها (ابر، VPS، VPS منطقه‌ای، هاستینگ، سرور اختصاصی، پیامک)، CLI و Terraform، آدرس‌های پایه و مسیر شروع برای هر نقش.
- [شروع سریع](https://docs.ariaservice.net/quickstart.md): در چند دقیقه توکن API بسازید، اولین درخواست را با curl، CLI، Python، Node.js یا Go بفرستید و اولین سرور ابری خود را بسازید و حذف کنید.
- [احراز هویت و توکن](https://docs.ariaservice.net/authentication.md): ساخت توکن API آریانت، ارسال آن به صورت Bearer، دسترسی‌های (scope) هر وب سرویس، محدودیت IP، اعضای تیم، ابطال توکن و نگه‌داری امن آن در CI.
- [مبانی وب سرویس](https://docs.ariaservice.net/api-conventions.md): قواعد مشترک وب سرویس‌های آریانت - آدرس‌ها و نسخه‌ها، قالب پاسخ و خطا، محدودیت نرخ و تکرار درخواست، صفحه‌بندی، عملیات ناهمگام، ایدمپوتنسی و ریجن‌ها.
- [مفاهیم و واژه‌نامه](https://docs.ariaservice.net/concepts.md): توضیح ساده اصطلاحات مستندات آریانت - وب سرویس، توکن، scope، ریجن، دیتاسنتر، پلن، ایمیج، اسنپ‌شات، IP شناور، لود بالانسر، هاست، خط پیامک و صورتحساب ساعتی.
- [مستندات برای هوش مصنوعی](https://docs.ariaservice.net/ai.md): استفاده از مستندات آریانت در ChatGPT، Claude، Cursor و عامل‌های خودکار - llms.txt، llms-full.txt، نسخه Markdown هر صفحه، سندهای OpenAPI و قواعد امن برای عامل‌ها.

## راهنمای پنل کاربری

- [آشنایی با پنل کاربری](https://docs.ariaservice.net/panel.md): نگاهی کلی به پنل کاربری آریانت؛ منوی کناری و جابه‌جایی بین محصولات، نوار بالا، جستجو، اعلان‌ها، حالت تاریک، منوی کاربر و جابه‌جایی بین حساب‌ها.
- [ثبت‌نام و ورود](https://docs.ariaservice.net/panel/login.md): ثبت‌نام و ورود به پنل آریانت با شماره موبایل یا ایمیل، کد پیامکی، رمز عبور، اپلیکیشن احراز هویت و کلید عبور.
- [احراز هویت](https://docs.ariaservice.net/panel/identity.md): احراز هویت حساب در آریانت، مهلت ۲۴ ساعته پس از خرید، محدودیت حساب احرازنشده، اطلاعات حقوقی و ثبت IP سرور در سامانه شاهکار.
- [داشبورد](https://docs.ariaservice.net/panel/dashboard.md): داشبورد پنل آریانت؛ خلاصه‌ی سرورها، موجودی، برآورد هزینه‌ی ماه و دسترسی سریع.
- [شارژ حساب و کیف پول](https://docs.ariaservice.net/panel/wallet.md): افزایش موجودی حساب آریانت با درگاه بانکی، رمزارز USDT، فیش بانکی و پرداخت خودکار (پرداخت هوشمند)، و مدیریت کیف پول‌ها.
- [تراکنش‌ها و صورتحساب‌ها](https://docs.ariaservice.net/panel/billing.md): مشاهده‌ی تراکنش‌ها، گزارش تجمیعی مصارف، صورتحساب ماهانه، جزئیات مصرف هر سرویس، دریافت PDF فاکتور و سهمیه‌ی منابع در پنل آریانت.
- [پروفایل و امنیت](https://docs.ariaservice.net/panel/profile.md): ویرایش پروفایل، اطلاعات هویتی و حقوقی، تغییر رمز عبور، ورود دومرحله‌ای با اپلیکیشن احراز هویت و Passkey، دستگاه‌های مورد اعتماد و تنظیم اعلان‌ها در پنل آریانت.
- [کلید SSH و توکن API](https://docs.ariaservice.net/panel/ssh-keys-api.md): افزودن کلید SSH برای ورود امن به سرورها و ساخت توکن API با دسترسی محدود برای CLI، Terraform و وب سرویس آریانت.
- [تیکت پشتیبانی](https://docs.ariaservice.net/panel/tickets.md): ثبت و پیگیری تیکت پشتیبانی در پنل آریانت، انتخاب بخش و سرویس، پیوست فایل و ارسال امن اطلاعات محرمانه.
- [تیم، سازمان و دسترسی‌ها](https://docs.ariaservice.net/panel/team.md): دعوت اعضای تیم، تعریف سیاست دسترسی مثل IAM، گروه‌بندی سرویس‌ها در Workspace با بودجه، و ساخت سازمان با کیف پول جدا در پنل آریانت.
- [سرور مجازی (VPS)](https://docs.ariaservice.net/panel/vps.md): خرید سرور مجازی ساعتی در پنل آریانت قدم به قدم، و مدیریت آن؛ کنسول VNC، اطلاعات ورود، حالت رسکیو، DNS معکوس، نصب مجدد، ارتقای پلن، تعویض IP، پشتیبان‌گیری، فایروال و حذف.
- [ابر آریانت](https://docs.ariaservice.net/panel/cloud.md): ساخت سرور ابری ساعتی در پنل آریانت قدم به قدم، و مدیریت آن؛ شبکه و DNS معکوس، اسنپ‌شات، پشتیبان‌گیری، هزینه‌ها، حالت نجات، دیسک، فایروال، پروژه‌ها و حذف.
- [سرور اختصاصی](https://docs.ariaservice.net/panel/baremetal.md): سفارش سرور اختصاصی در پنل آریانت قدم به قدم، پیگیری مراحل سفارش، اطلاعات ورود یک‌باره، نصب سیستم عامل، تمدید و لغو سفارش.
- [هاستینگ](https://docs.ariaservice.net/panel/hosting.md): خرید هاست اشتراکی یا نمایندگی در پنل آریانت قدم به قدم، اتصال دامنه با نیم‌سرور، ورود به کنترل‌پنل، ایمیل، دیتابیس، امنیت CageFS، تمدید، ترافیک مازاد و حذف هاست.
- [دامنه، SSL و Cloudflare](https://docs.ariaservice.net/panel/domains.md): ثبت، انتقال و تمدید دامنه در پنل آریانت، پروفایل دامنه، نیم‌سرور، قفل دامنه، DNSSEC، گواهی SSL و اتصال Cloudflare.
- [پیامک](https://docs.ariaservice.net/panel/sms.md): ارسال پیامک تکی و گروهی در پنل آریانت، برآورد هزینه، زمان‌بندی، خطوط ارسال، قالب‌ها، پیام‌های دریافتی، وب‌هوک و اتصال با API.
- [مرکز رسیدگی تخلفات](https://docs.ariaservice.net/panel/abuse-center.md): مشاهده‌ی گزارش‌های تخلف (Abuse) سرویس‌ها در پنل آریانت، امتیاز سوءاستفاده، پاسخ به گزارش و درخواست فعال‌سازی مجدد.

## ابر آریانت

- [وب سرویس ابر آریانت](https://docs.ariaservice.net/cloud-api.md): وب سرویس ابر آریانت روی api.ariaservice.net/cloud/v1 - سرورها، دیسک‌ها، شبکه‌ها، فایروال‌ها، IPها، لود بالانسرها، ایمیج‌ها، قیمت‌ها و محدودیت نرخ.

## سرور مجازی (VPS)

- [وب سرویس VPS](https://docs.ariaservice.net/api-endpoints.md): وب سرویس VPS آریانت روی api.ariaservice.net/api/v1 - سفارش سرور با Idempotency-Key، عملیات ناهمگام، کلیدهای SSH، فایروال‌ها، موجودی، فاکتورها، دسترسی‌ها و کدهای خطا.
- [وب سرویس VPS منطقه‌ای](https://docs.ariaservice.net/regional-vps-api.md): وب سرویس VPS منطقه‌ای آریانت (مثل iran-1) روی api.ariaservice.net/vps/v1 - سفارش، روشن و خاموش، نصب مجدد، تغییر پلن، کنسول و ترافیک.

## هاستینگ

- [وب سرویس هاستینگ](https://docs.ariaservice.net/hosting-api.md): وب سرویس هاست اشتراکی آریانت روی api.ariaservice.net/hosting/v1 - سفارش و مدیریت اکانت، DNS، ایمیل، دیتابیس، SSH، ریجن‌ها و خطاها.

## سرور اختصاصی

- [وب سرویس سرور اختصاصی](https://docs.ariaservice.net/baremetal-api.md): وب سرویس سرور اختصاصی (Baremetal) آریانت روی api.ariaservice.net/baremetal/v1 - کاتالوگ، قیمت، سفارش، تمدید، مشخصات ورود و نصب سیستم‌عامل.

## پیامک

- [وب سرویس پیامک](https://docs.ariaservice.net/sms/api.md): وب سرویس پیامک آریانت روی api.ariaservice.net/sms/v1 - ارسال پیامک، گزارش تحویل، خطوط، قالب‌ها، شماره‌های مسدود و وب‌هوک.

## ابزارهای توسعه

- [رابط خط فرمان آریانت (CLI)](https://docs.ariaservice.net/cli.md): نصب و استفاده از ابزار خط فرمان arianet برای مدیریت VPS، منابع ابر آریانت، کلیدهای SSH، فایروال‌ها و صورتحساب.
- [پرووایدر Terraform](https://docs.ariaservice.net/terraform.md): مدیریت سرورها، دیسک‌ها، شبکه‌ها، فایروال‌ها، IPهای شناور و لود بالانسرهای ابر آریانت به صورت کد با پرووایدر Terraform با نام ariaservice/arianet.

## مرجع

- [مرجع API](https://docs.ariaservice.net/api-reference.md): همه وب سرویس‌های آریانت در یک نگاه - آدرس پایه، سند OpenAPI، مرجع تعاملی، دسترسی‌ها و راهنمای هر کدام، به همراه ساخت کلاینت از روی OpenAPI.

## سندهای OpenAPI

- [Cloud API](https://api.ariaservice.net/cloud/v1/openapi.json): base URL https://api.ariaservice.net/cloud/v1
- [VPS API](https://docs.ariaservice.net/openapi.yaml): base URL https://api.ariaservice.net/api/v1
- [Regional VPS API](https://api.ariaservice.net/vps/v1/openapi.json): base URL https://api.ariaservice.net/vps/v1
- [Hosting API](https://api.ariaservice.net/hosting/v1/openapi.json): base URL https://api.ariaservice.net/hosting/v1
- [Dedicated servers API](https://api.ariaservice.net/baremetal/v1/openapi.json): base URL https://api.ariaservice.net/baremetal/v1
- [SMS API](https://api.ariaservice.net/sms/v1/openapi.json): base URL https://api.ariaservice.net/sms/v1

## اختیاری

- [llms-full.txt](https://docs.ariaservice.net/llms-full.txt): همه صفحه‌ها در یک فایل
- [llms.txt](https://docs.ariaservice.net/en/llms.txt): English version of these docs