teభాష
ఉచితంగా ప్రారంభించండి
లాగిన్ చేయండిఉచితంగా ప్రారంభించండి

జ్ఞాన స్థావరం

మీ స్వంత సిస్టమ్‌ల నుండి Zinn® హోస్టింగ్ విక్రయించడం

మీ స్వంత బిల్లింగ్ ప్యానెల్, WordPress సైట్ లేదా స్క్రిప్ట్‌ల నుండి Zinn హోస్టింగ్ ని నియంత్రించండి: API కీని పొందండి, మీ మొదటి కాల్‌ను చేయండి మరియు పూర్తి ఇంటిగ్రేషన్ ఆధారపడి ఉండే ఆరు కాల్‌లను పూర్తి చేయండి.

మీరు మా హోస్టింగ్‌ను రీసెల్ చేయవచ్చు. మీ క్లయింట్‌లు మీ సొంతం: మీ ధరలు, మీ ఇన్‌వాయిస్‌లు, మీ పేమెంట్ ప్రొవైడర్. మీరు ఇప్పటికే రన్ చేస్తున్న దేని నుండి అయినా — ఒక బిల్లింగ్ ప్యానెల్, మీ సొంత WordPress సైట్ లేదా స్క్రిప్ట్ నుండి — మా ప్లాట్‌ఫామ్‌ను ఈ విధంగానే నడపవచ్చు.

మీ క్లయింట్‌లు నిజంగా ఏమి చూస్తారు

సాంకేతిక వివరాల కంటే ముందు: మీ క్లయింట్‌లు మమ్మల్ని ఎప్పుడూ చూడాల్సిన అవసరం లేదు. మూడు సాధనాలు ఉన్నాయి, వీటిలో మీరు దేనిని ఉపయోగించాలో మీరే ఎంచుకోవచ్చు.

| సాధనం | అది ఎవరిది | |---|---| | మీ సొంత హోస్ట్‌నేమ్‌పై హోస్టింగ్ ప్యానెల్ | Reselling → Your brand కింద ఒక ప్యానెల్ హోస్ట్‌నేమ్‌ను సెట్ చేయండి, దాంతో మీ క్లయింట్‌లు మీ లోగో మరియు మీ రంగులతో panel.yourcompany.com వద్ద సైన్ ఇన్ చేస్తారు. అదే ప్యానెల్, మీ అడ్రస్. | | మీ సొంత వెబ్‌సైట్ | WordPress ప్లగిన్ మీ సైట్‌లో డొమైన్ శోధన మరియు వన్-క్లిక్ సైన్-ఇన్ లింక్‌ను ఉంచుతుంది, మరియు మీ సొంత WooCommerce చెక్‌అవుట్ ద్వారా ఆర్డర్‌ను తీసుకుంటుంది. | | మీ బిల్లింగ్ ప్యానెల్ | WHMCS లేదా HostBill మెయిన్ ఎంట్రీగా ఉంటుంది; మాడ్యూల్ దాని వెనుక సేవలందిస్తుంది మరియు క్లయింట్-ఏరియా బటన్ వారిని నేరుగా వారి హోస్టింగ్‌లోకి సైన్ ఇన్ చేస్తుంది. |

⛔ మీరు దేనిని ఎంచుకున్నప్పటికీ, మీ క్లయింట్‌లకు మీరే మర్చంట్ ఆఫ్ రికార్డ్: మీ ధరలు, మీ ఇన్‌వాయిస్‌లు, మీ VAT నంబర్, మీ పేమెంట్ ప్రొవైడర్. మేము ప్రతినెల ఒకసారి హోల్‌సేల్ ధరకు మీకు బిల్ చేస్తాము.

మీరు ప్యానెల్ హోస్ట్‌నేమ్‌ను సెట్ చేసిన తర్వాత, దానిని WordPress ప్లగిన్‌లోని Panel address ఫీల్డ్‌లో మాత్రమే ఉంచండి — ఈ API ద్వారా రూపొందే సైన్-ఇన్ లింక్‌లు ఆటోమేటిక్‌గా దానినే అనుసరిస్తాయి.

