Vitamin API مرجعی

اؤز سایتینیزدان، بوتونوزدان و یا اسکریپتینیزدن VPN حسابلاری و مجازی سرورلر ساتین و ایداره ائدین.

اساس اۆنوانhttps://apiservice.vitamindata.net/api/v1

آچارلار اؤز پنلینیزده وئریلیر. بۇ بؤلۆمۆ گؤرمۆرسۆنۆزسه، دستکدن ایسته‌یین کی، حسابینیز اۆچون API گیریشینی آچسینلار.

پنلینیزده بیر API آچاری یارادین و اونو هر چاغیریشدا bearer توکنی کیمی گؤندرین.

آچارین ایشله‌دیینی ثابت ائتمک اۆچون Ping چاغیرین، سونرا قیمتلرینیزی ListPlans و GetVPSStorefront ایله چکین.

FUNDING_AUTO ایله ساتین: موجودینیز کیفایت ائدنده او اؤده‌ییر، ائتمه‌ینده مۆشتری‌نیزه اؤده‌نیش لینکی وئریلیر.

کیملیک دوغرولاما

هر سورغو آچارینیزی bearer توکنی کیمی داشییر. بۇ هوستدا کوکی یوخدور و آلیناجاق CSRF توکنی ده یوخدور — آچار بۆتؤو کیملیکدیر.

Authorization: Bearer sk_live_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx

آچارلار پنلینیزده API بؤلۆمۆنده یارادیلیر. گیزلی حیصه یارادیلان آندا بیر دفعه گؤستریلیر: بیز اونون یالنیز هشینی ساخلاییریق، بونا گؤره ایتسه، چاره آچاری چئویرمکدیر — بۇ، یئنی گیزلی حیصه وئریر و کؤهنه‌سینی بیر گۆن ایشلک ساخلاییر کی، کسینتی‌سیز دئپلوی ائده بیله‌سینیز.

بیر آچاری مبدأ اۆنوانلارین سیاهیسی ایله محدودلاشدیرماق، اونا اؤز دقیقه‌لیک سورغو حددینی وئرمک و آیری-آیری عملیاتلاری اوندان اسیرگه‌مک اولار. بونلاری بیزیم اوپراتورلار قۇرور — مثلاً آلا بیلن، آمّا هئچ واخت سرویس سیله بیلمه‌ین بیر آچار لازیمدیرسا، دستکدن ایسته‌یین.

تست آچارلاری

sk_test_ ایله باشلایان آچار حقیقی دیتانی اوخویور، آمّا پول خرجله‌یه‌جک و یا حقیقی ماشینا توخوناجاق هر شئیدن ایمتینا ائدیر — بئله‌لیکله اینتقراسیونونوزو هئچ بیر خرج چیخمامیش قۇروب یوخلایا بیلرسینیز.

اوغورسوزلوق نئجه گؤرونور

تانینمایان آچار و API گیریشی اولمایان حسابین آچاری عئینی 401 جاوابینی کلمه-به-کلمه وئریر: جاواب هئچ واخت بیر آچارین وار اولوب-اولمادیغینی بیلدیرمیر. چئویرمه اؤرتۆشمه‌سیندن سونرا یاشایان اؤز آچارینیز ایسه ایستیثنادیر — او api key expired دئییر، چۆنکی سیز او آچارین حقیقی اولدوغونو آرتیق بیلیرسینیز و نییه دایاندیغینی بیلمه‌لیسینیز. بیر اۆنواندان تکرارلانان اوغورسوزلوقلار یاواشلادیلیر — باخین: سورغو حددلری.

اؤده‌نیش

آلدیغینیز هر شئی — VPN حسابی، اوزاتما، سرور، یئنیله‌مه، یۆکسلتمه — عئینی مقاویله‌دن کئچیر. اؤده‌نیشین نئجه اولاجاغینی سیز سئچیرسینیز:

`funding`	نه باش وئریر
`FUNDING_AUTO`	توصیه اولونان. موجودی کیفایت ائدیرسه، موجودیدن گؤتۆرۆر؛ یوخسا چاغیریش یئنه اوغورلا باشا چاتیر و سیزه اؤده‌نیش لینکی وئریر. بیر چاغیریش، شرح ائدیله‌جک خطا یوخ.
`FUNDING_BALANCE`	یالنیز موجودی. موجودی چاتماسا، چاغیریش `insufficient_balance` ایله اوغورسوز اولور (خطا یئنه ده اؤده‌نیله بیلن لینک داشییر).
`FUNDING_INVOICE`	موجودی کیفایت ائتسه بئله، همیشه اؤده‌نیش لینکی قایتاریر.

FUNDING_AUTO ایله بیر تک ساحه‌یه گؤره بوداقلانیرسینیز:

{"order": {...}, "paid": true,  "status": "completed"}
{"order": {...}, "status": "payment_required",
 "invoice": {"invoice_id": "inv_9m2r4t",
             "pay_url": "https://pay.example.com/i/inv_9m2r4t",
             "price_usd": "11.90", "expires_at": "1785499200"}}

completed دئمکدیر کی، پول آلینیب و چاتدیریلما باشلاییب — GetOrder ایله وضعیت delivered اولانا قدر یوخلایین. payment_required ایسه مۆشتری‌نیزی pay_url اۆنوانینا گؤندرین دئمکدیر؛ فاکتور اؤدننده چاتدیریلما اؤز-اؤزۆنه باشلاییر.

قیمتلر همیشه بیزیمکیدیر. محافظه اۆچون expected_total_usd گؤندره بیلرسینیز: بیزیم تزه حسابلامامیز فرقلی چیخسا، ساتیش price_changed و یئنی جمع ایله رد ائدیلیر، مۆشتری‌نیزین گؤرمه‌دیی بیر رقم اونا یازیلماسین دئیه.

تحلۆکه‌سیز تکرار

پول خرجله‌ین هر چاغیریشدا Idempotency-Key هدری گؤندرین. جاواب سیزه هئچ چاتماسا — تایم‌آووت، قیریلمیش باغلانتی، یئنی‌دن دئپلوی اولموش ایشچی — عئینی سورغونو عئینی آچارلا تکرارلایین و ایکینجی دفعه پول یازیلماسی یئرینه ایلک نتیجه‌نی گئری آلین.

Idempotency-Key: 8f14e45f-ea6d-4b3a-9c1b-2f0d5a7e91c3

هر مۆشتری عملی اۆچون تزه آچار ایشلدین (UUID ان یاخشیسیدیر). بیر آچاری فرقلی گؤوده ایله تکرار ایشلتمک idempotency_conflict ایله رد ائدیلیر — بۇ بیرلشمه باق دئمکدیر و هانسی سورغونو نظرده توتدوغونوزو تخمین ائتمک، سیزه دئمکدن پیس اولاردی.

سورغو حددلری

کیملییی دوغرولانمیش هر جاواب آچارینیزین هارادا دایاندیغینی دئییر:

RateLimit-Limit: 6000
RateLimit-Remaining: 5987
RateLimit-Policy: 6000;w=60

حدد هر آچار اۆچون، دقیقه‌بازیندادیر و حسابینیزا گؤره قۇرولور — دیفالت بیر ماغازایا اویغوندور؛ ایشلک بیر بوت اؤزۆنۆ دیفالتدا یاواشلاتماق یئرینه داها آرتیغینی ایسته‌مه‌لیدیر. حددی آشماق Retry-After ایله بیرلیکده 429 جاوابی وئریر.

بیر اۆنواندان چوخلو سورغو کیملیک دوغرولامادان کئچمه‌ینده ده 429 گؤرونور. بۇ سیزین کوتانیز دئییل، بروت-فورس محافظه‌سیدیر: اؤز-اؤزۆنه تمیزلنیر (هدر نه واخت اولدوغونو دئییر) و ایشلک بیر آچار اونو هئچ واخت ایشه سالمیر.

هر جاوابدا، حتّا آچارسیز اولانلاردا دا، بیر X-Ratelimit-* عایله‌سی گؤره‌جکسینیز. بۇ، بۆتۆن API قاباغیندا دایانان کوبود اۆنوان-بازیندا بیر تورمازدیر، سیزین آچارینیزین بودجه‌سی دئییل — RateLimit-Remaining ایله اؤزۆنۆزۆ تنظیم ائدین و X- هدرلرینی باشقاسینین ایشی سایین.

خطالار

اوغورسوزلوقلار بیر HTTP وضعیتی و JSON گؤوده‌سی کیمی گئری قاییدیر. یوخاری سویه‌ده‌کی code ترانسپورت کاتقوریاسیدیر؛ یوخاری سویه‌ده‌کی message ایسه سابیت ماشین کدینی داشییر. تام تفصیلات — عئینی ماشین کدی، تحلۆکه‌سیز بیر جمله و هر عملی علاوه — details ایچینده debug آلتیندا گلیر:

{"code": "failed_precondition",
 "message": "insufficient_balance",
 "details": [{"type": "neopay.seller.publicapi.v1.ErrorInfo",
              "value": "CgptZXNzYWdl…",
              "debug": {"code": "insufficient_balance",
                        "message": "insufficient balance",
                        "payUrl": "https://pay.example.com/i/inv_9m2r4t",
                        "orderId": "ord_8c3d1e",
                        "totalUsd": "11.90"}}]}

خطا کانالیندا کوده آلماغا دَین ایکی عجایبلیک وار: value base64 پروتوباف‌دیر (اونو بوراخین — debug اوخویون) و debug ایچینده علاوه ساحه‌لر lowerCamelCase-دیر — payUrl، orderId، totalUsd، retryAfterSeconds — بۇ بیر Connect قایداسیدیر، هر یئرده‌کی snake_case-دن فرقلی. یوخاری سویه‌ده‌کی message و یا debug.code اۆزرینده بوداقلانین؛ هئچ واخت جمله اۆزرینده یوخ.

سورغونوز اجازه آلمامیشدان اؤنجه‌کی ردلر

هندلره هئچ چاتمایان سورغو — آچارسیز و یا سهو آچارلا (401)، آچارین اجازه وئرمه‌دیی مبدأ اۆنوانی (403)، سورغو حددی (429)، کیملیک دوغرولاما کسینتیسی (503) — گیریش قاپیسیندا رد ائدیلیر و گیریش قاپیسی داها قیسا گؤوده وئریر: بیر ترانسپورت code و سادجه بیر جمله، details ده یوخ، ماشین کدی ده یوخ.

{"code": "unauthenticated", "message": "invalid api key"}

بونا گؤره بونلاردا HTTP وضعیتینه گؤره بوداقلانین (و 429 اۆزرینده Retry-After هدرینه حؤرمت ائدین)؛ آشاغیداکی ماشین کدلری هندلره چاتان چاغیریشلارا عایددیر. اۆنوان-بازیندا کوبود تورماز داها کؤهنه‌دیر و {"error":"rate_limited"} جاوابی وئریر — آچار error-دیر، code دئییل.

کد	معناسی	نه ائتمه‌لی
`forbidden_scope`	آچارین بۇ چاغیریش اۆچون اجازه‌سی یوخدور، و یا بۇ عملیات اوندان اسیرگنیب.	آچاری گئنیشلندیرمه‌یی دستکدن ایسته‌یین.
`not_found`	بۇ حساب اۆچون بئله بیر آبجئکت یوخدور.	ای‌دینی یوخلایین. یاد بیر ای‌دی ده عئینی جاوابی وئریر — قصدله بئله‌دیر.
`invalid_request`	بیر ساحه یانلیش فورماتدادیر.	دۆزلدیب یئنی‌دن گؤندرین؛ دییشدیرمه‌دن تکرارلاماق کؤمک ائتمه‌یه‌جک.
`insufficient_balance`	یالنیز موجودی ایله اؤده‌نیش اونو اؤرته بیلمه‌دی.	تفصیلاتداکی `payUrl` ایشلدین، و یا `FUNDING_AUTO` ایله دییشین.
`price_changed`	`expected_total_usd` آرتیق اویغون گلمیر.	یئنی‌دن قیمتلندیرین و یئنی جمعی مۆشتری‌نیزله تصدیقله‌یین.
`idempotency_conflict`	او آچار فرقلی بیر گؤوده ایله ایشلدیلیب.	هر عمل اۆچون تزه آچار ایشلدین.
`sandbox_unavailable`	`sk_test_` آچاری پول خرجله‌مه‌یه و یا حقیقی ماشینا توخونماغا چالیشدی.	گؤزلنیلندیر — او چاغیریش اۆچون جانلی آچار ایشلدین. تست آچارلاری اوخویور، هئچ واخت آلمیر.
`unpriceable`	ایسته‌دیینیز کانفیقوراسیون ساتیلا بیلمز — قیمتی اولمایان بیر پلان و یا نود، و یا هئچ بیر مودئلین اؤرتمه‌دیی بیر سبت.	آلمامیشدان اؤنجه ماغازانی و قیمتلندیرمه‌نی یئنی‌دن اوخویون؛ قیمتلندیرمه ده عئینی سبتدن ایمتینا ائدیر.
`upstream_unavailable`	آسیلی اولدوغوموز بیر پلان ایشله‌میر.	گئری چکیلمه ایله تکرارلایین؛ اوخوشلار قیسا مۆدته کؤهنه اولا بیلر.
`order_failed`	اؤده‌نیشدن سونرا چاتدیریلما اوغورسوز اولدو.	یئنی‌دن آلمایین. `GetOrder` ایله یوخلایین؛ بونلاری اوتوماتیک برپا ائدیریک و دستک ده گؤرور.
`internal`	بیزیم طرفده تصنیف ائتمه‌دیییمیز بیر شئی سیندی.	گئری چکیلمه ایله بیر دفعه تکرارلایین؛ تکرارلانیرسا، `X-Request-Id` کدینی دستکه بیلدیرین.

قایدالار

