psژبه
وړیا پیل کړئ
ننوتلوړیا پیل کړئ

پوهه بنسټ

د خپل سیسټم څخه د Zinn® هوسټنګ پلورل

د Zinn هوسټینګ د خپل بلینګ پینل، WordPress سایټ یا سکریپټونو څخه کنټرول کړئ: یوه API کلي ترلاسه کړئ، خپل لومړی زنګ ووهئ، او هغه شپږ زنګونه چې ټول انټیګریشن پرې ولاړ دی.

تاسو زموږ کوربه توب (هاسټنګ) بیا پلورئ. ستاسو پیرودونکي ستاسو خپل دي: ستاسو نرخونه، ستاسو انوائسونه، ستاسو د تادیې چمتو کوونکی. دا هغه لاره ده چې تاسو زموږ پلاتفورم د هر هغه شي څخه چې تاسو یې لا دمخه چلوئ، اداره کوئ — د بیلینګ پینل، ستاسو خپله WordPress پاڼه، یا یو سکریپټ.

هغه څه چې ستاسو پیرودونکي یې په حقیقت کې وویني

د کاري میکانیزمونو څخه مخکې: ستاسو پیرودونکي اړتیا نلري چې هیڅکله موږ وویني. درې سطحې دي، او تاسو خپله ټاکئ چې کومه یوه کاروئ.

| سطحه | د چا ده | |---|---| | د کوربه توب پینل، ستاسو په خپل هوسټ نوم (hostname) باندې | د Reselling → Your brand لاندې د پینل هوسټ نوم وټاکئ او ستاسو پیرودونکي په panel.yourcompany.com کې ستاسو د لوگو او رنګونو سره ننوځي. همدغه پینل دی، خو ستاسو پته ده. | | ستاسو خپله ویب پاڼه | د WordPress پلگ ان ستاسو په پاڼه کې د ډومین لټون او په یوه کلیک سره د ننوتلو لینک ځای په ځای کوي، او امر ستاسو د خپل WooCommerce چیک آوټ له لارې ترسره کوي. | | ستاسو د بیلینګ پینل | WHMCS یا HostBill د مخکینۍ دروازې په توګه پاتې کیږي؛ ماډل د هغې تر شا خدمت فعالوي او د پیرودونکي ساحې تڼۍ دوی مستقیم د دوی کوربه توب ته ننه باسي. |

⛔ هر هغه څه چې تاسو یې وټاکئ، تاسو د خپلو پیرودونکو لپاره د ریکارډ سوداګر یاست: ستاسو نرخونه، ستاسو انوائسونه، ستاسو د VAT شمېره، ستاسو د تادیې چمتو کوونکی. موږ په میاشت کې یو ځل، په عمده پلور نرخ کې، تاسو ته بل درلیږو.

یوځل چې تاسو د پینل هوسټ نوم وټاکئ، هغه د WordPress پلگ ان د Panel address په ساحه کې دننه کړئ او په بل هیڅ شی کې نه — د ننوتلو هغه لینکونه چې دا API یې جوړوي په اتوماتيک ډول ورپسې ځي.

د ننوتلو څلور لارې

د ننوتلو څلور لارې شتون لري، او د دوی لاندې ټول یو شان کار کوي:

| | د دې لپاره | |---|---| | د WHMCS ماډل | یو WHMCS دوکان | | د HostBill ماډل | یو HostBill دوکان | | د WordPress پلگ ان | ستاسو له خپل WordPress یا WooCommerce سایټ څخه پلورل | | د API | بل هر څه — Blesta، یو کورنی سیسټم، یا یو کرون سکریپټ |

۱. د API کلي ترلاسه کړئ

خپل ډشبورډ ته لاړ شئ، API keys ته ورشئ او یوه جوړه کړئ. دې ته یوازې هغه څه ورکړئ چې ورته اړتیا لري:

| اجازه (Permission) | ولې | |---|---| | org.read | ستاسو د پیرودونکو اکاونټونه ولولئ | | sites.create | یو سایټ برابر کړئ | | sites.view | یو خدمت ولولئ | | sites.delete | پای ته ورسوئ | | reseller.view | خپل خدمتونه لست کړئ او کارونه یې ولولئ | | reseller.provision | پیرودونکی وځلوئ، خوشې یې کړئ، او په سیسټم کې یې دننه کړئ |

