HostBill, Blesta හෝ ඔබේම පද්ධතිය හරහා Zinn® හොස්ටිං අලෙවි කරන්න

ඔබ WHMCS ධාවනය කරන්නේ නම්, ඒ වෙනුවට WHMCS මොඩියුලය භාවිතා කරන්න — මෙම පිටුව අනෙක් සියල්ල සඳහා වේ. විකල්ප දෙකක් ඇත, දෙකම නොමිලේ වන අතර දෙකම GPL-2.0-or-later වේ.

HostBill

WHMCS මොඩියුලයට සමාන ක්‍රියා හයකින් සමන්විත හෝස්ටිං මොඩියුලයකි.

1. එය බාගත කර unzip කරන්න.
2. ගොනු includes/modules/Hosting/zinn/class.zinn.php සහ includes/modules/Hosting/zinn/ZinnHostBillClient.php වෙත ලැබෙන සේ zinn ඩිරෙක්ටරිය includes/modules/Hosting/ තුළට උඩුගත කරන්න.
3. Settings → Modules → Hosting වෙත ගොස්, Zinn Digital® සක්‍රිය කර සම්බන්ධතාවයක් එක් කරන්න:

• API address: https://api.zinndigital.com
• API key: ඔබේ Zinn® API යතුර (password ක්ෂේත්‍රයකි, එබැවින් HostBill එය සංකේතනය කර ගබඩා කරයි)

1. නිෂ්පාදනය මත Product line (උදා. mainstream), Stack (පෙරනිමියෙන් wordpress), සහ විකල්ප වශයෙන් Application සහ PHP version සකසන්න.
2. Test connection ඔබන්න.

⛔ zinn ඩිරෙක්ටරියේ නම වෙනස් නොකරන්න. HostBill හි ලෝඩරය එය සොයන පන්තිය ඩිරෙක්ටරි නාමයෙන් ලබා ගනී, එබැවින් නම වෙනස් කිරීමෙන් පැනලය ලැයිස්තුගත කරන නමුත් කිසි විටෙකත් ක්‍රියාත්මක නොකරන මොඩියුලයක් නිර්මාණය වේ.

අනෙක් ඕනෑම දෙයක් — PHP ක්ලයන්ට්

තනි ගොනුවකි, පරායත්තතා නැත, පැනල් උපකල්පන නැත. ඔබේම කේත පදනමට ZinnProvisioning.php ඇතුළත් කර ක්‍රම හයක් ක්‍රියාත්මක කරන්න.

require_once 'ZinnProvisioning.php';

$zinn = new ZinnProvisioning(getenv('ZINN_API_KEY'));

// When an order is paid — once per CUSTOMER, then once per SERVICE:
$orgId  = $zinn->account('customer-4211', 'Acme Ltd');
siteId = $zinn->provision('service-9915', $orgId, 'acme.com', 'mainstream', 'wordpress');
// Store $orgId against your customer and $siteId against your service.

$zinn->suspend($siteId, 'INV-2026-114 unpaid');   // an invoice goes unpaid
$zinn->unsuspend($siteId);                        // they pay
$zinn->terminate($siteId);                        // they cancel — schedules a deletion

// When they click "log in to my hosting" — mint it on the CLICK, never on page render:
header('Location: ' . $zinn->signInLink($siteId));

PHP ලියන්නේ නැද්ද? එම ඇමතුම් API විමර්ශනයෙහි අඩංගු වන අතර ඔබට ඕනෑම දෙයකින් ඒවා සිදු කළ හැක.

API යතුර

අවසර හතක් පමණි, ඊට වඩා නැත: org.create, org.read, sites.create, sites.view, sites.delete, reseller.view, reseller.provision.

⛔ reseller.manage නොවේ. බිල්පත් පැනලයකට ඔබ ඇතුළත් කරන යතුරකට මුදල් නොගෙවීම හේතුවෙන් සේවාලාභියෙකු අත්හිටුවීමට සහ ඔවුන්ව පුරනය කිරීමට හැකි විය යුතුය; එයට ඔබේම ගෙවීම් ද්වාර අක්තපත්‍ර නැවත ලිවීමට නොහැකි විය යුතුය.