ترانسپورت. هر چاغیریش JSON گؤوده‌سی ایله POST {base}/{Method}-دیر — POST /api/v1/CreateVPNOrder. باشقا هئچ نه یوخدور: هر باشقا HTTP متودو 405 جاوابی وئریر، REST فعل خریطه‌سی یوخدور و یول پارامترلری ده یوخدور.
پول بیر متندیر. "19.99"، 19.99 یوخ: JSON رقمی اکثر دیللرده float اولور و بیر سنتی دقیق ساخلایا بیلمیر.
64-بیتلیک تام رقملر متن کیمی گلیر. هر بایت سایی و هر یونیکس زامان دامغاسی 64-بیتلیکدیر و شبکه اونلاری دیرناق ایچینده وئریر — "remaining_bytes": "96636764160". اونلاری تام رقم کیمی پارس ائدین؛ سورغولاردا هر ایکی شکلی گؤندره بیلرسینیز.
صفیر یازیلمیر. مقداری 0، false و یا بوش اولان ساحه جاوابدا اصلاً گؤرونمور. یوخ اولانی صفیر سایین — و یادینیزدا اولسون کی، 0 گۆنلۆک حدد «0 گیگابایت» یوخ، حدد یوخدور دئمکدیر.
واختلار یونیکس ثانیه‌سیدیر، ترانزاکسیون پنجره‌سیندن باشقا — او، RFC3339 و یا YYYY-MM-DD آلیر و قایتاریر.
ترافیک بایتدیر، هر رقمده گیگابایت دئییل.
ای‌دی‌لر شفاف دئییل. acc_…، ord_…، vpn_…. هئچ واخت اونلاری پارس ائتمه‌یین و یا اؤزۆنۆز یاراتمایین، آردیجیل اولدوقلارینی دا فرض ائتمه‌یین.
صحیفه‌له‌مه شفاف اولمایان کورسور ایله‌دیر: اؤنجه‌کی جوابین next_cursor مقدارینی گئری گؤندرین. بوش next_cursor هر شئیی آلدیغینیز دئمکدیر.
ساحه جدوللری قیسا تیپ ایشاره‌لری ایشلدیر. money — دقیق اوندالیق متن؛ unix — یونیکس ثانیه‌سی (64-بیتلیک، بونا گؤره متن)؛ bytes — بایت سایی (64-بیتلیک، بونا گؤره متن)؛ int64 — باشقا هر 64-بیتلیک (متن)؛ int — 32-بیتلیک، عادی رقم؛ cursor — شفاف اولمایان صحیفه‌له‌مه دستکی؛ enum — سیاهیداکی مقدارلاردان دقیقاً بیری.
یئنی ساحه‌لر خبردارلیقسیز گؤرونور و مؤوجود اولانلارین معناسی دییشمیر. تانیمادیغینیزی نظره آلمایین.

باشلانغیج

ایلک ائدیله‌جک تک چاغیریش: آچارین ایشله‌دیینی ثابت ائدیر و اونون هانسی حسابا عاید اولدوغونو دئییر.

POST

Ping

هر آچار

https://apiservice.vitamindata.net/api/v1/Ping

حسابینیزین ای‌دیسینی، آچارین جانلی و یا تست اولدوغونو و بیزیم ساعاتیمیزی قایتاریر.

سورغو

پارامتر یوخدور — بوش بیر آبجئکت گؤندرین، {}.

نۆمونه سورغو

curl https://apiservice.vitamindata.net/api/v1/Ping \
  -H "Authorization: Bearer $YOUR_API_KEY" \
  -H 'Content-Type: application/json' \
  -d '{}'

جاواب200 · application/json

account_idstring

آچارین حسابی — آچارین تانیندیغینین ثبوتو.

modeenum

هانسی نؤو آچار گؤندردیینیز.

بونلاردان بیری:livetest

server_timeunix

بیزیم ساعاتیمیز — ایمضالاری و یا پنجره‌لری پوزمامیشدان اؤنجه فرقی گؤرمک اۆچون فایدالیدیر.

نۆمونه جاواب

{
  "account_id": "acc_9f3k2m7q",
  "mode": "live",
  "server_time": "1785412800"
}

حساب و موجودی

POST

GetAccount

read

https://apiservice.vitamindata.net/api/v1/GetAccount

حسابینیزین ایمیلی، وضعیتی، دیلی و اۆنوانین تصدیقلنیب-تصدیقلنمه‌دیی.

سورغو

پارامتر یوخدور — بوش بیر آبجئکت گؤندرین، {}.

نۆمونه سورغو

curl https://apiservice.vitamindata.net/api/v1/GetAccount \
  -H "Authorization: Bearer $YOUR_API_KEY" \
  -H 'Content-Type: application/json' \
  -d '{}'

جاواب200 · application/json

accountobject

حسابینیز.

account.account_idstring

عمومی ای‌دی (acc_…).

account.emailstring

گیریش اۆنوانی.

account.statusstring

حساب محدودلاشدیریلمایانا قدر active.

account.localestring

حسابین دیلی — کارت آدلاری و بیلدیریشلر اونا گؤره یئرلیلشیر.

account.email_verifiedbool

اۆنوان تصدیقلنیب.

account.created_atunix

حسابین یارادیلدیغی واخت.

نۆمونه جاواب

{
  "account": {
    "account_id": "acc_9f3k2m7q",
    "email": "dev@example.com",
    "status": "active",
    "locale": "en",
    "email_verified": true,
    "created_at": "1769000000"
  }
}

POST

GetBalance

read

https://apiservice.vitamindata.net/api/v1/GetBalance

دفتر موجودینیز و بیر آلیشین حقیقتاً ایستیفاده ائده بیله‌جیی مبلغ.

available_usd آلمامیشدان اؤنجه یوخلانیلاجاق رقمدیر — ایچینده‌کی سیفاریشلرین بلوکه ائتدییینی چیخیر.

سورغو

پارامتر یوخدور — بوش بیر آبجئکت گؤندرین، {}.

نۆمونه سورغو

curl https://apiservice.vitamindata.net/api/v1/GetBalance \
  -H "Authorization: Bearer $YOUR_API_KEY" \
  -H 'Content-Type: application/json' \
  -d '{}'

جاواب200 · application/json

balance_usdmoney

تام دفتر موجودیسی.

available_usdmoney

موجودی منفی بلوکلار — بیر آلیشین ایندی خرجله‌یه بیله‌جیی مبلغ.

as_ofstring

رقملرین دفترده‌کی زامان دامغاسی، RFC3339.

نۆمونه جاواب

{
  "balance_usd": "72.60",
  "available_usd": "60.70",
  "as_of": "2026-07-29T12:00:00Z"
}

POST

ListTransactions

read

https://apiservice.vitamindata.net/api/v1/ListTransactions

دفترینیز، ان یئنیسی اؤنده.

دیفالت اولاراق سون اۆچ آی. 92 گۆندن گئنیش پنجره دارالدیلیر و جاواب حقیقتاً ایشلتدیی پنجره‌نی سیزه دئییر — بونا گؤره قیسا جاواب هئچ واخت ایکی‌معنالی اولمور.

سورغو

limitintایختیاری

صحیفه اؤلچۆسۆ. دیفالت 25، ماکسیموم 100.

cursorcursorایختیاری

اؤنجه‌کی جوابین next_cursor مقداری. ایلک صحیفه اۆچون گؤندرمه‌یین.

kindstringایختیاری

آشاغیداکی kind مقدارلاری اۆزره ایختیاری، وئرگۆل ایله آیریلمیش فیلتر.

fromstringایختیاری

پنجره‌نین باشلانغیجی، RFC3339 و یا YYYY-MM-DD.

tostringایختیاری

پنجره‌نین سونو. یالنیز تاریخ اولان to او گۆنۆن هامیسینی اؤرتۆر.

نۆمونه سورغو

curl https://apiservice.vitamindata.net/api/v1/ListTransactions \
  -H "Authorization: Bearer $YOUR_API_KEY" \
  -H 'Content-Type: application/json' \
  -d '{"limit":25,"cursor":"","kind":"topup_credit,invoice_debit_reserved","from":"2026-05-01","to":"2026-07-30"}'

جاواب200 · application/json

transactionsarray

دفتر سطرلری.

transactions[].idstring

دفتر سطرینین ای‌دیسی.

transactions[].tsstring

نه واخت، RFC3339.

transactions[].kindenum

پولو نه‌یین ترپه‌تدیی. topup_credit اؤده‌نیلمیش بیر آرتیریمدیر؛ ایکی invoice_debit_* نؤوۆ ایسه آلیشلاردیر. ایچینده‌کی بیر سیفاریشین داخیلی بلوکو و آزاد ائدیلمه‌سی بۇ آخینا داخیل دئییل.

بونلاردان بیری:topup_creditexternal_creditinvoice_debit_reservedinvoice_debit_externaloverpay_creditmanual_creditmanual_debitspend_debitspend_refundautomated_correction

transactions[].amount_usdmoney

ایشاره‌لی — چیخاریشلاردا منفی.

transactions[].balance_after_usdmoney

بۇ سطردن سونراکی جاری موجودی.

transactions[].ref_invoice_idstring

پول ترپه‌نیشینین آرخاسینداکی فاکتور — تام حکایه اۆچون اونو GetInvoice-ا وئرین.

transactions[].descriptionstring

قیسا، اینسان اوخویان اتیکت. یالنیز گؤسترمک اۆچون؛ هئچ واخت اونا گؤره بوداقلانمایین.

next_cursorcursor

نؤوبتی صحیفه اۆچون اونو cursor کیمی گئری گؤندرین. یوخ/بوش = هر شئیی آلمیسینیز.

has_morebool

بۇ صحیفه‌دن سونرا داها سطرلر وار.

fromstring

حقیقتاً تطبیق اولونان پنجره (RFC3339). ایسته‌دیینیزدن دار اولسا ⇒ 92 گۆنلۆک حددی وورموسونوز.

tostring

تطبیق اولونان پنجره‌نین سونو.

نۆمونه جاواب

{
  "transactions": [
    {"id": "tx_01j9zq", "ts": "2026-07-28T09:14:03Z", "kind": "invoice_debit_reserved",
     "amount_usd": "-11.90", "balance_after_usd": "72.60",
     "ref_invoice_id": "inv_5k8p2q", "description": "order ord_7b2c9d"},
    {"id": "tx_01j8xw", "ts": "2026-07-25T18:40:11Z", "kind": "topup_credit",
     "amount_usd": "50.00", "balance_after_usd": "84.50", "ref_invoice_id": "inv_3d1x8n"}
  ],
  "from": "2026-04-30T00:00:00Z",
  "to": "2026-07-29T23:59:59Z"
}

POST

CreateTopup

buyIdempotency-Key

https://apiservice.vitamindata.net/api/v1/CreateTopup

موجودینیزا پول علاوه ائدن، اؤده‌نیله بیلن فاکتور یارادیر.

مۆشتری‌نیزی (و یا اؤزۆنۆزۆ) invoice.pay_url اۆنوانینا گؤندرین. اؤدننده پول ترپه‌نیر.

سورغو

amount_usdmoneyمجبوری

نه قدر علاوه ائدیله‌جک، اوندالیق متن کیمی.

نۆمونه سورغو

curl https://apiservice.vitamindata.net/api/v1/CreateTopup \
  -H "Authorization: Bearer $YOUR_API_KEY" \
  -H 'Content-Type: application/json' \
  -H "Idempotency-Key: $(uuidgen)" \
  -d '{"amount_usd":"50.00"}'

جاواب200 · application/json

invoiceobject

اؤده‌نیله بیلن فاکتور.

invoice.invoice_idstring

شلوزون فاکتور ای‌دیسی (inv_…).

invoice.statusenum

pending اؤده‌نیله بیلر. confirmed-دن delivered_redirected-ا قدر هر شئی پولون گئری دؤنمز شکیلده گلدیی دئمکدیر — اونلارین هامیسینی اؤدنمیش سایین. expired لینکین اؤده‌نیلمه‌دن باشا چاتدیغی دئمکدیر.

بونلاردان بیری:pendingconfirmedsweepingsweptdeliveringdelivereddelivered_redirectedexpired

invoice.pay_urlstring

میزبانلیق اولونان اؤده‌نیش صحیفه‌سی. مۆشتری‌نیزی بۇرا گؤندرین؛ بۆتۆن یوللار (کوینلر، زنجیرلر، موجودی) اونون آرخاسیندادیر.

invoice.pay_telegram_urlstring

عئینی فاکتور، Telegram ایچینده اؤده‌نیله بیلن: اؤده‌نیش تأمینچیسینین اؤز بوتونو آچیر، مبلغی گؤستریر و اؤده‌نیشی اورادا آلیر. اپلیکاسیوندان چیخماق ایسته‌مه‌ین مۆشتریلر اۆچون اونو pay_url ایله یان-یانا تکلیف ائدین. اولمایا بیلر — یالنیز بوتو قۇرولموش اؤده‌نیش تأمینچیسینین بئله‌سی وار، بونا گؤره اونو هئچ واخت تک اؤده‌نیش دۆیمه‌نیز ائتمه‌یین.

invoice.price_usdmoney

فاکتورون ییغدیغی مبلغ.

invoice.expires_atunix

اؤده‌نیش پنجره‌سینین قاپاندیغی واخت.

نۆمونه جاواب

{
  "invoice": {
    "invoice_id": "inv_3d1x8n",
    "status": "pending",
    "pay_url": "https://pay.example.com/i/inv_3d1x8n",
    "pay_telegram_url": "https://t.me/VitaminPayBot?start=3d1x8n",
    "price_usd": "50.00",
    "expires_at": "1785499200"
  }
}

POST

GetInvoice

read

https://apiservice.vitamindata.net/api/v1/GetInvoice

بیر اؤده‌نیش تام تفصیلاتی ایله، زنجیرین گؤستردیکلری ده داخیل.

دفتر سطرینین ref_invoice_id ساحه‌سی بیرلشدیرن آچاردیر. یالنیز اؤز حسابینیزین یاراتدیغی فاکتورلار اوخونا بیلر.

سورغو

invoice_idstringمجبوری

بیر دفتر سطرینین ref_invoice_id ساحه‌سیندن، بیر سیفاریشدن و یا بیر آرتیریمدان.

نۆمونه سورغو

curl https://apiservice.vitamindata.net/api/v1/GetInvoice \
  -H "Authorization: Bearer $YOUR_API_KEY" \
  -H 'Content-Type: application/json' \
  -d '{"invoice_id":"inv_5k8p2q"}'

جاواب200 · application/json

invoiceobject

فاکتورون اؤزۆ.

invoice.invoice_idstring

شلوزون فاکتور ای‌دیسی (inv_…).

invoice.statusenum

بونلاردان بیری:pendingconfirmedsweepingsweptdeliveringdelivereddelivered_redirectedexpired

invoice.pay_urlstring

invoice.pay_telegram_urlstring

