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

وب سرویس سرور اختصاصی، کاتالوگ سرورها، قیمت‌گذاری یک پیکربندی، سفارش، پیگیری مراحل تحویل، تمدید ماهانه، دریافت مشخصات ورود و نصب سیستم‌عامل را پوشش می‌دهد. دستورهای arianet baremetal روی همین وب سرویس ساخته شده‌اند.

• آدرس پایه: https://api.ariaservice.net/baremetal/v1
• قالب: JSON روی HTTPS
• احراز هویت: توکن شخصی API که به صورت Bearer ارسال می‌شود (احراز هویت و توکن)
• OpenAPI 3.1: https://api.ariaservice.net/baremetal/v1/openapi.json که در مرجع تعاملی قابل مرور است

شروع سریع

1. در پنل، در cloud.ariaservice.net/users/api-tokens توکنی با دسترسی‌های baremetal:servers:read و baremetal:servers:write بسازید.
2. کاتالوگ را بخوانید، پیکربندی را قیمت بگیرید و سفارش دهید:

export ARIANET_TOKEN="paste-your-token-here"
BASE=https://api.ariaservice.net/baremetal/v1
AUTH="Authorization: Bearer $ARIANET_TOKEN"

curl -s "$BASE/plans?range=rise" -H "$AUTH"
curl -s "$BASE/plans/eco/24rise01/options" -H "$AUTH"
curl -s $BASE/rules -H "$AUTH"                        # the rules version the order must accept
curl -s -X POST $BASE/quote -H "$AUTH" -H "Content-Type: application/json" \
  -d '{"catalog":"eco","plan_code":"24rise01","datacenter":"fra","memory":"ram-32g","storage":"softraid-2x512nvme","bandwidth":"1gbps"}'
curl -s -X POST $BASE/orders -H "$AUTH" -H "Content-Type: application/json" \
  -d '{"catalog":"eco","plan_code":"24rise01","datacenter":"fra","memory":"ram-32g","storage":"softraid-2x512nvme","bandwidth":"1gbps","rules_version":"2026-10","accept_rules":true}'

مبلغ سفارش روی کیف پول نگه داشته می‌شود و تحویل مراحلی دارد که با GET /orders/{id} دیده می‌شوند. پیش از شروع خرید می‌توان سفارش را لغو کرد و کل مبلغ آزاد می‌شود.

احراز هویت و دسترسی‌ها

دسترسی (scope)	اجازه
baremetal:servers:read	کاتالوگ، قیمت، سفارش‌ها، سرورها و تمدیدها
baremetal:servers:write	سفارش و لغو، پرداخت تمدید، نمایش مشخصات ورود و نصب سیستم‌عامل

توکن بدون هیچ دسترسی، بدون محدودیت است. سرور اختصاصی فقط یک نصب دارد؛ هدر Arianet-Region برای آن پاسخ 404 region_not_found می‌گیرد.

منابع

متد و مسیر	کاربرد
GET /suppliers ، GET /ranges ، GET /plans	کاتالوگ
GET /plans/{catalog}/{plan}/options	دیتاسنترها، حافظه، دیسک و پهنای باند با قیمت
GET /rules	قوانینی که سفارش باید بپذیرد
POST /quote	قیمت یک پیکربندی (چیزی نگه داشته نمی‌شود)
GET /orders ، POST /orders ، GET /orders/{id}	سفارش‌ها و مراحلشان
POST /orders/{id}/cancel	لغو پیش از شروع خرید
GET /servers ، GET /servers/{id}	سرورهای تحویل‌شده
POST /servers/{id}/credentials/reveal	مشخصات ورود (فقط یک بار نمایش داده می‌شود)
GET /servers/{id}/renewals ، POST /servers/{id}/renew	تمدیدها و پرداخت تمدید ماه بعد
GET /servers/{id}/os-templates ، POST /servers/{id}/reinstall ، GET /servers/{id}/reinstall	نصب سیستم‌عامل (دیسک‌ها پاک می‌شوند) و وضعیت آن

خطاها

خطاها JSON به شکل {"error": "...", "code": "..."} هستند.

HTTP	code
400	invalid_input
401	unauthorized
402	موجودی کافی نیست
403	forbidden، insufficient_scope
404	not_found، region_not_found
409	وضعیت سفارش یا سرور الان اجازه نمی‌دهد
429	rate_limit_exceeded
503	baremetal_unavailable