කඩ කළ විට මුදල් අහිමි වන නීති දෙක

1. ගිණුම ඔබේ CUSTOMER මතද, අඩවිය ඔබේ SERVICE මතද යොමු කරන්න. පාරිභෝගිකයෙකුගේ දෙවන ඇණවුම ඔවුන් සතුව දැනටමත් ඇති ගිණුමට ලැබිය යුතුය. දෙකම සේවාව මත යොමු කළහොත් එක් පාරිභෝගිකයෙකුට අසම්බන්ධිත ගිණුම් තුනක් සහ වෙනම පාලක පැනල තුනක් ලැබේ.
2. අදාළ අයිතමය සඳහා ඔබේම id එකෙන් ලබාගත් idempotency යතුරක් සෑම සෑදීමකදීම යවන්න. සෑම බිල්පත් පද්ධතියක්ම නැවත උත්සාහ කරයි — ද්වාර කෝල්බැක් එකක් දෙවරක් පැමිණේ, පරිපාලකයෙකු අසාර්ථක වූ සැපයීමක් නැවත ක්‍රියාත්මක කරයි, පාරිභෝගිකයෙකු දෙවරක් ක්ලික් කරයි. එය නොමැතිව දෙවන උත්සාහය දෙවන අඩවියක් සාදන අතර ඒ සඳහා ඔබෙන් මුදල් අය කෙරේ. මොඩියුල දෙකම සහ PHP ක්ලයන්ට් මෙය ඔබ වෙනුවෙන් සිදු කරයි; ඔබ API සෘජුවම අමතන්නේ නම්, Idempotency-Key යවන්න.

අතහැර දැමීමට පහසු ක්ෂේත්‍ර තුනක්

සෑම එකක්ම සම්පූර්ණ ක්‍රියාපදයක් බිඳ දමයි, සහ කිසිවක් වලංගුකරණ දෝෂයක් ලෙස මිස නොපෙන්වයි — පළමුවැන්න හැර, එය කිසිවක් නොවන ලෙස පෙන්වයි:

• ⛔⛔ සේවාලාභියෙකුගේ පළමු අඩවිය සැපයීමට පෙර ඔවුන් සැලැස්මකට ඇතුළත් කළ යුතුය, ඒ සඳහා POST /v1/reseller/clients/{orgId}/plan භාවිතා කර, එහි subscription_id අගය POST /v1/sites වෙත යැවිය යුතුය. කියවීමට දෝෂයක් නොමැති අවස්ථාව මෙයයි. නව සේවාලාභී ගිණුමක කිසිදු දායකත්වයක් නොමැති අතර POST /v1/sites හි කිසිදු සැලසුම් ක්ෂේත්‍රයක් නොමැත, එබැවින් එකක් නොමැතිව සපයන ලද අඩවියක් කිසිදු සැලැස්මක් රහිතව පවතී: ඔබගේ තොග ප්‍රකාශය ගොඩනැගෙන්නේ ඔබගේ සේවාලාභීන්ගේ සක්‍රීය දායකත්වයන් මත පදනම්ව බැවින්, කිසිදු අයිතමයක් එක් නොවන අතර සත්කාරකත්වය ක්‍රියාත්මක වන තාක් Zinn® ඔබට කිසිදු මුදලක් අය නොකරයි; ඔබගේ සේවාලාභියාට කිසිදු දීමනාවක් හිමි නොවන බැවින්, ඔවුන්ගේ අඩවියට කිසිදු සීමාවක් අදාළ නොවේ; තවද උත්ශ්‍රේණිගත කිරීමකින් වෙනස් කිරීමට කිසිවක් නොමැත. ඇණවුම 201 ලබා දෙයි, අඩවිය සැපයේ, සහ එය පරිපූර්ණව ක්‍රියාත්මක වේ. දෙපැත්තෙන්ම කිසිවක් මේ පිළිබඳව වාර්තා නොකරයි.