invoice.price_usdmoney

فاکتورون ییغدیغی مبلغ.

invoice.expires_atunix

اؤده‌نیش پنجره‌سینین قاپاندیغی واخت.

paymentsarray

زنجیرین گؤستردیکلری. موجودی ایله اؤده‌نن فاکتور اۆچون بوشدور (زنجیر ایشتیراک ائتمه‌ییب)، بیر ده هله هئچ کیمین اؤده‌مه‌دیی فاکتور اۆچون — بوش سیاهی خطا دئییل.

payments[].chainstring

اؤده‌نیشین گلدیی شبکه (tron، bsc، …).

payments[].assetstring

نه اؤده‌نیلیب (USDT، …).

payments[].amountmoney

آکتیوین مقداری، دقیق.

payments[].tx_hashstring

زنجیرده‌کی ترانزاکسیون — مۆشتری‌نیزین اؤده‌نیش ثبوتو.

payments[].confirmedbool

زنجیر اونو قطعیلشدیریب.

payments[].seen_atunix

اونو ایلک دفعه گؤردۆیۆموز واخت.

order_idstring

فاکتورون نه آلدیغی. موجودی آرتیریمی اۆچون یوخدور، چۆنکی او هئچ نه آلمیر.

نۆمونه جاواب

{
  "invoice": {
    "invoice_id": "inv_5k8p2q",
    "status": "confirmed",
    "pay_url": "https://pay.example.com/i/inv_5k8p2q",
    "price_usd": "11.90",
    "expires_at": "1785499200"
  },
  "payments": [
    {"chain": "tron", "asset": "USDT", "amount": "11.90",
     "tx_hash": "c4a1f09e2b7d", "confirmed": true, "seen_at": "1785412920"}
  ],
  "order_id": "ord_7b2c9d"
}

قیمتلر

بۇرادا هئچ نه یارادیلمیر — مۆشتری‌نیز قرار وئرمه‌میشدن اؤنجه ایسته‌دیینیز قدر قیمتلندیرین.

POST

ListPlans

read

https://apiservice.vitamindata.net/api/v1/ListPlans

نه ساتا بیلرسینیز: سلایدرین حددلری و ماغازانیز ایشلدیرسه، سابیت قیمتلی کارتلار.

هانسی دولودورسا، اونو گؤسترین. کارت، bundle_id-سی سبته قویولاراق آلینیر؛ سلایدر سبتی ایسه gb/months/users ایشلدیر.

سورغو

پارامتر یوخدور — بوش بیر آبجئکت گؤندرین، {}.

نۆمونه سورغو

curl https://apiservice.vitamindata.net/api/v1/ListPlans \
  -H "Authorization: Bearer $YOUR_API_KEY" \
  -H 'Content-Type: application/json' \
  -d '{}'

جاواب200 · application/json

model_namestring

ماغازانیزین قیمتلندیرمه مودئلی.

model_typestring

اونون موتور وئرسیاسی.

boundsobject

کانفیقوراتورون قایدالاری — هر قیمتلندیرمه و هر سیفاریش اونلاری سروردا یئنی‌دن یوخلاییر.

bounds.gb_minint

بیر سبتین ایسته‌یه بیله‌جیی ان آز ترافیک.

bounds.gb_maxint

ان چوخو.

bounds.gb_stepint

سلایدرین آددیمی.

bounds.users_minint

عئینی واختدا ان آز جیهاز.

bounds.users_maxint

ان چوخو.

bounds.months_minint

ان قیسا مۆدت.

bounds.months_maxint

ان اوزونو.

bounds.new_accounts_maxint

بیر سیفاریشین یارادا بیله‌جیی ان چوخ حساب.

bounds.extend_maxint

بیر سیفاریشین اوزادا بیله‌جیی ان چوخ حساب.

bounds.default_gbint

عاغیللی بیر سلایدر دیفالتی.

bounds.default_usersint

دیفالت جیهاز سایی.

bounds.default_monthsint

دیفالت مۆدت.

bundlesarray

سابیت قیمتلی کارتلار، ماغازانیز کارت کاتالوقو اولاندا.

bundles[].bundle_idstring

cart.bundle_id ایچینه قویولاجاق دستک.

bundles[].namestring

کارتین آدی، حسابین دیلینه گؤره آرتیق یئرلیلشدیریلمیش.

bundles[].gbint

ایچینده‌کی ترافیک.

bundles[].monthsint

اعتبار مۆدتی.

bundles[].online_usersint

عئینی واختدا باغلانان جیهازلار.

bundles[].price_usdmoney

قیمت. بۇ، قیمتین اؤزۆدۆر — کارت اۆچون قیمتلندیرمه لازیم دئییل.

bundles[].highlightbool

ماغازانین اؤنه چکدیی کارت.

bundles[].daily_cap_gbint

گۆنلۆک حدد، گیگابایت ایله. یوخدورسا = حدد یوخدور.

نۆمونه جاواب

{
  "model_name": "vpn_dynamic",
  "model_type": "dynamic_v2",
  "bounds": {
    "gb_min": 10, "gb_max": 500, "gb_step": 10,
    "users_min": 1, "users_max": 10,
    "months_min": 1, "months_max": 12,
    "new_accounts_max": 5, "extend_max": 10,
    "default_gb": 100, "default_users": 3, "default_months": 1
  },
  "bundles": [
    {"bundle_id": "card_100_1m", "name": "100 GB · 1 month", "gb": 100, "months": 1,
     "online_users": 3, "price_usd": "11.90", "highlight": true}
  ]
}

POST

Quote

read

https://apiservice.vitamindata.net/api/v1/Quote

بیر VPN سبتینین سون قیمتی، مادّه-مادّه. اندیریملر آرتیق تطبیق اولونوب.

سورغو

cartobjectمجبوری

قیمتلندیریله‌جک سبت.

cart.kindenumمجبوری

یئنی حسابلار آلماق، و یا مؤوجودلارینا ترافیک و واخت علاوه ائتمک.

بونلاردان بیری:newextend

cart.gbintایختیاری

هر حسابا دۆشن ترافیک، گیگابایت ایله، ListPlans-دان گلن حددلر ایچینده.

cart.monthsintایختیاری

هر حسابین اعتبار مۆدتی، آی ایله.

cart.usersintایختیاری

هر حسابدا عئینی واختدا باغلانان جیهازلار.

cart.new_accountsintایختیاری

یالنیز kind:"new" اۆچون: نئچه حساب یارادیلاجاق. ایستیفاده‌چی آدلارینی سرور اؤزۆ یارادیر.

cart.extend_vpn_idsarrayایختیاری

یالنیز kind:"extend" اۆچون: اوزادیلاجاق حسابلار، عمومی ای‌دی ایله.

cart.bundle_idstringایختیاری

قۇرولموش سبت یئرینه ListPlans.bundles-دان سابیت قیمتلی کارت آلیر. قۇرولاندا gb/months/users نظره آلینمیر — کارتین اؤز مقدارلاری و قیمتی ایشله‌ییر.

نۆمونه سورغو

curl https://apiservice.vitamindata.net/api/v1/Quote \
  -H "Authorization: Bearer $YOUR_API_KEY" \
  -H 'Content-Type: application/json' \
  -d '{"cart":{"kind":"new","gb":100,"months":1,"users":3,"new_accounts":2}}'

بۇ سورغونون باشقا شکیللری

آرتیق الینیزده اولان حسابلاری اوزاتماق

{"cart":{"kind":"extend","gb":50,"months":1,"users":3,"extend_vpn_ids":["vpn_6t2k9p","vpn_1a4b7c"]}}

قۇرولموش سبت یئرینه سابیت قیمتلی کارت آلماق

{"cart":{"kind":"new","bundle_id":"card_100_1m","new_accounts":1}}

جاواب200 · application/json

quoteobject

مادّه-مادّه قیمت. هئچ نه یارادیلمیر و هئچ نه یازیلمیر.

quote.model_namestring

هانسی قیمتلندیرمه مودئلینین جاواب وئردیی.

quote.model_typestring

مودئلین موتور وئرسیاسی.

quote.base_usdmoney

اندیریملر و علاوه حاقلاردان اؤنجه‌کی قیمت.

quote.total_usdmoney

سون قیمت — بۇ سبتله بیر ساتیشین یازدیغی مبلغ.

quote.linesarray

مادّه-مادّه بؤلگۆ، ایشاره‌لی، دقیقاً جمعه برابر.

quote.lines[].codestring

بۇ سطرین نه اولدوغو (base، بیر اندیریم کدی، بیر علاوه حاق…).

quote.lines[].kindstring

سطرین کاتقوریاسی، اینترفئیسینیزده قروپلاشدیرماق اۆچون.

quote.lines[].amount_usdmoney

ایشاره‌لی. اندیریملر منفیدیر؛ سطرلر دقیقاً total_usd مقدارینا جمعلنیر.

quote.lines[].pctstring

سطرین آرخاسینداکی فایز، اولاندا.

quote.cappedbool

جمع مودئلین تاوانینا دَییب.

quote.floor_appliedbool

جمع مودئلین دؤشمه‌سینه قدر قالدیریلیب.

quote.clampedenum

بیر سبت مقداری قیمتلندیرمه‌دن اؤنجه حددلره سیخیلاندا قۇرولور.

بونلاردان بیری:minmax

quote.invalidstring

بوش دئییلسه، سبت قیمتلندیریله بیلمز — اونو گؤسترین و بئله بیر قیمتلندیرمه‌یه گؤره هئچ واخت پول یازمایین.

quote.metamap

مودئل علاوه‌لری، متن→متن (مثلاً بیر یۆکسلتمه‌نین remaining_days ساحه‌سی).

نۆمونه جاواب

{
  "quote": {
    "model_name": "vpn_dynamic",
    "model_type": "dynamic_v2",
    "base_usd": "14.00",
    "total_usd": "11.90",
    "lines": [
      {"code": "base", "kind": "base", "amount_usd": "14.00"},
      {"code": "loyalty", "kind": "discount", "amount_usd": "-2.10", "pct": "15"}
    ]
  }
}

VPN ساتیشی

POST

CreateVPNOrder

buyIdempotency-Key

https://apiservice.vitamindata.net/api/v1/CreateVPNOrder

یئنی VPN حسابلاری آلیر، و یا مؤوجودلاری اوزادیر (extend_vpn_ids ایله "kind":"extend").

جاوابین آلا بیله‌جیی ایکی شکیل اۆچون اؤده‌نیش بؤلۆمۆنه باخین.

سورغو

cartobjectمجبوری

نه آلیناجاق — Quote-ون قیمتلندیردیی عئینی شکیل.

cart.kindenumمجبوری

یئنی حسابلار آلماق، و یا مؤوجودلارینا ترافیک و واخت علاوه ائتمک.

بونلاردان بیری:newextend

cart.gbintایختیاری

هر حسابا دۆشن ترافیک، گیگابایت ایله، ListPlans-دان گلن حددلر ایچینده.

cart.monthsintایختیاری

هر حسابین اعتبار مۆدتی، آی ایله.

cart.usersintایختیاری

هر حسابدا عئینی واختدا باغلانان جیهازلار.

cart.new_accountsintایختیاری

یالنیز kind:"new" اۆچون: نئچه حساب یارادیلاجاق. ایستیفاده‌چی آدلارینی سرور اؤزۆ یارادیر.

cart.extend_vpn_idsarrayایختیاری

یالنیز kind:"extend" اۆچون: اوزادیلاجاق حسابلار، عمومی ای‌دی ایله.

cart.bundle_idstringایختیاری

fundingenumمجبوری

نئجه اؤده‌نیله‌جک — باخین: اؤده‌نیش. دیفالت یوخدور: گؤندرمه‌مک رد ائدیلیر.

بونلاردان بیری:FUNDING_AUTOFUNDING_BALANCEFUNDING_INVOICE

expected_total_usdmoneyایختیاری

تصدیق محافظه‌سی. قۇرولوبسا و بیزیم تزه قیمتلندیرمه‌میز فرقلی چیخسا، ساتیش price_changed ایله رد ائدیلیر و مۆشتری‌نیزین گؤرمه‌دیی رقم اونا یازیلمیر.

نۆمونه سورغو

curl https://apiservice.vitamindata.net/api/v1/CreateVPNOrder \
  -H "Authorization: Bearer $YOUR_API_KEY" \
  -H 'Content-Type: application/json' \
  -H "Idempotency-Key: $(uuidgen)" \
  -d '{"cart":{"kind":"new","gb":100,"months":1,"users":3,"new_accounts":1},"funding":"FUNDING_AUTO","expected_total_usd":"11.90"}'

بۇ سورغونون باشقا شکیللری

آرتیق الینیزده اولان حسابلاری اوزاتماق

{"cart":{"kind":"extend","gb":50,"months":1,"users":3,"extend_vpn_ids":["vpn_6t2k9p"]},"funding":"FUNDING_AUTO"}

موجودیدن اؤده‌نن سابیت قیمتلی کارت آلماق

{"cart":{"kind":"new","bundle_id":"card_100_1m","new_accounts":1},"funding":"FUNDING_BALANCE"}

جاواب200 · application/json

orderobject

سیفاریش — وضعیتی delivered اولانا قدر GetOrder ایله یوخلایین.

order.order_idstring

سیفاریشین عمومی ای‌دیسی (ord_…).

order.productenum

نه آلینیب.

بونلاردان بیری:vpnvps

order.kindstring

آلیش شکلی: new، extend، upgrade…

order.statusenum

حیات دؤورو. هدف delivered-دیر؛ needs_operator پولون گلدیی و چاتدیریلمانی بیر اینسانین باشا وورماسی دئمکدیر — یئنی‌دن آلمایین؛ expired فاکتورون اؤده‌نیلمه‌دن باشا چاتدیغی دئمکدیر.

بونلاردان بیری:createdinvoicedpaiddeliveringdeliveredneeds_operatorfailedrefund_pendingrefundedexpired

order.fundingenum

اونو حقیقتاً هانسی یولون اؤدَدیی. FUNDING_AUTO بونلاردان بیرینه چئوریلیر.

بونلاردان بیری:invoicebalance

order.total_usdmoney

سیفاریشین یازدیغی مبلغ.

order.invoice_idstring

اونون آرخاسینداکی فاکتور — هانسی یولون اؤدَدیییندن آسیلی اولمایاراق هر سیفاریشین بیری وار.