లోపలికి వెళ్లే నాలుగు మార్గాలు

లోపలికి వెళ్లడానికి నాలుగు మార్గాలు ఉన్నాయి, మరియు అవన్నీ లోపల ఒకే రకమైన పనిని చేస్తాయి:

| | ఎవరి కోసం | |---|---| | WHMCS మాడ్యూల్ | WHMCS షాప్ కోసం | | HostBill మాడ్యూల్ | HostBill షాప్ కోసం | | WordPress ప్లగిన్ | మీ సొంత WordPress లేదా WooCommerce సైట్ నుండి విక్రయించడానికి | | API | మరేదైనా — Blesta, ఒక ఇన్-హౌస్ సిస్టమ్, ఒక క్రోన్ స్క్రిప్ట్ |

1. API కీని పొందండి

మీ డాష్‌బోర్డ్‌లో, API keys కి వెళ్ళి ఒకదాన్ని క్రియేట్ చేయండి. దానికి అవసరమైన వాటిని మాత్రమే ఇవ్వండి:

| పర్మిషన్ | ఎందుకు | |---|---| | org.read | మీ క్లయింట్ ఖాతాలను చదవడానికి | | sites.create | ఒక సైట్‌ను ప్రావిజన్ చేయడానికి | | sites.view | ఒక సర్వీస్‌ను చదవడానికి | | sites.delete | టెర్మినేట్ చేయడానికి | | reseller.view | మీ సర్వీస్‌ల జాబితాను చూడటానికి మరియు వినియోగాన్ని చదవడానికి | | reseller.provision | సస్పెండ్ చేయడానికి, రిలీజ్ చేయడానికి మరియు క్లయింట్‌ను సైన్ ఇన్ చేయడానికి |

⛔ ఏ ఇంటిగ్రేషన్‌కూ reseller.manage పర్మిషన్ ఇవ్వవద్దు. ఆ పర్మిషన్ మీ ధరల జాబితాను మరియు మీ సొంత పేమెంట్-గేట్‌వే వివరాలను ఎడిట్ చేస్తుంది. మీరు బిల్లింగ్ ప్యానెల్ లేదా వెబ్‌సైట్‌లో పేస్ట్ చేసే కీకి ఈ పర్మిషన్ అవసరం లేకుండా ఉండటానికే reseller.provision ప్రత్యేకంగా ఉంది.

ఈ కీ ఒకసారి మాత్రమే కనిపిస్తుంది. మీరు మీ ఇతర లాగిన్ వివరాలను ఎక్కడ భద్రపరుస్తారో అక్కడే దీనిని భద్రపరచండి — మీ వెబ్ సర్వర్ అందించే ఫైల్‌లో ఎప్పుడూ ఉంచవద్దు.

2. మీ మొదటి కాల్ చేయండి

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

అది మీరు ప్రావిజన్ చేసిన ప్రతి సర్వీస్‌ను (ప్రతి సైట్‌కు ఒక వరుస చొప్పున), అది చెందిన క్లయింట్, దాని స్టేటస్ మరియు మీరు దానికి ఛార్జ్ చేసే ధరతో సహా తిరిగి ఇస్తుంది. కొత్త ఖాతాలో ఇది ఖాళీ జాబితాగా ఉంటుంది — అది సరైన సమాధానమే గానీ, ఎర్రర్ కాదు.

3. ఆరు కాల్స్‌లో మొత్తం ఇంటిగ్రేషన్

ఎప్పుడు                 కాల్
ఆర్డర్ పూర్తయినప్పుడు     POST   /v1/orgs                                   CUSTOMERS ఒక్కొక్కరికి ఒకసారి
                     POST   /v1/sites                                  SERVICES ఒక్కొక్కరికి ఒకసారి
వారు పేమెంట్ చేయనప్పుడు  POST   /v1/reseller/services/{siteId}/suspend
వారు పేమెంట్ చేసినప్పుడు POST   /v1/reseller/services/{siteId}/unsuspend
వారు రద్దు చేసినప్పుడు    DELETE /v1/sites/{siteId}
"హోస్టింగ్‌లోకి లాగిన్ అవ్వండి"  POST   /v1/reseller/services/{siteId}/sso