පිළිවෙල වැදගත් වේ: POST /v1/sites එය ක්‍රියාත්මක වන මොහොතේ පවතින ඕනෑම දායකත්වයක් සටහන් කර ගනී, එබැවින් පසුව සකසන ලද සැලැස්මක් පෙරදිනට බලපාන පරිදි සම්බන්ධ නොවේ.

• POST /v1/sites සඳහා stack_type අවශ්‍ය වේ. එය මඟ හරින්න, එවිට කිසිදු ඇණවුමක් සාර්ථක විය නොහැක.
• DELETE /v1/sites/{siteId} සඳහා {"confirm_domain": "<the site's own domain>"} බඳක් අවශ්‍ය වේ — ටයිප් කළ තහවුරු කිරීමක්, මන්ද මෙය විනාශකාරී ක්‍රියා පදයයි. එය මඟ හරින්න, එවිට කිසිදු අවලංගු කිරීමක් සාර්ථක විය නොහැක, එබැවින් සේවාව අඛණ්ඩව ක්‍රියාත්මක වන අතර ඔබෙන් ඒ සඳහා දිගටම අය කෙරේ. ඔබගේම වාර්තාව භාවිතා කරනවාට වඩා GET /v1/reseller/services/{siteId} වෙතින් වසම ආපසු කියවන්න: එය සංසන්දනය කරනු ලබන්නේ අඩවියේ ප්‍රාථමික වසම සමඟ මිස කිසි විටෙක අන්වර්ථ නාමයක් සමඟ නොවේ.

වාක්‍යය පමණක් නොව සම්පූර්ණ දෝෂයම කියවන්න

වලංගුකරණ ප්‍රතික්ෂේප කිරීමක පණිවිඩය හිතාමතාම පොදු එකකි — "The request was well-formed but failed validation." — මන්ද ක්‍රියාමාර්ග ගත හැකි අර්ධය අඩංගු වන්නේ details තුළ වන අතර, එය ක්ෂේත්‍රය සහ හේතුව නම් කරයි. මොඩියුල දෙකම සහ PHP සේවාලාභියා එය ඔබගේ පරිපාලක වෙත පෙන්වන පණිවිඩයට අමුණයි. ඔබ විසින්ම API අමතන්නේ නම්, error.details කියවන්න; සමහර ඇතුළත් කිරීම් වාක්‍යයකට වඩා හිස් අගයක් දරයි, ඔබගේ නැවත විකුණුම්කරුගේ සැලැස්මේ ඉඩ නොමැති විට max_sites: 0 ඔබ වෙත ළඟා වන්නේ එලෙසිනි.

ඔබගේ පළමු ඇණවුමට පෙර

ඔබගේ සේවාලාභීන් මිලදී ගන්නා අඩවි ඔබගේ නැවත විකුණුම්කරුගේ සැලැස්මේ අඩවි දීමනාවට එරෙහිව ගණනය කෙරේ, එබැවින් ඔබට ඉඩකඩ සහිත සැලැස්මක් අවශ්‍ය වේ. සම්බන්ධතා පරීක්ෂණයකට මෙය හඳුනාගත නොහැක — එය ඔබගේ වැඩසටහන කියවන අතර කිසිවක් සපයන්නේ නැත — එබැවින් එය තවමත් විකිණිය නොහැකි නිරෝගී ගිණුමක් වාර්තා කරයි. දීමනාවක් නොමැතිව තබන ලද ඇණවුමක් හරියටම එය පවසන පණිවිඩයක් සමඟ ප්‍රතික්ෂේප කරනු ලැබේ.

ඔබගේ බාගැනීම තහවුරු කරන්න

සංරක්ෂිත දෙකම අපගේම ධාරක නාමයෙන් TLS හරහා සපයනු ලබන අතර, කිසි විටෙකත් වෙනත් තැනකට යොමු නොකෙරේ, ඒවායේ SHA-256 පිරික්සුම් මුද්‍රා බාගැනීම් පිටුවෙහි බාගැනීම් සබැඳි අසල මුද්‍රණය කර ඇත.