order.itemsint

سیفاریشین نئچه حاق یاراتدیغی و یا اوزاتدیغی.

order.created_atunix

نه واخت وئریلیب.

order.delivered_atunix

چاتدیریلمانین بیتدیی واخت. اوندان اؤنجه یوخدور.

order.breakdownobject

مۆشتری‌نین راضی اولدوغو قیمتلندیرمه، عئینن — Quote-ون قایتاردیغی عئینی شکیل.

invoiceobject

سیفاریشین آرخاسینداکی فاکتور: payment_required اولاندا اؤده‌نیله بیلر، completed اولاندا آرتیق قاپانیب.

invoice.invoice_idstring

شلوزون فاکتور ای‌دیسی (inv_…).

invoice.statusenum

بونلاردان بیری:pendingconfirmedsweepingsweptdeliveringdelivereddelivered_redirectedexpired

invoice.pay_urlstring

invoice.pay_telegram_urlstring

invoice.price_usdmoney

فاکتورون ییغدیغی مبلغ.

invoice.expires_atunix

اؤده‌نیش پنجره‌سینین قاپاندیغی واخت.

paidbool

پول توتولوب. payment_required ایله بیرلیکده یوخدور (= false).

statusenum

بوداقلانیلاجاق ساحه بۇدور — باخین: اؤده‌نیش.

بونلاردان بیری:completedpayment_required

نۆمونه جاواب

{
  "order": {
    "order_id": "ord_8c3d1e", "product": "vpn", "kind": "new",
    "status": "invoiced", "funding": "invoice", "total_usd": "11.90",
    "invoice_id": "inv_9m2r4t", "items": 1, "created_at": "1785412800"
  },
  "invoice": {
    "invoice_id": "inv_9m2r4t", "status": "pending",
    "pay_url": "https://pay.example.com/i/inv_9m2r4t",
    "pay_telegram_url": "https://t.me/VitaminPayBot?start=9m2r4t",
    "price_usd": "11.90", "expires_at": "1785499200"
  },
  "status": "payment_required"
}

POST

GetOrder

read

https://apiservice.vitamindata.net/api/v1/GetOrder

آلیشدان سونرا بونو یوخلایین: created → invoiced → paid → delivering → delivered.

سورغو

order_idstringمجبوری

وئردیینیز سیفاریشدن.

نۆمونه سورغو

curl https://apiservice.vitamindata.net/api/v1/GetOrder \
  -H "Authorization: Bearer $YOUR_API_KEY" \
  -H 'Content-Type: application/json' \
  -d '{"order_id":"ord_7b2c9d"}'

جاواب200 · application/json

orderobject

سیفاریش، تام تفصیلاتی ایله.

order.order_idstring

سیفاریشین عمومی ای‌دیسی (ord_…).

order.productenum

نه آلینیب.

بونلاردان بیری:vpnvps

order.kindstring

آلیش شکلی: new، extend، upgrade…

order.statusenum

بونلاردان بیری:createdinvoicedpaiddeliveringdeliveredneeds_operatorfailedrefund_pendingrefundedexpired

order.fundingenum

اونو حقیقتاً هانسی یولون اؤدَدیی. FUNDING_AUTO بونلاردان بیرینه چئوریلیر.

بونلاردان بیری:invoicebalance

order.total_usdmoney

سیفاریشین یازدیغی مبلغ.

order.invoice_idstring

اونون آرخاسینداکی فاکتور — هانسی یولون اؤدَدیییندن آسیلی اولمایاراق هر سیفاریشین بیری وار.

order.itemsint

سیفاریشین نئچه حاق یاراتدیغی و یا اوزاتدیغی.

order.created_atunix

نه واخت وئریلیب.

order.delivered_atunix

چاتدیریلمانین بیتدیی واخت. اوندان اؤنجه یوخدور.

order.breakdownobject

مۆشتری‌نین راضی اولدوغو قیمتلندیرمه، عئینن — Quote-ون قایتاردیغی عئینی شکیل.

invoiceobject

یالنیز سیفاریش هله اؤده‌نیش گؤزله‌ین واخت دولو اولور — هر یئرده‌کی عئینی شکیل.

نۆمونه جاواب

{
  "order": {
    "order_id": "ord_7b2c9d", "product": "vpn", "kind": "new",
    "status": "delivered", "funding": "balance", "total_usd": "11.90",
    "invoice_id": "inv_5k8p2q", "items": 1,
    "created_at": "1785230043", "delivered_at": "1785230103",
    "breakdown": {
    "model_name": "vpn_dynamic",
    "model_type": "dynamic_v2",
    "base_usd": "14.00",
    "total_usd": "11.90",
    "lines": [
      {"code": "base", "kind": "base", "amount_usd": "14.00"},
      {"code": "loyalty", "kind": "discount", "amount_usd": "-2.10", "pct": "15"}
    ]
  }
  }
}

POST

ListOrders

read

https://apiservice.vitamindata.net/api/v1/ListOrders

سیفاریش تاریخچه‌نیز، ان یئنیسی اؤنده.

سورغو

limitintایختیاری

صحیفه اؤلچۆسۆ. دیفالت 25، ماکسیموم 100.

cursorcursorایختیاری

اؤنجه‌کی جوابین next_cursor مقداری. ایلک صحیفه اۆچون گؤندرمه‌یین.

نۆمونه سورغو

curl https://apiservice.vitamindata.net/api/v1/ListOrders \
  -H "Authorization: Bearer $YOUR_API_KEY" \
  -H 'Content-Type: application/json' \
  -d '{"limit":25,"cursor":""}'

جاواب200 · application/json

ordersarray

سیفاریشلر.

orders[].order_idstring

سیفاریشین عمومی ای‌دیسی (ord_…).

orders[].productenum

نه آلینیب.

بونلاردان بیری:vpnvps

orders[].kindstring

آلیش شکلی: new، extend، upgrade…

orders[].statusenum

بونلاردان بیری:createdinvoicedpaiddeliveringdeliveredneeds_operatorfailedrefund_pendingrefundedexpired

orders[].fundingenum

اونو حقیقتاً هانسی یولون اؤدَدیی. FUNDING_AUTO بونلاردان بیرینه چئوریلیر.

بونلاردان بیری:invoicebalance

orders[].total_usdmoney

سیفاریشین یازدیغی مبلغ.

orders[].invoice_idstring

اونون آرخاسینداکی فاکتور — هانسی یولون اؤدَدیییندن آسیلی اولمایاراق هر سیفاریشین بیری وار.

orders[].itemsint

سیفاریشین نئچه حاق یاراتدیغی و یا اوزاتدیغی.

orders[].created_atunix

نه واخت وئریلیب.

orders[].delivered_atunix

چاتدیریلمانین بیتدیی واخت. اوندان اؤنجه یوخدور.

orders[].breakdownobject

مۆشتری‌نین راضی اولدوغو قیمتلندیرمه، عئینن — Quote-ون قایتاردیغی عئینی شکیل.

next_cursorcursor

نؤوبتی صحیفه اۆچون اونو cursor کیمی گئری گؤندرین. یوخ/بوش = هر شئیی آلمیسینیز.

نۆمونه جاواب

{
  "orders": [
    {"order_id": "ord_7b2c9d", "product": "vpn", "kind": "new", "status": "delivered",
     "funding": "balance", "total_usd": "11.90", "invoice_id": "inv_5k8p2q",
     "items": 1, "created_at": "1785230043", "delivered_at": "1785230103"}
  ]
}

VPN ایداره‌سی

POST

ListVPN

read

https://apiservice.vitamindata.net/api/v1/ListVPN

الینیزده‌کی بۆتۆن VPN حسابلاری، قالان ترافیک و بیتمه تاریخی ایله.

سورغو

limitintایختیاری

صحیفه اؤلچۆسۆ. دیفالت 50، ماکسیموم 200.

cursorcursorایختیاری

اؤنجه‌کی جوابین next_cursor مقداری. ایلک صحیفه اۆچون گؤندرمه‌یین.

نۆمونه سورغو

curl https://apiservice.vitamindata.net/api/v1/ListVPN \
  -H "Authorization: Bearer $YOUR_API_KEY" \
  -H 'Content-Type: application/json' \
  -d '{"limit":25,"cursor":""}'

جاواب200 · application/json

vpnsarray

حسابلارینیز.

vpns[].vpn_idstring

باشقا هر VPN فعلینین آلدیغی عمومی ای‌دی.

vpns[].usernamestring

اپلیکاسیونلاردا گؤرونن کیملیک آدی.

vpns[].statusstring

حسابین پنلده گؤرۆندۆیۆ وضعیتی — دوندورولمایانا و یا بیتمه‌ینه قدر active.

vpns[].remaining_bytesbytes

بۆتۆن بسته‌لری بویو قالان ترافیک.

vpns[].total_downloadbytes

عؤمۆر بویو ائندیرمه، VPN پلانینین جانلی بیلدیردیی کیمی. ListVPN ایچینده بۇ همیشه 0-دیر — سیاهی کئشلنمیش اوخوما مودئلیندن وئریلیر و اونون یؤن-بازیندا رقملری یوخدور. سیاهی اۆچون used_bytes، بؤلگۆ اۆچون ایسه GetVPN/GetVPNUsage ایشلدین.

vpns[].total_uploadbytes

عؤمۆر بویو یۆکله‌مه. total_download ایله عئینی قئید: ListVPN ایچینده 0.

vpns[].used_bytesbytes

عؤمۆر بویو حقیقتاً خرجلنن ترافیک (ائندیرمه + یۆکله‌مه). بۇ رقمی مۆلکیّت هر VPN اۆچون ساخلاییر، بونا گؤره ListVPN ده داخیل هر سون نقطه‌ده دۆزگۆندۆر.

vpns[].expires_atunix

حسابین بیتدیی واخت.

vpns[].max_onlineint

اجازه وئریلن عئینی واختلی جیهازلار.

vpns[].daily_limit_bytesbytes

بۇ گۆنون حددی. یوخ/0 = گۆنلۆک حدد یوخدور.

vpns[].daily_used_bytesbytes

بۇ گۆنون حددینه قارشی خرجلنن.

vpns[].daily_reset_unixunix

گۆنلۆک سایغاجین سیفیرلاندیغی واخت.

vpns[].allowed_protocolsint

اپلیکاسیونلاریمیزین ایشلتدیی پروتکول بیت ماسکاسی. اونو شفاف اولمایان سایین.

vpns[].cache_atunix

رقملرین نه قدر تزه اولدوغو: live قۇرولمایانا قدر بۇ زامان دامغاسی قدر کؤهنه‌دیرلر.

vpns[].created_atunix

حسابین یارادیلدیغی واخت.

vpns[].livebool

رقملر کئشدن یوخ، ایندیجه شبکه‌دن گلیب.

next_cursorcursor

نؤوبتی صحیفه اۆچون اونو cursor کیمی گئری گؤندرین. یوخ/بوش = هر شئیی آلمیسینیز.

نۆمونه جاواب

{
  "vpns": [{
    "vpn_id": "vpn_6t2k9p",
    "username": "u482913",
    "status": "active",
    "remaining_bytes": "96636764160",
    "total_download": "10737418240",
    "used_bytes": "11811160064",
    "total_upload": "1073741824",
    "expires_at": "1793188800",
    "max_online": 3,
    "cache_at": "1785412700",
    "created_at": "1785000000"
  }],
  "next_cursor": "vpn_6t2k9p"
}

POST

GetVPN

read

https://apiservice.vitamindata.net/api/v1/GetVPN

بیر حساب تفصیلاتی ایله. live:true رقملرین ایندیجه شبکه‌دن گلدیی دئمکدیر.

سورغو

vpn_idstringمجبوری

حسابین عمومی ای‌دیسی (vpn_…)، ListVPN-دن و یا بیر سیفاریشین چاتدیریلماسیندان.

نۆمونه سورغو

curl https://apiservice.vitamindata.net/api/v1/GetVPN \
  -H "Authorization: Bearer $YOUR_API_KEY" \
  -H 'Content-Type: application/json' \
  -d '{"vpn_id":"vpn_6t2k9p"}'

جاواب200 · application/json

vpnobject

حساب.

vpn.vpn_idstring

باشقا هر VPN فعلینین آلدیغی عمومی ای‌دی.

vpn.usernamestring

اپلیکاسیونلاردا گؤرونن کیملیک آدی.

vpn.statusstring

حسابین پنلده گؤرۆندۆیۆ وضعیتی — دوندورولمایانا و یا بیتمه‌ینه قدر active.

vpn.remaining_bytesbytes

بۆتۆن بسته‌لری بویو قالان ترافیک.

vpn.total_downloadbytes

vpn.total_uploadbytes

عؤمۆر بویو یۆکله‌مه. total_download ایله عئینی قئید: ListVPN ایچینده 0.

vpn.used_bytesbytes

vpn.expires_atunix

حسابین بیتدیی واخت.

vpn.max_onlineint

اجازه وئریلن عئینی واختلی جیهازلار.

vpn.daily_limit_bytesbytes

بۇ گۆنون حددی. یوخ/0 = گۆنلۆک حدد یوخدور.

vpn.daily_used_bytesbytes

بۇ گۆنون حددینه قارشی خرجلنن.

vpn.daily_reset_unixunix

گۆنلۆک سایغاجین سیفیرلاندیغی واخت.

vpn.allowed_protocolsint

اپلیکاسیونلاریمیزین ایشلتدیی پروتکول بیت ماسکاسی. اونو شفاف اولمایان سایین.

vpn.cache_atunix

رقملرین نه قدر تزه اولدوغو: live قۇرولمایانا قدر بۇ زامان دامغاسی قدر کؤهنه‌دیرلر.

vpn.created_atunix

حسابین یارادیلدیغی واخت.

vpn.livebool

رقملر کئشدن یوخ، ایندیجه شبکه‌دن گلیب.

livebool

ایندیجه شبکه‌دن گلیب. یوخدورسا — اوخوما مودئلیندن وئریلیب، cache_at قدر کؤهنه‌دیر.

نۆمونه جاواب

{
  "vpn": {
    "vpn_id": "vpn_6t2k9p",
    "username": "u482913",
    "status": "active",
    "remaining_bytes": "96636764160",
    "total_download": "10737418240",
    "used_bytes": "11811160064",
    "total_upload": "1073741824",
    "expires_at": "1793188800",
    "max_online": 3,
    "cache_at": "1785412700",
    "created_at": "1785000000"
  },
  "live": true
}