ప్రావిజనింగ్ అనేది రెండు కాల్స్, మరియు కీల పాత్ర కీలకం:

# 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. ఖాతాను మీ కస్టమర్ ID పై మరియు సైట్‌ను మీ సర్వీస్ ID పై సెట్ చేయండి. ఒక కస్టమర్ యొక్క రెండవ ఆర్డర్ వారికి ఇప్పటికే ఉన్న ఖాతాలోనే చేరాలి. రెండింటినీ సర్వీస్ ID పై సెట్ చేస్తే, ఒకే కస్టమర్‌కు ఎటువంటి సంబంధం లేని మూడు ఖాతాలు మరియు మూడు వేర్వేరు ప్యానెల్‌లు ఏర్పడతాయి.
  2. ప్రతి POST పై ఆ వస్తువు కోసం మీ సొంత ID నుండి తయారు చేసిన Idempotency-Key ను పంపండి. ప్రతి బిల్లింగ్ సిస్టమ్ మళ్లీ ప్రయత్నిస్తుంది — ఒక గేట్‌వే కాల్‌బ్యాక్ రెండుసార్లు రావచ్చు, అడ్మిన్ విఫలమైన ప్రావిజన్‌ను మళ్లీ రన్ చేయవచ్చు, లేదా కస్టమర్ రెండుసార్లు క్లిక్ చేయవచ్చు. కీ లేకపోతే రెండవ ప్రయత్నంలో రెండవ సైట్ క్రియేట్ అవుతుంది మరియు దానికి మీకు బిల్లు పడుతుంది.

మీరు రెండింటిగా కుదించకూడని మూడు సమాధానాలు

  • unsuspend అనేది 409 ను సమాధానంగా ఇవ్వవచ్చు. అంటే మా అబ్యూస్ టీమ్ ఆ సైట్‌ను హోల్డ్‌లో ఉంచిందని అర్థం, మీరు కాదు. ఆ సందేశాన్ని చూపించండి; మళ్లీ ప్రయత్నించవద్దు.
  • **టెర్మినేటింగ్ అనేది తొలగింపును షెడ్యూల్ చేస్తుంది, అది వెంటనే తొలగించదు.** ఆ తేదీ pending_deletion_at గా తిరిగి వస్తుంది. కస్టమర్‌కు వారి డేటా ఇంకా ఉన్నప్పుడు, అది అప్పుడే పోయిందని చెప్పడం ఏమీ చెప్పకపోవడం కంటే అధ్వాన్నంగా ఉంటుంది.
  • disk_used_bytes అనేది null కావచ్చు, మరియు null అంటే సున్నా కాదు. మేము దాన్ని కొలవలేకపోయామని దానర్థం, ఏమీ ఉపయోగించలేదని కాదు. దాన్ని వదిలేయండి — మీ సొంత రికార్డులలో 0 అని రాయకండి, లేకపోతే మీరు రీడింగ్ తీసుకోని సైట్ కోసం కస్టమర్‌కు గ్రీన్ యూసేజ్ బార్‌ను చూపుతారు.

4. క్లయింట్‌ను సైన్ ఇన్ చేయండి

POST /v1/reseller/services/{siteId}/sso అనేది మీ క్లయింట్‌ను ఇప్పటికే సైన్ ఇన్ అయి ఉన్న వారి సొంత ఖాతాలోకి నేరుగా తీసుకెళ్లే ఒక సింగిల్-యూజ్ URLని ఇస్తుంది.

⛔ వారు క్లిక్ చేసినప్పుడు మాత్రమే దాన్ని సృష్టించండి, మీరు పేజీని రెండర్ చేసినప్పుడు ఎప్పుడూ చేయవద్దు. ఈ లింక్ ఒక్కసారి మాత్రమే ఉపయోగించగలరు మరియు నిమిషాల వ్యవధిలోనే గడువు ముగుస్తుంది, కాబట్టి పేజీలో రాసిన లింక్ మొదటి పేజీ వీక్షణలోనే వ్యర్థమవుతుంది మరియు మీకు అలాగే బ్రౌజర్‌కు మధ్య ఉన్న ప్రతి క్యాషేలో ఉండిపోతుంది.