⛔ د ادغام (integration) کومې برخې ته reseller.manage مه ورکوئ. دا اجازه ستاسو د نرخونو لیست او ستاسو د تادیې ګیټ وے شواهد (credentials) سموي. reseller.provision په دقیق ډول د دې لپاره شتون لري ترڅو هغه کلي چې تاسو یې په بیلینګ پینل یا ویب پاڼه کې پیسټ کوئ، ورته اړتیا ونلري.

کلي یوازې یو ځل ښودل کیږي. هغه په هغه ځای کې وساتئ چیرې چې تاسو خپل نور شواهد ساتئ — هیڅکله په داسې فایل کې نه چې ستاسو د ویب سرور لخوا وړاندې کیږي.

۲. خپله لومړۍ اړیکه (call) جوړه کړئ

curl https://api.zinndigital.com/v1/reseller/services \
  -H "Authorization: Bearer zdk_live_…"

دا هر هغه خدمت بیرته راګرځوي چې تاسو چمتو کړی دی، د هر سایټ لپاره یو قطار، د هغه پیرودونکي سره چې پورې اړه لري، د هغه حالت، او هغه څه چې تاسو د هغې لپاره چارج کوئ. په نوي اکاونټ کې دا یو خالي لست دی — کوم چې سم ځواب دی، نه تېروتنه.

۳. ټول ادغام، په شپږو اړیکو کې

کله چې (WHEN)                  اړیکه (CALL)
یو امر تادیه کیږي               POST   /v1/orgs                                   د هر پیرودونکي لپاره یو ځل
                                POST   /v1/sites                                  د هر خدمت لپاره یو ځل
هغوی تادیه نه ده کړې           POST   /v1/reseller/services/{siteId}/suspend
هغوی تادیه کوي                 POST   /v1/reseller/services/{siteId}/unsuspend
هغوی لغوه کوي                  DELETE /v1/sites/{siteId}
"کوربه توب ته ننوتل"             POST   /v1/reseller/services/{siteId}/sso

چمتو کول (Provisioning) دوه اړیکې دي، او کلي مهمې دي:

# 1. د پیرودونکي اکاونټ — ستاسو د پیرودونکي شناخت (ID) پورې تړلی
curl -X POST https://api.zinndigital.com/v1/orgs \
  -H "Authorization: Bearer zdk_live_…" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: account-4211" \
  -d '{"type":"customer","name":"Acme Ltd"}'

# 2. د هغوی سایټ — ستاسو د خدمت شناخت (ID) پورې تړلی
curl -X POST https://api.zinndigital.com/v1/sites \
  -H "Authorization: Bearer zdk_live_…" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: service-9915" \
  -d '{"org_id":"<from step 1>","product_line":"mainstream","primary_domain":"acme.com"}'

دوه اصول چې کله یې غلط کړئ پیسې لګوي

  1. اکاونټ د خپل پیرودونکي (CUSTOMER) په واسطه او سایټ د خپل خدمت (SERVICE) په واسطه ونښلوئ. د یو پیرودونکي دوهم امر باید په هغه اکاونټ کې ولویږي چې دوی یې دمخه لري. دواړه په خدمت پورې وتړئ او یو پیرودونکی به په دریو جلا اکاونټونو او دریو جلا پینلونو پای ته ورسیږي.
  2. په هر POST کې یو Idempotency-Key واستوئ، چې د دې شی لپاره ستاسو له خپل شناخت څخه جوړ شوی وي. د بیلینګ هر سیسټم بیا هڅه کوي — د ګیټ وے کیلا بیک (callback) دوه ځله راځي، یو مدیر پاتې شوی چمتووالی بیا پرمخ وړي، یو پیرودونکی دوه ځله کلیک کوي. د کلي پرته دوهم هڅه دوهم سایټ رامینځته کوي او تاسو ته د دې لپاره بل درکړل کیږي.