POST

GetVPNUsage

read

https://apiservice.vitamindata.net/api/v1/GetVPNUsage

ایشلنن و قالان ترافیک، بیر ده وارسا بۇ گۆنون حددی.

سورغو

vpn_idstringمجبوری

حسابین عمومی ای‌دیسی (vpn_…)، ListVPN-دن و یا بیر سیفاریشین چاتدیریلماسیندان.

نۆمونه سورغو

curl https://apiservice.vitamindata.net/api/v1/GetVPNUsage \
  -H "Authorization: Bearer $YOUR_API_KEY" \
  -H 'Content-Type: application/json' \
  -d '{"vpn_id":"vpn_6t2k9p"}'

جاواب200 · application/json

vpn_idstring

عئینن گئری قایتاریلیر.

remaining_bytesbytes

قالان ترافیک.

total_downloadbytes

عؤمۆر بویو ائندیرمه.

total_uploadbytes

عؤمۆر بویو یۆکله‌مه.

expires_atunix

حسابین بیتدیی واخت.

daily_limit_bytesbytes

بۇ گۆنون حددی. یوخدورسا = حدد یوخدور.

daily_used_bytesbytes

بۇ گۆنون حددینه قارشی خرجلنن.

daily_reset_unixunix

گۆنلۆک سایغاجین سیفیرلاندیغی واخت.

cache_atunix

جانلی اولمایاندا رقملرین تزه‌لییی.

livebool

ایندیجه شبکه‌دن تزه گلیب.

seriesarray

تاریخی ایستیفاده سیراسی اۆچون رزئرو اولونوب — بۇ گۆن بوشدور.

series[].tunix

بؤلمه‌نین باشلانغیجی.

series[].rxbytes

بؤلمه‌ده ائندیریلن.

series[].txbytes

بؤلمه‌ده یۆکلنن.

نۆمونه جاواب

{
  "vpn_id": "vpn_6t2k9p",
  "remaining_bytes": "96636764160",
  "total_download": "10737418240",
  "total_upload": "1073741824",
  "expires_at": "1793188800",
  "daily_limit_bytes": "53687091200",
  "daily_used_bytes": "1273741824",
  "daily_reset_unix": "1785456000",
  "cache_at": "1785412700",
  "live": true
}

POST

ListVPNBundles

read

https://apiservice.vitamindata.net/api/v1/ListVPNBundles

بیر حسابین آرخاسینداکی ترافیک جۆزدانلاری، خرجلنه‌جکلری آردیجیللیقلا.

«مۆشتریمین پولسوز ترافیکی وارکن نییه اؤده‌نیشلی ترافیکی آزالدی؟» سوآلینا بۇرادان جاواب وئریرسینیز — queue_position 1 بۇندان سونرا خرجلنه‌جک اولاندیر. live:false اونلاری اوخویا بیلمه‌دیییمیز دئمکدیر، هئچ بیری یوخدور دئمک دئییل.

سورغو

vpn_idstringمجبوری

حسابین عمومی ای‌دیسی (vpn_…)، ListVPN-دن و یا بیر سیفاریشین چاتدیریلماسیندان.

نۆمونه سورغو

curl https://apiservice.vitamindata.net/api/v1/ListVPNBundles \
  -H "Authorization: Bearer $YOUR_API_KEY" \
  -H 'Content-Type: application/json' \
  -d '{"vpn_id":"vpn_6t2k9p"}'

جاواب200 · application/json

bundlesarray

جۆزدانلار، خرجلنمه آردیجیللیغیندا.

bundles[].bundle_idstring

جۆزدانین ای‌دیسی.

bundles[].freebool

آلینمایاراق پولسوز درجه‌دن وئریلیب.

bundles[].sourceenum

جۆزدانین هارادان گلدیی.

بونلاردان بیری:buyextendmigratedfree_tier

bundles[].granted_bytesbytes

وئریلن آنداکی تام اؤلچۆسۆ.

bundles[].remaining_bytesbytes

ایچینده قالان.

bundles[].granted_atunix

نه واخت وئریلیب.

bundles[].expires_atunix

خرجلنیب-خرجلنمه‌دیییندن آسیلی اولمایاراق بیتدیی واخت.

bundles[].daily_limit_bytesbytes

اؤز گۆنلۆک حددی. یوخدورسا = حدد یوخدور.

bundles[].statusenum

رقملنمیش یوخ، یازیلمیشدیر — بئله‌لیکله 2-نین «قورتاریب» دئمک اولدوغونو هئچ واخت اؤیرنمه‌لی اولمورسونوز.

بونلاردان بیری:activedisabledexhausted

bundles[].queue_positionint

ایشلک جۆزدانلار اۆزره 1-دن باشلایان، خرجلنمه آردیجیللیغیندا — 1 بۇندان سونرا خرجلنه‌ندیر. 0/یوخ اولماسی اونون نؤوبه‌دن چیخدیغی (خرجلنیب، بیتیب و یا سؤندۆرۆلۆب) دئمکدیر.

bundles[].plan_gbint

ساتیلدیغی اؤلچۆ، گیگابایت ایله.

bundles[].plan_daysint

ساتیلدیغی اعتبار مۆدتی، گۆن ایله.

bundles[].invoice_idstring

هانسی آلیشدان گلدیی. پولسوز وئریلمه‌ده یوخدور.

livebool

یوخ/false = حاق پلانی الچاتماز اولوب، بونا گؤره سیاهی یانلیش یوخ، بوشدور. «اوخویا بیلمه‌دیک» و «هئچ بیری یوخدور» فرقلی جمله‌لردیر.

نۆمونه جاواب

{
  "bundles": [
    {"bundle_id": "bnd_2m8x", "source": "buy",
     "granted_bytes": "107374182400", "remaining_bytes": "96636764160",
     "granted_at": "1785000000", "expires_at": "1793188800",
     "status": "active", "queue_position": 1, "plan_gb": 100, "plan_days": 30,
     "invoice_id": "inv_5k8p2q"},
    {"bundle_id": "bnd_9k1f", "free": true, "source": "free_tier",
     "granted_bytes": "5368709120", "remaining_bytes": "5368709120",
     "granted_at": "1784000000", "expires_at": "1793188800",
     "status": "active", "queue_position": 2, "plan_gb": 5, "plan_days": 30}
  ],
  "live": true
}

POST

GetSubscriptionLink

read

https://apiservice.vitamindata.net/api/v1/GetSubscriptionLink

مۆشتری‌نین اپلیکاسیونونون ایچری آلدیغی آبونه اۆنوانی. VPN ساتیشینین چاتدیریلان شئیی بۇدور.

سورغو

vpn_idstringمجبوری

حسابین عمومی ای‌دیسی (vpn_…)، ListVPN-دن و یا بیر سیفاریشین چاتدیریلماسیندان.

نۆمونه سورغو

curl https://apiservice.vitamindata.net/api/v1/GetSubscriptionLink \
  -H "Authorization: Bearer $YOUR_API_KEY" \
  -H 'Content-Type: application/json' \
  -d '{"vpn_id":"vpn_6t2k9p"}'

جاواب200 · application/json

subscription_urlstring

مۆشتری‌نیزین اپلیکاسیونونا بۇنو وئرین — چاتدیریلما تام بۇدور.

tokenstring

چیلپاق توکن، اؤز QR و یا اپلیکاسیونا ایچری آلما لینکلرینیزی قۇرماق اۆچون.

نۆمونه جاواب

{
  "subscription_url": "https://sub.example.com/s/9f3kq8x2",
  "token": "9f3kq8x2"
}

POST

SetVPNPassword

credentials

https://apiservice.vitamindata.net/api/v1/SetVPNPassword

بیر حسابین پارولونو دییشیر.

آیریجا credentials اجازه‌سی ایسته‌ییر — manage اونو هئچ واخت اؤز-اؤزۆنه وئرمیر.

سورغو

vpn_idstringمجبوری

حسابین عمومی ای‌دیسی (vpn_…)، ListVPN-دن و یا بیر سیفاریشین چاتدیریلماسیندان.

new_passwordstringمجبوری

قۇرولاجاق پارول.

credentialstringایختیاری

چوخ کیملیکلی حسابلار اۆچون هانسی کیملیک. بوش = اساس اولان.

نۆمونه سورغو

curl https://apiservice.vitamindata.net/api/v1/SetVPNPassword \
  -H "Authorization: Bearer $YOUR_API_KEY" \
  -H 'Content-Type: application/json' \
  -d '{"vpn_id":"vpn_6t2k9p","new_password":"s3cr3t-Enough","credential":""}'

جاواب200 · application/json

usernamestring

دییشیکلیین دۆشدۆیۆ کیملیک.

نۆمونه جاواب

{"username": "u482913"}

POST

SetVPNState

manage

https://apiservice.vitamindata.net/api/v1/SetVPNState

بیر حسابی دوندورور و یا برپا ائدیر.

سورغو

vpn_idstringمجبوری

حسابین عمومی ای‌دیسی (vpn_…)، ListVPN-دن و یا بیر سیفاریشین چاتدیریلماسیندان.

stateenumمجبوری

نه ائدیله‌جک.

بونلاردان بیری:suspendresume

نۆمونه سورغو

curl https://apiservice.vitamindata.net/api/v1/SetVPNState \
  -H "Authorization: Bearer $YOUR_API_KEY" \
  -H 'Content-Type: application/json' \
  -d '{"vpn_id":"vpn_6t2k9p","state":"suspend"}'

جاواب200 · application/json

statusenum

حسابین اوتوردوغو وضعیت.

بونلاردان بیری:suspendedactive

نۆمونه جاواب

{"status": "suspended"}

POST

DeleteVPN

manage

https://apiservice.vitamindata.net/api/v1/DeleteVPN

بیر حسابی سیلیر. گئری قایتارما یوخدور، پول قایتارما دا یوخدور.

سورغو

vpn_idstringمجبوری

حسابین عمومی ای‌دیسی (vpn_…)، ListVPN-دن و یا بیر سیفاریشین چاتدیریلماسیندان.

نۆمونه سورغو

curl https://apiservice.vitamindata.net/api/v1/DeleteVPN \
  -H "Authorization: Bearer $YOUR_API_KEY" \
  -H 'Content-Type: application/json' \
  -d '{"vpn_id":"vpn_6t2k9p"}'

جاواب200 · application/json

statusenum

اوغور حالیندا همیشه deleted.

بونلاردان بیری:deleted

نۆمونه جاواب

{"status": "deleted"}

سرور ساتیشی

VPS ساتیشی VPN ساتیشی ایله عئینی اؤده‌نیش مقاویله‌سیدیر — یالنیز سبت فرقلیدیر.

POST

GetVPSStorefront

read

https://apiservice.vitamindata.net/api/v1/GetVPSStorefront

مکانلار، هر بیرینده قیمتلندیریلمیش پلانلار و بوت اولونا بیلن ایمیجلر.

available:false اولان نودون توتومو قورتاریب — گؤسترین، آمّا تکلیف ائتمه‌یین.

سورغو

پارامتر یوخدور — بوش بیر آبجئکت گؤندرین، {}.

نۆمونه سورغو

curl https://apiservice.vitamindata.net/api/v1/GetVPSStorefront \
  -H "Authorization: Bearer $YOUR_API_KEY" \
  -H 'Content-Type: application/json' \
  -d '{}'

جاواب200 · application/json

nodesarray

مکانلار، هر بیری اؤز قیمتلندیریلمیش پلانلاری ایله.

nodes[].node_idstring

بیر سبتین node_id ساحه‌سینین آلدیغی مقدار.

nodes[].labelstring

گؤستریلن آد (Frankfurt).

nodes[].regionstring

قروپلاشدیرما اۆچون کوبود بؤلگه کدی.

nodes[].countrystring

ISO اؤلکه کدی، بایراقلار اۆچون.

nodes[].availablebool

یوخ/false = توتوم قورتاریب: گؤسترین، تکلیف ائتمه‌یین.

nodes[].plansarray

بۇرادا نه ساتیلا بیلر، قیمتی ایله.

nodes[].plans[].plan_codestring

بیر سبتین plan_code ساحه‌سینین آلدیغی مقدار.

nodes[].plans[].namestring

گؤستریلن آد.

nodes[].plans[].vcpuint

چکیردکلر.

nodes[].plans[].ram_mbint

یادداش، مگابایت ایله.

nodes[].plans[].disk_gbint

دیسک، گیگابایت ایله.

nodes[].plans[].traffic_bytesbytes

ایچینده‌کی آیلیق ترافیک.

nodes[].plans[].price_usd_monthmoney

بۇ نوددا آیلیق قیمت — عئینی پلان باشقا یئرده باشقا قیمته اولا بیلر.

imagesarray

بوت و یا نصب اولونا بیلن هر شئی.

images[].shastring

ایمیجین تک تانیدیجیسی — سبتلر، یئنی‌دن نصبلر و ISO قوشمالار هامیسی اونو آلیر.

images[].namestring

اینسان اوخویان آد (Debian 13).

images[].kindenum

disk ایمیجی بیرباشا قۇرولور؛ iso ایسه بوت ائدیب نصب ائتدیینیز بیر نصب‌چیدیر.

بونلاردان بیری:diskiso

images[].os_familyenum

اینترفئیسینیزین قروپلاشدیرماسی و ایکونلاری اۆچون.

بونلاردان بیری:linuxwindowsmikrotik

images[].min_disk_gbint

داها کیچیک دیسکه یئنی‌دن نصب رد ائدیلیر — اؤنجه دیسکی بؤیۆدۆن.

months_minint

یئنی بیر ماشینین آلینا بیله‌جیی ان قیسا مۆدت.

months_maxint

ان اوزون.

نۆمونه جاواب

{
  "nodes": [
    {"node_id": "de1", "label": "Frankfurt", "region": "eu", "country": "DE", "available": true,
     "plans": [
       {"plan_code": "s2", "name": "S2", "vcpu": 2, "ram_mb": 4096, "disk_gb": 40,
        "traffic_bytes": "2199023255552", "price_usd_month": "8.00"}
     ]}
  ],
  "images": [
    {"sha": "9a1b8c2d7e6f", "name": "Debian 13", "kind": "disk", "os_family": "linux", "min_disk_gb": 10}
  ],
  "months_min": 1,
  "months_max": 12
}

