ستاسو له خپلو سیسټمونو څخه د Zinn® کوربه توب پلورل

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

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

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

⛔ کوم یو چې هم غوره کړئ، تاسو د خپلو پېرودونکو لپاره رسمي پلورونکی (merchant of record) یاست: ستاسو بیې، ستاسو انوایسونه، ستاسو د VAT شمېره، ستاسو د تادیې چمتوکوونکی. موږ په میاشت کې یو ځل، په عمده بیه، تاسو ته بِل درلېږو.

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

څلور لارې

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

۱. یو د API کيلۍ (key) ترلاسه کړئ

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

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

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

۲. خپله لومړۍ زنګ‌وهنه (call) ترسره کړئ

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

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

۳. بشپړ ادغام، په شپږو زنګونو (calls) کې

کله                 زنګ (CALL)
یو فرمایش تادیه شي  POST   /v1/orgs                                   د هر CUSTOMER لپاره یو ځل
                    POST   /v1/sites                                  د هر SERVICE لپاره یو ځل
تادیه یې نه وي کړې POST   /v1/reseller/services/{siteId}/suspend
تادیه وکړي         POST   /v1/reseller/services/{siteId}/unsuspend
لغوه یې کړي         DELETE /v1/sites/{siteId}
"کوربه‌توب ته ننوتل" POST   /v1/reseller/services/{siteId}/sso

چمتو کول دوه زنګونه دي، او کيلۍ مهمې دي:

# ۱. د پېرودونکي حساب — ستاسو د پیرودونکي په پېژندپاڼه (CUSTOMER 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"}'

# ۲. د هغوی سایټ — ستاسو د خدمت په پېژندپاڼه (SERVICE 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"}'

دوه قواعد چې که غلط یې کړئ پیسې پرې اوړي

۱. حساب د خپل CUSTOMER پر بنسټ او سایټ د خپل SERVICE پر بنسټ جوړ کړئ. د پېرودونکي دویم فرمایش باید په هغه حساب کې اضافه شي چې دوی یې دمخه لري. که دواړه په خدمت پورې وتړئ، نو یو پېرودونکی به له دریو بې‌ارتباطه حسابونو او دریو جلا پینلونو سره مخ شي. ۲. په هر POST باندې یو Idempotency-Key واستوئ، چې د همدې توکي لپاره ستاسو د خپلې پېژندپاڼې څخه جوړ شوی وي. د بلینګ هر سیسټم بیا هڅه کوي — د ګېټ‌وی یو بېرته زنګ وهل (callback) دوه ځله راځي، یو اډمین ناکامه چمتو کول بیا پرمخ بیايي، یو پېرودونکی دوه ځله کلیک کوي. پرته له دې کيلۍ، دویمه هڅه یو دویم سایټ جوړوي او بِل یې تاسو ته راځي.

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

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

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

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 له لارې چمتو کول. خلاص سرچینه (Open source) په <https://github.com/Zinn-Digital/zinn-reseller-toolkit> کې شته، یا یې په خپل ډېشبورډ کې له Plugins څخه ډانلوډ کړئ.

۶. فعال او ژوندۍ بڼې ته لاړ شئ

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

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

نور ټول شیان چېرې دي

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