درې ځوابونه چې تاسو یې باید په دوو کې راکم نه کړئ

  • unsuspend کولی شي 409 ځواب ورکړي. د دې مانا دا ده چې زموږ د ناوړه ګټې اخیستنې ټیم سایټ ساتلی دی، نه تاسو. پیغام وښودئ؛ بیا هڅه مه کوئ.
  • **پای ته رسول د حذف کولو مهالویش ټاکي، دا یو نه ترسره کوي.** نیټه د pending_deletion_at په توګه بیرته راځي. پیرودونکي ته ویل چې د دوی ډیټا دمخه تللې ده پداسې حال کې چې داسې نه ده، د هیڅ نه ویلو څخه بدتر دی.
  • disk_used_bytes کولی شي null وي، او null صفر نه دی. د دې مانا دا ده چې موږ نشو کولی اندازه کړو، نه دا چې هیڅ ونه کارول شو. له پامه یې وغورځوئ — په خپلو ریکارډونو کې 0 مه لیکئ، یا تاسو به پیرودونکي ته د یو سایټ لپاره چې تاسو یې کوم لوستنه نلرئ، شنه کارونې بار (usage bar) وښایئ.

۴. یو پیرودونکی دننه کړئ

POST /v1/reseller/services/{siteId}/sso یو ځل کارېدونکی URL بیرته راګرځوي چې ستاسو پیرودونکی مستقیم د دوی په خپل اکاونټ کې اچوي، پداسې حال کې چې دمخه ننوتلی وي.

⛔ کله چې دوی کلیک وکړي، هغه مه جوړوئ، هیڅکله هغه مه جوړوئ کله چې تاسو پاڼه جوړوئ. لینک یو ځل کارېدونکی دی او په څو دقیقو کې پای ته رسیږي، نو په یوه پاڼه کې لیکل شوی لینک د لومړۍ پاڼې لید پرمهال سوځول کیږي او ستاسو او براوزر ترمنځ په هر کیش (cache) کې پاتې کیږي.

۵. پرځای یې یو ماډل نصب کړئ

  • WHMCS — ماډل modules/servers/zinn/ ته کاپي کړئ، یو سرور اضافه کړئ چې Password یې ستاسو د API کلي ده، او د محصول په اړه د محصول کرښه (product line) وټاکئ. په Test Connection کښیکاږئ: دا یو ریښتینی کال کوي او تاسو ته وایی چې پلاتفورم څه وویل.
  • HostBill — includes/modules/Hosting/zinn/ ته کاپي کړئ او په همدې لاره یې ونښلوئ.
  • WordPress — د Zinn® Reseller Toolkit: د ډومین لټون، ستاسو د پیرودونکو کوربه توب ته د ننوتلو لینک، او د WooCommerce چمتو کول کله چې یو امر تادیه کیږي. خلاص سرچینه په <https://github.com/Zinn-Digital/zinn-reseller-toolkit> کې ده، یا یې په خپل ډشبورډ کې له Plugins څخه ډاونلوډ کړئ.

۶. ژوندی شئ (Go live)

مخکې لدې چې تاسو ریښتینی امر واخلئ دا وګورئ:

  • د پیوستون ازموینه په ماډل کې تیریږي، یا ستاسو لومړی curl یو لست بیرته راګرځوي.
  • ستاسو د نرخونو لیست ټاکل شوی دی (Reselling → Your prices).
  • ستاسو د تادیې ګیټ وے وصل دی (Reselling → Payment gateways) — ستاسو پیرودونکي تاسو ته ستاسو د خپل اکاونټ له لارې پیسې درکوي.
  • ستاسو د شرکت توضیحات دننه شوي دي (Reselling → Your company) ترڅو ستاسو د پیرودونکي انوائسونه ستاسو حقوقي شخصیت او د VAT شمېره ولري، نه زموږ.
  • تاسو یو ریښتینی امر له پیل تر پایه ځای په ځای کړی دی او لیدلی مو دي چې سایټ څرګند شو.

چیرته چې نور هرڅ بشپړ دی

د بشپړ API حواله (reference) — هر پای ټکی (endpoint)، زموږ د ځانګړتیاوو څخه تولید شوی، د هغه اجازې سره چې هر یو یې ورته اړتیا لري، په <https://zinndigital.com/developers/api> کې دی.

لا هم بې ځایه شوي یاست؟

ملاتړ په هر پلان کې شامل دی او ځوابونه ستاسو په خپله ژبه دي.

ملاتړ سره اړیکه ونیسئ → ټولې مقالې →

موږ د تحلیلي کوکیز څخه کار اخلو ترڅو پوه شو چې سایټ څنګه کارول کیږي. دا یوازې هغه وخت تنظیم کیږي چې تاسو یې ومنئ. د کوکی تګلاره