POST

ListVPSImages

read

https://apiservice.vitamindata.net/api/v1/ListVPSImages

بوت و یا نصب ائده بیله‌جیینیز بۆتۆن ایمیجلر، sha ایله.

sha، سبتین، یئنی‌دن نصبین و ISO قوشمانین هامیسینین آلدیغی شئیدیر. بیر ایمیجی باشقا هئچ نه تانیتمیر.

سورغو

پارامتر یوخدور — بوش بیر آبجئکت گؤندرین، {}.

نۆمونه سورغو

curl https://apiservice.vitamindata.net/api/v1/ListVPSImages \
  -H "Authorization: Bearer $YOUR_API_KEY" \
  -H 'Content-Type: application/json' \
  -d '{}'

جاواب200 · application/json

imagesarray

کاتالوق.

images[].shastring

ایمیجین تک تانیدیجیسی — سبتلر، یئنی‌دن نصبلر و ISO قوشمالار هامیسی اونو آلیر.

images[].namestring

اینسان اوخویان آد (Debian 13).

images[].kindenum

disk ایمیجی بیرباشا قۇرولور؛ iso ایسه بوت ائدیب نصب ائتدیینیز بیر نصب‌چیدیر.

بونلاردان بیری:diskiso

images[].os_familyenum

اینترفئیسینیزین قروپلاشدیرماسی و ایکونلاری اۆچون.

بونلاردان بیری:linuxwindowsmikrotik

images[].min_disk_gbint

داها کیچیک دیسکه یئنی‌دن نصب رد ائدیلیر — اؤنجه دیسکی بؤیۆدۆن.

نۆمونه جاواب

{
  "images": [
    {"sha": "9a1b8c2d7e6f", "name": "Debian 13", "kind": "disk", "os_family": "linux", "min_disk_gb": 10},
    {"sha": "3f4e5d6c7b8a", "name": "Windows Server 2025 installer", "kind": "iso",
     "os_family": "windows", "min_disk_gb": 40}
  ]
}

POST

QuoteVPS

read

https://apiservice.vitamindata.net/api/v1/QuoteVPS

یئنی بیر سرورون قیمتی، مادّه-مادّه.

سورغو

cartobjectمجبوری

قیمتلندیریله‌جک سرور.

cart.node_idstringمجبوری

ماشینین هارادا یارادیلاجاغی، ماغازانین نودلاریندان.

cart.placementstringرزئرو اولونوب — گؤندرمه‌یین

رزئرو اولونوب. بۇ API-ده سرورون هارادا یارادیلاجاغینا همیشه node_id قرار وئریر — اونو گؤندرین و نودو ماغازادان اؤزۆنۆز سئچین.

بونلاردان بیری:auto

cart.plan_codestringمجبوری

پلان، سئچیلن نودون اؤز قیمت سیاهیسیندان — پلانلار و قیمتلر هر نوددا فرقلیدیر.

cart.image_shastringمجبوری

نه بوت و یا نصب ائدیله‌جک، sha ایله. دیسک ایمیجلری بیرباشا قۇرولور؛ نصب ISO فایلی ایسه ماشین اوندان بوت ائده‌جک شکیلده قوشولموش گلیر.

cart.namestringمجبوری

ماشینین هوست آدی / اتیکتی.

cart.monthsintمجبوری

ایلک مۆدت، ماغازانین آی حددلری ایچینده.

cart.extra_disk_gbintایختیاری

پلانین وئردیییندن آرتیق علاوه دیسک، گیگابایت ایله.

cart.extra_ipsintایختیاری

علاوه عمومی IPv4 اۆنوانلاری.

cart.extra_traffic_tbmoneyایختیاری

علاوه آیلیق ترافیک، ترابایت ایله، اوندالیق متن کیمی ("0.5").

نۆمونه سورغو

curl https://apiservice.vitamindata.net/api/v1/QuoteVPS \
  -H "Authorization: Bearer $YOUR_API_KEY" \
  -H 'Content-Type: application/json' \
  -d '{"cart":{"node_id":"de1","plan_code":"s2","image_sha":"9a1b8c2d7e6f","months":2,"name":"web-1","extra_disk_gb":20,"extra_ips":1,"extra_traffic_tb":"0.5"}}'

جاواب200 · application/json

quoteobject

مادّه-مادّه قیمت. هئچ نه یارادیلمیر و هئچ نه یازیلمیر.

quote.model_namestring

هانسی قیمتلندیرمه مودئلینین جاواب وئردیی.

quote.model_typestring

مودئلین موتور وئرسیاسی.

quote.base_usdmoney

اندیریملر و علاوه حاقلاردان اؤنجه‌کی قیمت.

quote.total_usdmoney

سون قیمت — بۇ سبتله بیر ساتیشین یازدیغی مبلغ.

quote.linesarray

مادّه-مادّه بؤلگۆ، ایشاره‌لی، دقیقاً جمعه برابر.

quote.lines[].codestring

بۇ سطرین نه اولدوغو (base، بیر اندیریم کدی، بیر علاوه حاق…).

quote.lines[].kindstring

سطرین کاتقوریاسی، اینترفئیسینیزده قروپلاشدیرماق اۆچون.

quote.lines[].amount_usdmoney

ایشاره‌لی. اندیریملر منفیدیر؛ سطرلر دقیقاً total_usd مقدارینا جمعلنیر.

quote.lines[].pctstring

سطرین آرخاسینداکی فایز، اولاندا.

quote.cappedbool

جمع مودئلین تاوانینا دَییب.

quote.floor_appliedbool

جمع مودئلین دؤشمه‌سینه قدر قالدیریلیب.

quote.clampedenum

بیر سبت مقداری قیمتلندیرمه‌دن اؤنجه حددلره سیخیلاندا قۇرولور.

بونلاردان بیری:minmax

quote.invalidstring

بوش دئییلسه، سبت قیمتلندیریله بیلمز — اونو گؤسترین و بئله بیر قیمتلندیرمه‌یه گؤره هئچ واخت پول یازمایین.

quote.metamap

مودئل علاوه‌لری، متن→متن (مثلاً بیر یۆکسلتمه‌نین remaining_days ساحه‌سی).

نۆمونه جاواب

{
  "quote": {
    "model_name": "vps_plan",
    "model_type": "vps_plan_v1",
    "base_usd": "16.00",
    "total_usd": "16.00",
    "lines": [
      {"code": "plan_s2", "kind": "base", "amount_usd": "16.00"}
    ],
    "meta": {"months": "2"}
  }
}

POST

CreateVPSOrder

buyIdempotency-Key

https://apiservice.vitamindata.net/api/v1/CreateVPSOrder

بیر سرور آلیر و قۇرور.

چاتدیریلما اۆچون GetOrder، سونرا ماشین اۆچون GetVPS ایله یوخلایین.

سورغو

cartobjectمجبوری

نه یارادیلاجاق — QuoteVPS-ین قیمتلندیردیی عئینی شکیل.

cart.node_idstringمجبوری

ماشینین هارادا یارادیلاجاغی، ماغازانین نودلاریندان.

cart.placementstringرزئرو اولونوب — گؤندرمه‌یین

بونلاردان بیری:auto

cart.plan_codestringمجبوری

پلان، سئچیلن نودون اؤز قیمت سیاهیسیندان — پلانلار و قیمتلر هر نوددا فرقلیدیر.

cart.image_shastringمجبوری

cart.namestringمجبوری

ماشینین هوست آدی / اتیکتی.

cart.monthsintمجبوری

ایلک مۆدت، ماغازانین آی حددلری ایچینده.

cart.extra_disk_gbintایختیاری

پلانین وئردیییندن آرتیق علاوه دیسک، گیگابایت ایله.

cart.extra_ipsintایختیاری

علاوه عمومی IPv4 اۆنوانلاری.

cart.extra_traffic_tbmoneyایختیاری

علاوه آیلیق ترافیک، ترابایت ایله، اوندالیق متن کیمی ("0.5").

fundingenumمجبوری

نئجه اؤده‌نیله‌جک — باخین: اؤده‌نیش. دیفالت یوخدور: گؤندرمه‌مک رد ائدیلیر.

بونلاردان بیری:FUNDING_AUTOFUNDING_BALANCEFUNDING_INVOICE

expected_total_usdmoneyایختیاری

نۆمونه سورغو

curl https://apiservice.vitamindata.net/api/v1/CreateVPSOrder \
  -H "Authorization: Bearer $YOUR_API_KEY" \
  -H 'Content-Type: application/json' \
  -H "Idempotency-Key: $(uuidgen)" \
  -d '{"cart":{"node_id":"de1","plan_code":"s2","image_sha":"9a1b8c2d7e6f","months":2,"name":"web-1","extra_disk_gb":20,"extra_ips":1,"extra_traffic_tb":"0.5"},"funding":"FUNDING_AUTO","expected_total_usd":"36.00"}'

جاواب200 · application/json

orderobject

سیفاریش — وضعیتی delivered اولانا قدر GetOrder ایله یوخلایین.

order.order_idstring

سیفاریشین عمومی ای‌دیسی (ord_…).

order.productenum

نه آلینیب.

بونلاردان بیری:vpnvps

order.kindstring

آلیش شکلی: new، extend، upgrade…

order.statusenum

بونلاردان بیری:createdinvoicedpaiddeliveringdeliveredneeds_operatorfailedrefund_pendingrefundedexpired

order.fundingenum

اونو حقیقتاً هانسی یولون اؤدَدیی. FUNDING_AUTO بونلاردان بیرینه چئوریلیر.

بونلاردان بیری:invoicebalance

order.total_usdmoney

سیفاریشین یازدیغی مبلغ.

order.invoice_idstring

اونون آرخاسینداکی فاکتور — هانسی یولون اؤدَدیییندن آسیلی اولمایاراق هر سیفاریشین بیری وار.

order.itemsint

سیفاریشین نئچه حاق یاراتدیغی و یا اوزاتدیغی.

order.created_atunix

نه واخت وئریلیب.

order.delivered_atunix

چاتدیریلمانین بیتدیی واخت. اوندان اؤنجه یوخدور.

order.breakdownobject

مۆشتری‌نین راضی اولدوغو قیمتلندیرمه، عئینن — Quote-ون قایتاردیغی عئینی شکیل.

invoiceobject

سیفاریشین آرخاسینداکی فاکتور: payment_required اولاندا اؤده‌نیله بیلر، completed اولاندا آرتیق قاپانیب.

invoice.invoice_idstring

شلوزون فاکتور ای‌دیسی (inv_…).

invoice.statusenum

بونلاردان بیری:pendingconfirmedsweepingsweptdeliveringdelivereddelivered_redirectedexpired

invoice.pay_urlstring

invoice.pay_telegram_urlstring

invoice.price_usdmoney

فاکتورون ییغدیغی مبلغ.

invoice.expires_atunix

اؤده‌نیش پنجره‌سینین قاپاندیغی واخت.

paidbool

پول توتولوب. payment_required ایله بیرلیکده یوخدور (= false).

statusenum

بوداقلانیلاجاق ساحه بۇدور — باخین: اؤده‌نیش.

بونلاردان بیری:completedpayment_required

نۆمونه جاواب

{
  "order": {
    "order_id": "ord_2f8k3j", "product": "vps", "kind": "new",
    "status": "invoiced", "funding": "invoice", "total_usd": "16.00",
    "invoice_id": "inv_7h4w9s", "items": 1, "created_at": "1785412800"
  },
  "invoice": {
    "invoice_id": "inv_7h4w9s", "status": "pending",
    "pay_url": "https://pay.example.com/i/inv_7h4w9s",
    "price_usd": "16.00", "expires_at": "1785499200"
  },
  "status": "payment_required"
}

POST

QuoteVPSExtend

read

https://apiservice.vitamindata.net/api/v1/QuoteVPSExtend

بیر سروری یئنیله‌مه‌نین قیمتی.

سورغو

vps_idstringمجبوری

سرورون ای‌دیسی، ListVPS-دن.

monthsintمجبوری

نئچه آی علاوه اولوناجاق. ماغازانین months_min…months_max حددلری سیزین اینترفئیسینیزین تکلیف ائتمه‌لی اولدوغودور، آمّا یئنیله‌مه اونلارا سیخیلمیر — عاغیللی بیر رقم گؤندرین، چۆنکی نه گؤندرسه‌نیز، او قیمتلندیریلیر و یازیلیر.

نۆمونه سورغو

curl https://apiservice.vitamindata.net/api/v1/QuoteVPSExtend \
  -H "Authorization: Bearer $YOUR_API_KEY" \
  -H 'Content-Type: application/json' \
  -d '{"vps_id":"vm_7q3k1n","months":1}'

جاواب200 · application/json

quoteobject

مادّه-مادّه قیمت. هئچ نه یارادیلمیر و هئچ نه یازیلمیر.

quote.model_namestring

هانسی قیمتلندیرمه مودئلینین جاواب وئردیی.

quote.model_typestring

مودئلین موتور وئرسیاسی.

quote.base_usdmoney

اندیریملر و علاوه حاقلاردان اؤنجه‌کی قیمت.

quote.total_usdmoney

سون قیمت — بۇ سبتله بیر ساتیشین یازدیغی مبلغ.

quote.linesarray

مادّه-مادّه بؤلگۆ، ایشاره‌لی، دقیقاً جمعه برابر.

quote.lines[].codestring

بۇ سطرین نه اولدوغو (base، بیر اندیریم کدی، بیر علاوه حاق…).

quote.lines[].kindstring

سطرین کاتقوریاسی، اینترفئیسینیزده قروپلاشدیرماق اۆچون.

quote.lines[].amount_usdmoney

ایشاره‌لی. اندیریملر منفیدیر؛ سطرلر دقیقاً total_usd مقدارینا جمعلنیر.

quote.lines[].pctstring

سطرین آرخاسینداکی فایز، اولاندا.

quote.cappedbool

جمع مودئلین تاوانینا دَییب.

quote.floor_appliedbool

جمع مودئلین دؤشمه‌سینه قدر قالدیریلیب.

quote.clampedenum

بیر سبت مقداری قیمتلندیرمه‌دن اؤنجه حددلره سیخیلاندا قۇرولور.

بونلاردان بیری:minmax

quote.invalidstring