5. దానికి బదులుగా ఒక మాడ్యూల్‌ను ఇన్‌స్టాల్ చేయండి

  • WHMCS — మాడ్యూల్‌ను modules/servers/zinn/ కి కాపీ చేసి, దాని Password మీ API కీగా ఉండే ఒక సర్వర్‌ను జోడించి, ప్రొడక్ట్‌పై ప్రొడక్ట్ లైన్‌ను సెట్ చేయండి. Test Connection నొక్కండి: ఇది నిజమైన కాల్ చేసి, ప్లాట్‌ఫామ్ ఏమి చెప్పిందో మీకు తెలియజేస్తుంది.
  • HostBill — includes/modules/Hosting/zinn/ కి కాపీ చేసి, దాన్ని కూడా అదే విధంగా కనెక్ట్ చేయండి.
  • WordPress — Zinn® Reseller Toolkit: డొమైన్ శోధన, మీ క్లయింట్‌ల హోస్టింగ్‌లోకి సైన్-ఇన్ లింక్, మరియు ఆర్డర్ చెల్లించినప్పుడు WooCommerce ప్రావిజనింగ్. <https://github.com/Zinn-Digital/zinn-reseller-toolkit> వద్ద ఓపెన్ సోర్స్ గా ఉంది, లేదా మీ డాష్‌బోర్డ్‌లోని Plugins నుండి డౌన్‌లోడ్ చేసుకోండి.

6. లైవ్ చేయండి

మీరు నిజమైన ఆర్డర్ తీసుకునే ముందు వీటిని తనిఖీ చేయండి:

  • మాడ్యూల్‌పై కనెక్షన్ టెస్ట్ పాస్ అవ్వాలి, లేదా మీ మొదటి curl ఒక జాబితాను ఇవ్వాలి.
  • మీ ధరల జాబితా సెట్ చేయబడి ఉండాలి (Reselling → Your prices).
  • మీ పేమెంట్ గేట్‌వే కనెక్ట్ చేయబడి ఉండాలి (Reselling → Payment gateways) — మీ క్లయింట్‌లు మీ సొంత ఖాతా ద్వారా మీకు చెల్లిస్తారు.
  • మీ కంపెనీ వివరాలు ఉంచాలి (Reselling → Your company), తద్వారా మీ క్లయింట్ ఇన్‌వాయిస్‌లలో మా వివరాలు కాకుండా మీ లీగల్ ఎంటిటీ మరియు VAT నంబర్ ఉంటాయి.
  • మీరు ప్రారంభం నుండి ముగింపు వరకు ఒక నిజమైన ఆర్డర్‌ను ఉంచి, సైట్ కనిపించడాన్ని గమనించాలి.

మిగిలిన వివరాలన్నీ ఎక్కడ ఉన్నాయి

పూర్తి API రిఫరెన్స్ — మా స్పెసిఫికేషన్ నుండి రూపొందించబడిన ప్రతి ఎండ్‌పాయింట్, దానికి కావలసిన పర్మిషన్‌తో సహా — <https://zinndigital.com/developers/api> వద్ద ఉంది.

ఇంకా ఇబ్బందిగా ఉందా?

ప్రతి ప్లాన్‌లోనూ మద్దతు మరియు మీ స్వంత భాషలో సమాధానాలు చేర్చబడ్డాయి.

మద్దతును సంప్రదించండి → అన్ని కథనాలు →

సైట్ ఎలా ఉపయోగించబడుతుందో అర్థం చేసుకోవడానికి మేము అనలిటిక్స్ కూకీలను ఉపయోగిస్తాము. మీరు అంగీకరిస్తేనే ఇవి సెట్ చేయబడతాయి. కుకీ పాలసీ

మీ స్వంత సిస్టమ్‌ల నుండి Zinn® హోస్టింగ్ విక్రయించడం