بوش دئییلسه، سبت قیمتلندیریله بیلمز — اونو گؤسترین و بئله بیر قیمتلندیرمه‌یه گؤره هئچ واخت پول یازمایین.

quote.metamap

مودئل علاوه‌لری، متن→متن (مثلاً بیر یۆکسلتمه‌نین remaining_days ساحه‌سی).

نۆمونه جاواب

{
  "quote": {
    "model_name": "vps_plan",
    "model_type": "vps_plan_v1",
    "base_usd": "16.00",
    "total_usd": "16.00",
    "lines": [
      {"code": "plan_s2", "kind": "base", "amount_usd": "16.00"}
    ],
    "meta": {"months": "2"}
  }
}

POST

ExtendVPS

buyIdempotency-Key

https://apiservice.vitamindata.net/api/v1/ExtendVPS

بیر سروری یئنیله‌ییر.

ائرکن یئنیله‌مه علاوه خرج چیخارمیر: یئنی بیتمه تاریخی بۇ گۆندن یوخ، ایندیکی بیتمه تاریخیندن حسابلانیر.

سورغو

vps_idstringمجبوری

سرورون ای‌دیسی، ListVPS-دن.

monthsintمجبوری

fundingenumمجبوری

نئجه اؤده‌نیله‌جک — باخین: اؤده‌نیش. دیفالت یوخدور: گؤندرمه‌مک رد ائدیلیر.

بونلاردان بیری:FUNDING_AUTOFUNDING_BALANCEFUNDING_INVOICE

expected_total_usdmoneyایختیاری

نۆمونه سورغو

curl https://apiservice.vitamindata.net/api/v1/ExtendVPS \
  -H "Authorization: Bearer $YOUR_API_KEY" \
  -H 'Content-Type: application/json' \
  -H "Idempotency-Key: $(uuidgen)" \
  -d '{"vps_id":"vm_7q3k1n","months":1,"funding":"FUNDING_AUTO","expected_total_usd":"8.00"}'

جاواب200 · application/json

orderobject

سیفاریش — وضعیتی delivered اولانا قدر GetOrder ایله یوخلایین.

order.order_idstring

سیفاریشین عمومی ای‌دیسی (ord_…).

order.productenum

نه آلینیب.

بونلاردان بیری:vpnvps

order.kindstring

آلیش شکلی: new، extend، upgrade…

order.statusenum

بونلاردان بیری:createdinvoicedpaiddeliveringdeliveredneeds_operatorfailedrefund_pendingrefundedexpired

order.fundingenum

اونو حقیقتاً هانسی یولون اؤدَدیی. FUNDING_AUTO بونلاردان بیرینه چئوریلیر.

بونلاردان بیری:invoicebalance

order.total_usdmoney

سیفاریشین یازدیغی مبلغ.

order.invoice_idstring

اونون آرخاسینداکی فاکتور — هانسی یولون اؤدَدیییندن آسیلی اولمایاراق هر سیفاریشین بیری وار.

order.itemsint

سیفاریشین نئچه حاق یاراتدیغی و یا اوزاتدیغی.

order.created_atunix

نه واخت وئریلیب.

order.delivered_atunix

چاتدیریلمانین بیتدیی واخت. اوندان اؤنجه یوخدور.

order.breakdownobject

مۆشتری‌نین راضی اولدوغو قیمتلندیرمه، عئینن — Quote-ون قایتاردیغی عئینی شکیل.

invoiceobject

سیفاریشین آرخاسینداکی فاکتور: payment_required اولاندا اؤده‌نیله بیلر، completed اولاندا آرتیق قاپانیب.

invoice.invoice_idstring

شلوزون فاکتور ای‌دیسی (inv_…).

invoice.statusenum

بونلاردان بیری:pendingconfirmedsweepingsweptdeliveringdelivereddelivered_redirectedexpired

invoice.pay_urlstring

invoice.pay_telegram_urlstring

invoice.price_usdmoney

فاکتورون ییغدیغی مبلغ.

invoice.expires_atunix

اؤده‌نیش پنجره‌سینین قاپاندیغی واخت.

paidbool

پول توتولوب. payment_required ایله بیرلیکده یوخدور (= false).

statusenum

بوداقلانیلاجاق ساحه بۇدور — باخین: اؤده‌نیش.

بونلاردان بیری:completedpayment_required

نۆمونه جاواب

{
  "order": {
    "order_id": "ord_5d1p8m", "product": "vps", "kind": "extend",
    "status": "paid", "funding": "balance", "total_usd": "8.00",
    "invoice_id": "inv_1c6v3z", "items": 1, "created_at": "1785412800"
  },
  "invoice": {
    "invoice_id": "inv_1c6v3z", "status": "confirmed", "price_usd": "8.00"
  },
  "paid": true,
  "status": "completed"
}

POST

QuoteVPSUpgrade

read

https://apiservice.vitamindata.net/api/v1/QuoteVPSUpgrade

داها بؤیۆک بیر شکلین قیمتی، آرتیق اؤده‌نیلمیش واختا گؤره نیسبتلندیریلمیش.

سورغو

vps_idstringمجبوری

سرورون ای‌دیسی، ListVPS-دن.

specobjectمجبوری

هدف شکیل. گؤندریلمه‌ین و یا صفیر اولان ساحه‌لر ایندیکی مقدارینی ساخلاییر.

spec.vcpuintایختیاری

هدف چکیردک سایی. 0 ایندیکی مقداری ساخلاییر.

spec.ram_mbintایختیاری

هدف یادداش، مگابایت ایله. 0 ایندیکی مقداری ساخلاییر.

spec.disk_gbintایختیاری

هدف دیسک، گیگابایت ایله. دیسک یالنیز بؤیۆیۆر — کیچیک مقدار رد ائدیلیر، چۆنکی عملیات سیستمی آلتیندا فایل سیستمینی کیچیلتمک دیتا ایتکیسیدیر.

نۆمونه سورغو

curl https://apiservice.vitamindata.net/api/v1/QuoteVPSUpgrade \
  -H "Authorization: Bearer $YOUR_API_KEY" \
  -H 'Content-Type: application/json' \
  -d '{"vps_id":"vm_7q3k1n","spec":{"vcpu":4,"ram_mb":8192,"disk_gb":80}}'

جاواب200 · application/json

quoteobject

مادّه-مادّه قیمت. هئچ نه یارادیلمیر و هئچ نه یازیلمیر.

quote.model_namestring

هانسی قیمتلندیرمه مودئلینین جاواب وئردیی.

quote.model_typestring

مودئلین موتور وئرسیاسی.

quote.base_usdmoney

اندیریملر و علاوه حاقلاردان اؤنجه‌کی قیمت.

quote.total_usdmoney

سون قیمت — بۇ سبتله بیر ساتیشین یازدیغی مبلغ.

quote.linesarray

مادّه-مادّه بؤلگۆ، ایشاره‌لی، دقیقاً جمعه برابر.

quote.lines[].codestring

بۇ سطرین نه اولدوغو (base، بیر اندیریم کدی، بیر علاوه حاق…).

quote.lines[].kindstring

سطرین کاتقوریاسی، اینترفئیسینیزده قروپلاشدیرماق اۆچون.

quote.lines[].amount_usdmoney

ایشاره‌لی. اندیریملر منفیدیر؛ سطرلر دقیقاً total_usd مقدارینا جمعلنیر.

quote.lines[].pctstring

سطرین آرخاسینداکی فایز، اولاندا.

quote.cappedbool

جمع مودئلین تاوانینا دَییب.

quote.floor_appliedbool

جمع مودئلین دؤشمه‌سینه قدر قالدیریلیب.

quote.clampedenum

بیر سبت مقداری قیمتلندیرمه‌دن اؤنجه حددلره سیخیلاندا قۇرولور.

بونلاردان بیری:minmax

quote.invalidstring

بوش دئییلسه، سبت قیمتلندیریله بیلمز — اونو گؤسترین و بئله بیر قیمتلندیرمه‌یه گؤره هئچ واخت پول یازمایین.

quote.metamap

مودئل علاوه‌لری، متن→متن (مثلاً بیر یۆکسلتمه‌نین remaining_days ساحه‌سی).

restart_requiredbool

بۇ شکلی تطبیق ائتمک گۆج دؤورو ایسته‌ییر — مۆشتری بونو اؤده‌مه‌میشدن اؤنجه بیلمه‌لیدیر.

monthly_before_usdmoney

بۇ گۆنکۆ تکرارلانان قیمت.

monthly_after_usdmoney

یۆکسلتمه‌دن سونراکی تکرارلانان قیمت — بۇندان سونرا یئنیله‌مه‌لرین قیمتی.

نۆمونه جاواب

{
  "quote": {
    "model_name": "vps_upgrade",
    "model_type": "vps_plan_v1",
    "base_usd": "4.20",
    "total_usd": "4.20",
    "lines": [
      {"code": "prorate_vcpu", "kind": "vps_upgrade", "amount_usd": "2.40"},
      {"code": "prorate_ram", "kind": "vps_upgrade", "amount_usd": "1.80"}
    ],
    "meta": {"remaining_days": "21", "monthly_delta_usd": "6.00", "quote_expires_at": "1785416400"}
  },
  "restart_required": true,
  "monthly_before_usd": "8.00",
  "monthly_after_usd": "14.00"
}

POST

UpgradeVPS

buyIdempotency-Key

https://apiservice.vitamindata.net/api/v1/UpgradeVPS

داها بؤیۆک بیر شکلین پولونو آلیر و تطبیق ائدیر. دیسک یالنیز بؤیۆیه بیلر.

سورغو

vps_idstringمجبوری

سرورون ای‌دیسی، ListVPS-دن.

specobjectمجبوری

هدف شکیل — اؤنجه اونو قیمتلندیرین؛ قیمتلندیرمه یئنی‌دن باشلاتما حاقّیندا دا خبر وئریر.

spec.vcpuintایختیاری

هدف چکیردک سایی. 0 ایندیکی مقداری ساخلاییر.

spec.ram_mbintایختیاری

هدف یادداش، مگابایت ایله. 0 ایندیکی مقداری ساخلاییر.

spec.disk_gbintایختیاری

fundingenumمجبوری

نئجه اؤده‌نیله‌جک — باخین: اؤده‌نیش. دیفالت یوخدور: گؤندرمه‌مک رد ائدیلیر.

بونلاردان بیری:FUNDING_AUTOFUNDING_BALANCEFUNDING_INVOICE

expected_total_usdmoneyایختیاری

نۆمونه سورغو

curl https://apiservice.vitamindata.net/api/v1/UpgradeVPS \
  -H "Authorization: Bearer $YOUR_API_KEY" \
  -H 'Content-Type: application/json' \
  -H "Idempotency-Key: $(uuidgen)" \
  -d '{"vps_id":"vm_7q3k1n","spec":{"vcpu":4,"ram_mb":8192,"disk_gb":80},"funding":"FUNDING_AUTO","expected_total_usd":"4.20"}'

جاواب200 · application/json

orderobject

سیفاریش — وضعیتی delivered اولانا قدر GetOrder ایله یوخلایین.

order.order_idstring

سیفاریشین عمومی ای‌دیسی (ord_…).

order.productenum

نه آلینیب.

بونلاردان بیری:vpnvps

order.kindstring

آلیش شکلی: new، extend، upgrade…

order.statusenum

بونلاردان بیری:createdinvoicedpaiddeliveringdeliveredneeds_operatorfailedrefund_pendingrefundedexpired

order.fundingenum

اونو حقیقتاً هانسی یولون اؤدَدیی. FUNDING_AUTO بونلاردان بیرینه چئوریلیر.

بونلاردان بیری:invoicebalance

order.total_usdmoney

سیفاریشین یازدیغی مبلغ.

order.invoice_idstring

اونون آرخاسینداکی فاکتور — هانسی یولون اؤدَدیییندن آسیلی اولمایاراق هر سیفاریشین بیری وار.

order.itemsint

سیفاریشین نئچه حاق یاراتدیغی و یا اوزاتدیغی.

order.created_atunix

نه واخت وئریلیب.

order.delivered_atunix

چاتدیریلمانین بیتدیی واخت. اوندان اؤنجه یوخدور.

order.breakdownobject

مۆشتری‌نین راضی اولدوغو قیمتلندیرمه، عئینن — Quote-ون قایتاردیغی عئینی شکیل.

invoiceobject

سیفاریشین آرخاسینداکی فاکتور: payment_required اولاندا اؤده‌نیله بیلر، completed اولاندا آرتیق قاپانیب.

invoice.invoice_idstring

شلوزون فاکتور ای‌دیسی (inv_…).

invoice.statusenum

بونلاردان بیری:pendingconfirmedsweepingsweptdeliveringdelivereddelivered_redirectedexpired

invoice.pay_urlstring

invoice.pay_telegram_urlstring

invoice.price_usdmoney

فاکتورون ییغدیغی مبلغ.

invoice.expires_atunix

اؤده‌نیش پنجره‌سینین قاپاندیغی واخت.

paidbool

پول توتولوب. payment_required ایله بیرلیکده یوخدور (= false).

statusenum

بوداقلانیلاجاق ساحه بۇدور — باخین: اؤده‌نیش.

بونلاردان بیری:completedpayment_required

نۆمونه جاواب

{
  "order": {
    "order_id": "ord_5d1p8m", "product": "vps", "kind": "extend",
    "status": "paid", "funding": "balance", "total_usd": "8.00",
    "invoice_id": "inv_1c6v3z", "items": 1, "created_at": "1785412800"
  },
  "invoice": {
    "invoice_id": "inv_1c6v3z", "status": "confirmed", "price_usd": "8.00"
  },
  "paid": true,
  "status": "completed"
}

سرورلرین ایداره‌سی

بۇرادا هر فعل سروری id ایله آلیر — بۇ چاغیریشلاردا ساحه‌نین آدی حقیقتاً id-دیر، پول فعللرینده‌کی vps_id-دن فرقلی.

POST

ListVPS

read

https://apiservice.vitamindata.net/api/v1/ListVPS

ماشینلارینیز، گۆج وضعیتی و اۆنوانلاری ایله.

سورغو

limitintایختیاری

صحیفه اؤلچۆسۆ. دیفالت 50.

cursorcursorایختیاری

اؤنجه‌کی جوابین next_cursor مقداری. ایلک صحیفه اۆچون گؤندرمه‌یین.

نۆمونه سورغو

curl https://apiservice.vitamindata.net/api/v1/ListVPS \
  -H "Authorization: Bearer $YOUR_API_KEY" \
  -H 'Content-Type: application/json' \
  -d '{"limit":50,"cursor":""}'

جاواب200 · application/json

vpsarray

ماشینلارینیز.

vps[].idstring

سرورون ای‌دیسی — هر ایداره فعلینین id ساحه‌سی و هر پول فعلینین vps_id ساحه‌سی اونو آلیر.

vps[].namestring

اونون هوست آدی / اتیکتی.

vps[].node_idstring

هارادا ایشله‌دیی.

vps[].lifecycleenum

0 قۇرولور · 1 فعال · 2 دوندورولوب · 3 سیلینیر · 4 سیلینیب.

بونلاردان بیری:01234

vps[].provisionedbool

ماشین اؤز هوستوندا مؤوجوددور.

vps[].power_desiredenum

گۆجۆن نئجه اولماسی لازیم اولدوغو: 1 آچیق، 0/یوخ سؤنۆک. جانلی وضعیت GetVPSStats.running-دیر.

بونلاردان بیری:01

vps[].vcpuint

چکیردکلر.

vps[].mem_mbint

یادداش، مگابایت ایله.

vps[].disk_gbint

دیسک، گیگابایت ایله.

vps[].image_shastring

نه‌دن بوت ائتدیی و یا نصب اولوندوغو.

vps[].expires_atunix

سرورون بیتدیی واخت — بۇندان اؤنجه ExtendVPS ایله یئنیله‌یین.

vps[].created_atunix

نه واخت یارادیلیب.

vps[].ipsarray

اونون عمومی اۆنوانلاری.

vps[].private_ipstring

پلانین وئردیی حالدا اونون خصوصی اۆنوانی.

next_cursorcursor

نؤوبتی صحیفه اۆچون اونو cursor کیمی گئری گؤندرین. یوخ/بوش = هر شئیی آلمیسینیز.

نۆمونه جاواب

{
  "vps": [{
    "id": "vm_7q3k1n",
    "name": "web-1",
    "node_id": "de1",
    "lifecycle": 1,
    "provisioned": true,
    "power_desired": 1,
    "vcpu": 2,
    "mem_mb": 4096,
    "disk_gb": 40,
    "image_sha": "9a1b8c2d7e6f",
    "expires_at": "1793188800",
    "created_at": "1785000000",
    "ips": ["203.0.113.10"],
    "private_ip": "10.77.0.10"
  }]
}

POST

GetVPS

read

https://apiservice.vitamindata.net/api/v1/GetVPS

بیر ماشین تفصیلاتی ایله.

سورغو

idstringمجبوری

سرورون ای‌دیسی، ListVPS-دن. دیقّت: ایداره فعللرینده ساحه id-دیر — یالنیز پول فعللری اونو vps_id یازیر.

نۆمونه سورغو

curl https://apiservice.vitamindata.net/api/v1/GetVPS \
  -H "Authorization: Bearer $YOUR_API_KEY" \
  -H 'Content-Type: application/json' \
  -d '{"id":"vm_7q3k1n"}'

جاواب200 · application/json

vpsobject

ماشین.

vps.idstring

سرورون ای‌دیسی — هر ایداره فعلینین id ساحه‌سی و هر پول فعلینین vps_id ساحه‌سی اونو آلیر.

vps.namestring

اونون هوست آدی / اتیکتی.

vps.node_idstring

هارادا ایشله‌دیی.

vps.lifecycleenum

0 قۇرولور · 1 فعال · 2 دوندورولوب · 3 سیلینیر · 4 سیلینیب.

بونلاردان بیری:01234

vps.provisionedbool

ماشین اؤز هوستوندا مؤوجوددور.

vps.power_desiredenum

گۆجۆن نئجه اولماسی لازیم اولدوغو: 1 آچیق، 0/یوخ سؤنۆک. جانلی وضعیت GetVPSStats.running-دیر.

بونلاردان بیری:01

vps.vcpuint

چکیردکلر.

vps.mem_mbint

یادداش، مگابایت ایله.

vps.disk_gbint

دیسک، گیگابایت ایله.

vps.image_shastring

نه‌دن بوت ائتدیی و یا نصب اولوندوغو.

vps.expires_atunix

سرورون بیتدیی واخت — بۇندان اؤنجه ExtendVPS ایله یئنیله‌یین.

vps.created_atunix

نه واخت یارادیلیب.

vps.ipsarray

اونون عمومی اۆنوانلاری.

vps.private_ipstring

پلانین وئردیی حالدا اونون خصوصی اۆنوانی.

livebool

ایندیجه پلاندان اوخونوب.

نۆمونه جاواب

{
  "vps": {
    "id": "vm_7q3k1n",
    "name": "web-1",
    "node_id": "de1",
    "lifecycle": 1,
    "provisioned": true,
    "power_desired": 1,
    "vcpu": 2,
    "mem_mb": 4096,
    "disk_gb": 40,
    "image_sha": "9a1b8c2d7e6f",
    "expires_at": "1793188800",
    "created_at": "1785000000",
    "ips": ["203.0.113.10"],
    "private_ip": "10.77.0.10"
  },
  "live": true
}

POST

GetVPSStats

read

https://apiservice.vitamindata.net/api/v1/GetVPSStats

جانلی پروسسور، یادداش، دیسک و شبکه.

سورغو

idstringمجبوری

سرورون ای‌دیسی، ListVPS-دن. دیقّت: ایداره فعللرینده ساحه id-دیر — یالنیز پول فعللری اونو vps_id یازیر.

نۆمونه سورغو

curl https://apiservice.vitamindata.net/api/v1/GetVPSStats \
  -H "Authorization: Bearer $YOUR_API_KEY" \
  -H 'Content-Type: application/json' \
  -d '{"id":"vm_7q3k1n"}'

جاواب200 · application/json

cpu_pctint

پروسسور یۆکۆ، فایز ایله.

mem_used_mbint

ایشلنن یادداش، مگابایت.

disk_used_mbint

ایشلنن دیسک، مگابایت.

rx_bpsint64

گیرن، ثانیه‌ده بیت.

tx_bpsint64

چیخان، ثانیه‌ده بیت.

runningbool

ماشین ایندی ایشلک وضعیتده‌دیر.

updated_atunix

بۇ رقملرین گؤتۆرۆلدۆیۆ واخت.

نۆمونه جاواب

{
  "cpu_pct": 12,
  "mem_used_mb": 1536,
  "disk_used_mb": 9216,
  "rx_bps": "1048576",
  "tx_bps": "524288",
  "running": true,
  "updated_at": "1785412790"
}

POST

GetVPSUsage

read

https://apiservice.vitamindata.net/api/v1/GetVPSUsage

ماشینین حجمینه قارشی ایشلنن ترافیک، بسته‌بازیندا.

سورغو

idstringمجبوری

سرورون ای‌دیسی، ListVPS-دن. دیقّت: ایداره فعللرینده ساحه id-دیر — یالنیز پول فعللری اونو vps_id یازیر.

نۆمونه سورغو

curl https://apiservice.vitamindata.net/api/v1/GetVPSUsage \
  -H "Authorization: Bearer $YOUR_API_KEY" \
  -H 'Content-Type: application/json' \
  -d '{"id":"vm_7q3k1n"}'

جاواب200 · application/json

total_downbytes

عؤمۆر بویو ائندیرمه.

total_upbytes

عؤمۆر بویو یۆکله‌مه.

bundlesarray

ترافیک بسته‌لری، ایندی خرجلنه‌نی current ایله ایشاره‌لنمیش.

bundles[].idint64

ترافیک بسته‌سینین حسابلاما پلانینداکی ای‌دیسی.

bundles[].modeint

پلانین حسابلاما رئژیم کدی. شفاف اولمایان سایین.

bundles[].bytes_totalbytes

بسته‌نین تام حجمی.

bundles[].used_dlbytes

اونا قارشی ائندیریلن.

bundles[].used_upbytes

اونا قارشی یۆکلنن.

bundles[].stateint

پلانین وضعیت کدی. شفاف اولمایان سایین.

bundles[].currentbool

ایندی خرجلنن بسته بۇدور.

bundles[].expires_atunix

بسته‌نین بیتدیی واخت.

نۆمونه جاواب

{
  "total_down": "53687091200",
  "total_up": "10737418240",
  "bundles": [
    {"id": "41", "mode": 1, "bytes_total": "2199023255552",
     "used_dl": "53687091200", "used_up": "10737418240",
     "state": 1, "current": true, "expires_at": "1793188800"}
  ]
}

POST

VPSPower

manage

https://apiservice.vitamindata.net/api/v1/VPSPower

گۆج ایداره‌سی.

shutdown عملیات سیستمیندن خواهیش ائدیر؛ force_stop فیشی چکیر. بیرینجینی سئچین.

سورغو

idstringمجبوری

سرورون ای‌دیسی، ListVPS-دن. دیقّت: ایداره فعللرینده ساحه id-دیر — یالنیز پول فعللری اونو vps_id یازیر.

actionenumمجبوری

shutdown/reboot یوموشاقدیر؛ reset/force_stop ایسه گۆج دۆیمه‌سیدیر.

بونلاردان بیری:startshutdownrebootresetforce_stop

نۆمونه سورغو

curl https://apiservice.vitamindata.net/api/v1/VPSPower \
  -H "Authorization: Bearer $YOUR_API_KEY" \
  -H 'Content-Type: application/json' \
  -d '{"id":"vm_7q3k1n","action":"reboot"}'

جاواب200 · application/json

okbool

پلان عملی قبول ائتدی. ماشینین حقیقی وضعیتی اۆچون GetVPSStats ایزله‌یین.

نۆمونه جاواب

{"ok": true}

POST

ReinstallVPS

manage

https://apiservice.vitamindata.net/api/v1/ReinstallVPS

دیسکی سیلیر و تزه بیر ایمیج نصب ائدیر.

داغیدیجیدیر و تکرارا داوامسیزدیر — بیر چاغیریش، بیر یئنی‌دن نصب. ایمیج ایندیکی دیسکه سیغمالیدیر؛ سیغمیرسا، اؤنجه دیسکی بؤیۆدۆن.

سورغو

idstringمجبوری

سرورون ای‌دیسی، ListVPS-دن. دیقّت: ایداره فعللرینده ساحه id-دیر — یالنیز پول فعللری اونو vps_id یازیر.

image_shastringمجبوری

ایمیج، ListVPSImages-دن گلن sha ایله. بیر ایمیجی باشقا هئچ نه آدلاندیرمیر و تکلیف ائدیلمه‌میش sha رد ائدیلیر.

reset_rootboolایختیاری

عئینی زاماندا تزه بیر root پارولو دا یاراتماق.

نۆمونه سورغو

curl https://apiservice.vitamindata.net/api/v1/ReinstallVPS \
  -H "Authorization: Bearer $YOUR_API_KEY" \
  -H 'Content-Type: application/json' \
  -d '{"id":"vm_7q3k1n","image_sha":"9a1b8c2d7e6f","reset_root":true}'

جاواب200 · application/json

okbool

پلان عملی قبول ائتدی. ماشینین حقیقی وضعیتی اۆچون GetVPSStats ایزله‌یین.

نۆمونه جاواب

{"ok": true}

POST

AttachVPSISO

manage

https://apiservice.vitamindata.net/api/v1/AttachVPSISO

نصب ISO فایلینی قوشور. اوندان بوت ائتمک اۆچون بوت آردیجیللیغینی 1 ائدین.

سورغو

idstringمجبوری

سرورون ای‌دیسی، ListVPS-دن. دیقّت: ایداره فعللرینده ساحه id-دیر — یالنیز پول فعللری اونو vps_id یازیر.

image_shastringمجبوری

ایمیج، ListVPSImages-دن گلن sha ایله. بیر ایمیجی باشقا هئچ نه آدلاندیرمیر و تکلیف ائدیلمه‌میش sha رد ائدیلیر.

نۆمونه سورغو

curl https://apiservice.vitamindata.net/api/v1/AttachVPSISO \
  -H "Authorization: Bearer $YOUR_API_KEY" \
  -H 'Content-Type: application/json' \
  -d '{"id":"vm_7q3k1n","image_sha":"3f4e5d6c7b8a"}'

جاواب200 · application/json

okbool

پلان عملی قبول ائتدی. ماشینین حقیقی وضعیتی اۆچون GetVPSStats ایزله‌یین.

نۆمونه جاواب

{"ok": true}

POST

DetachVPSISO

manage

https://apiservice.vitamindata.net/api/v1/DetachVPSISO

ISO فایلینی آییریر و یئنه دیسکدن بوت ائتمه‌یه قاییدیر.

سورغو

idstringمجبوری

سرورون ای‌دیسی، ListVPS-دن. دیقّت: ایداره فعللرینده ساحه id-دیر — یالنیز پول فعللری اونو vps_id یازیر.

نۆمونه سورغو

curl https://apiservice.vitamindata.net/api/v1/DetachVPSISO \
  -H "Authorization: Bearer $YOUR_API_KEY" \
  -H 'Content-Type: application/json' \
  -d '{"id":"vm_7q3k1n"}'

جاواب200 · application/json

okbool

پلان عملی قبول ائتدی. ماشینین حقیقی وضعیتی اۆچون GetVPSStats ایزله‌یین.

نۆمونه جاواب

{"ok": true}

POST

SetVPSBootOrder

manage

https://apiservice.vitamindata.net/api/v1/SetVPSBootOrder

هانسی جیهازین اؤنجه بوت اولاجاغی.

سورغو

idstringمجبوری

سرورون ای‌دیسی، ListVPS-دن. دیقّت: ایداره فعللرینده ساحه id-دیر — یالنیز پول فعللری اونو vps_id یازیر.

orderenumمجبوری

0 اؤنجه دیسک، 1 اؤنجه CD-ROM.

بونلاردان بیری:01

نۆمونه سورغو

curl https://apiservice.vitamindata.net/api/v1/SetVPSBootOrder \
  -H "Authorization: Bearer $YOUR_API_KEY" \
  -H 'Content-Type: application/json' \
  -d '{"id":"vm_7q3k1n","order":1}'

جاواب200 · application/json

okbool

پلان عملی قبول ائتدی. ماشینین حقیقی وضعیتی اۆچون GetVPSStats ایزله‌یین.

نۆمونه جاواب

{"ok": true}