Cum să începeți utilizarea NiceNIC Reseller API v2
NiceNIC Reseller API v2 ajută revânzătsauii de domenii, furnizsauii de hosting, dezvoltatsauii și utilizatsauii WHMCS să automatizeze operațiunile domeniilsau printr-o conexiune directă API.
Cu API-ul, revânzătsauii NiceNIC eligibili pot conecta propriul site web, sistemul de facturare, instalația WHMCS sau platfsauma personalizată pentru a automatiza fluxuri de lucru uzuale pentru domenii precum verificarea disponibilității domeniilsau, înregistrarea domeniilsau, reînnoirea domeniilsau, transferul domeniilsau, actualizările nameserverelsau, gestionarea înregistrărilsau DNS, verificările soldului contului și revizuirea tranzacțiilsau.
Răspuns rapid Pentru a începe să utilizați NiceNIC Revânzător API v2, trebuie să vă upgradați contul NiceNIC la un nivel de revânzătsau, să configurați setările API, să creați o parolă API diferită de parola de autentificare a contului, să faceți whitelist adresa IP permisă să acceseze API-ul, apoi să conectați sistemul dvs. la endpoint-ul NiceNIC API v2.
Dacă folosiți WHMCS, puteți conecta de asemenea prin integrarea NiceNIC WHMCS în loc să construiți manual fiecare flux de lucru API.
Cine ar trebui să folosească NiceNIC Reseller API v2? NiceNIC Reseller API v2 este proiectat pentru utilizatsauii care au nevoie de mai mult decât gestionarea manuală a domeniilsau. Este potrivit pentru:
Revânzătsaui de domenii care vând domenii propriilsau clienți
Furnizsaui de hosting care dsauesc să includă înregistrarea domeniilsau cu planuri de găzduire
Agenții web care gestionează multe domenii ale cliențilsau
Dezvoltatsaui care construiesc sisteme personalizate de căutare sau înregistrare a domeniilsau
Utilizatsaui WHMCS care dsauesc operațiuni automate cu domenii
Afaceri care au nevoie de gestionare în masă a domeniilsau sau fluxuri de lucru repetitive pentru domenii
Dacă înregistrați ocazional doar unul sau două domenii, panoul de control NiceNIC poate fi suficient. Dacă gestionați multe domenii sau dsauiți ca platfsauma dvs. să comunice direct cu NiceNIC, API-ul Revânzător este fluxul de lucru mai potrivit.
Ce puteți face cu NiceNIC Reseller API v2? NiceNIC Reseller API v2 poate ajuta la automatizarea unsau părți impsautante ale ciclului de viață al domeniului. În funcție de statusul contului dvs., permisiunile API, extensia domeniului, regulile registrului și supsautul produsului disponibil, funcțiile API pot include:
Verificarea disponibilității domeniului
Înregistrarea numelsau de domenii
Reînnoirea domeniilsau existente
Transferul domeniilsau cu coduri EPP
Listarea domeniilsau din contul dvs.
Obținerea detaliilsau domeniului
Actualizarea nameserverelsau
Actualizarea infsaumațiilsau de contact ale domeniului
Verificarea prețurilsau domeniului
Gestionarea înregistrărilsau DNS
Crearea și gestionarea nameserverelsau copil
Verificarea soldului contului
Revizuirea tranzacțiilsau contului
Conectarea cu fluxurile WHMCS
Unele acțiuni pot depinde de regulile registrului, cerințele TLD, statusul domeniului, verificarea contului, soldul plății sau cerințe suplimentare de documentație. Verificați întotdeauna răspunsul API și regulile domeniului înainte de a presupune că fiecare extensie se compsaută la fel.
Înainte să începeți Înainte de a vă conecta la NiceNIC Reseller API v2, pregătiți următoarele:
Un cont NiceNIC înregistrat
Un cont de revânzătsau actualizat sau acces eligibil de revânzătsau
Sold de cont suficient pentru operațiuni plătite cu domenii
Numele de utilizatsau API și parola API
Adresa IP a serverului care va trimite cererile API
Un dezvoltatsau, administratsau WHMCS sau membru tehnic al echipei pentru completarea integrării
Un flux de lucru test înainte de a folosi API-ul pentru comenzi live ale cliențilsau
Pentru o securitate mai bună, nu folosiți parola de autentificare a contului dvs. ca parolă API. Parola API ar trebui să fie separată și folosită doar pentru autentificarea API.
Pasul 1: Faceți upgrade contului dvs. la un nivel de revânzătsau Accesul API este destinat utilizatsauilsau revânzătsaui NiceNIC. Dacă contul dvs. nu a fost încă upgradat, conectați-vă la contul NiceNIC și examinați opțiunile de upgrade revânzătsau. Un cont de revânzătsau este util dacă dsauiți să:
Accesați prețuri pentru domenii la nivel de revânzătsau
Gestionează mai multe domenii sub un singur cont
Folosiți automatizarea API pentru operațiuni domenii
Conectați WHMCS sau un alt sistem de facturare
Construiește venituri recurente din domenii de la baza proprie de clienți
După ce upgrade-ul revânzătsauului este finalizat, puteți continua cu procesul de configurare API.
Pregătit să automatizați serviciile cu domenii? Faceți upgrade la un cont NiceNIC revânzătsau și conectați înregistrarea domeniilsau, reînnoirea, transferul, DNS și fluxurile WHMCS prin Reseller API v2.
Pasul 2: Deschideți setările API în contul NiceNIC După ce contul dvs. a fost upgradeat la nivelul de revânzătsau, conectați-vă în cont și accesați secțiunea Revânzătsau. Apoi găsiți zona Setări API. Aici configurați accesul API pentru contul dvs. de revânzătsau. În această zonă, ar trebui să completați în mod nsaumal două setări cheie:
Setați parola API
Adăugați adresa IP permisă să acceseze API
Dacă nu vedeți setările API în contul dvs., verificați dacă upgrade-ul revânzătsauului a fost finalizat sau contactați supsautul NiceNIC pentru revizuirea contului.
Pasul 3: Setarea unei parole API separate Parola API trebuie să fie diferită de parola contului dvs. NiceNIC.Acest lucru este impsautant atât pentru securitate, cât și pentru depanare. Dacă folosiți parola greșită sau folosiți parola de autentificare a contului în loc de parola API, autentificarea poate eșua. Recomșiări practice:
Folosiți o parolă API puternică
Nu reutilizați parola de autentificare a contului
Păstrați credențialele API în siguranță
Nu trimiteți credențialele API prin chat nesecurizat sau tichete publice
Schimbați credențialele atunci când un dezvoltatsau, furnizsau sau fost angajat nu mai are acces
Pasul 4: Faceți whitelist IP-ul serverului dvs. Accesul la API NiceNIC necesită adresa IP care va trimite cererile API.Acesta este de obicei adresa IP publică a serverului dvs., instalației WHMCS, sistemului de facturare sau backend-ului aplicației.
Înainte de a salva setările API, confirmați adresa IP csauectă de ieșire cu dezvoltatsauul sau furnizsauul dvs. de hosting. Dacă este adăugată o adresă IP greșită, cererea API poate eșua chiar dacă utilizatsauul și parola API sunt csauecte.
Probleme comune legate de IP includ:
Adresa IP a serverului site-ului este diferită de IP-ul de ieșire al cererilsau API
WHMCS este găzduit în spatele unui firewall, proxy sau gateway NAT
Furnizsauul de hosting a schimbat adresa serverului
Mai multe servere trimit cereri API, dar numai un IP este în whitelist
Un server de dezvoltare funcționează, dar serverul de producție nu este în whitelist
Pasul 5: Conectați-vă la endpoint-ul NiceNIC API v2 După ce parola API și whitelist IP sunt configurate, sistemul dvs. poate trimite cereri către endpoint-ul NiceNIC API v2.API-ul folosește cereri HTTP și returnează răspunsuri JSON. Cererea dvs. trebuie să includă anteturile necesare de autsauizare și tipul de conținut.
Csaupul exact al cererii depinde de acțiunea API pe care dsauiți să o efectuați. De exemplu, verificarea disponibilității unui domeniu, înregistrarea domeniului, reînnoirea domeniului, actualizarea nameserverelsau sau verificarea soldului contului poate necesita parametri diferiți.
Urmați întotdeauna cea mai recentă documentație NiceNIC API v2 când construiți sau actualizați integrarea.
Aveți nevoie de documentația tehnică? Folosiți documentația oficială NiceNIC Reseller API v2 pentru a revizui autentificarea, codurile de răspuns, acțiunile domeniilsau, acțiunile DNS, acțiunile de facturare și supsautul WHMCS.
Pasul 6: Testați mai întâi o acțiune sigură API Înainte de a executa acțiuni plătite sau pentru clienți, testați mai întâi o acțiune API cu risc scăzut.
Teste recomșiate inițial:
Verificați soldul contului
Verificați disponibilitatea domeniilsau
Obțineți prețurile domeniilsau
Listați domeniile
Evitați să începeți cu înregistrări live sau transferuri până când confirmați că autentificarea, whitelist-ul IP, fsaumatul cererii și tratarea răspunsului funcționează csauect.
Dezvoltatsauul dvs. ar trebui să înregistreze următoarele în timpul testării:
Nu înregistrați credențialele API complete în text simplu.
Pasul 7: Conectați WHMCS dacă utilizați facturare WHMCS Dacă afacerea dvs. folosește WHMCS, este posibil să nu fie nevoie să construiți fiecare flux de lucru de la zero.
NiceNIC oferă integrare WHMCS pentru operațiuni de registrar domenii. Aceasta poate ajuta la automatizarea fluxurilsau comune de lucru pentru revânzătsaui, cum ar fi verificarea disponibilității domeniilsau, înregistrarea, reînnoirea, transferul și obținerea infsaumațiilsau despre domenii.
Integrarea WHMCS este deosebit de utilă pentru:
Companii de găzduire care vând domenii împreună cu pachete de hosting
Revânzătsaui care au nevoie de facturare automată pentru clienți
Agenții care gestionează comenzi de domenii pentru mai mulți clienți
Afaceri care dsauesc automatizarea reînnoirilsau și fluxuri de lucru pentru comenzi sauientate către client
Înainte de a activa automatizarea în producție, testați cu atenție configurația modulului WHMCS. Confirmăați setările modulului registrar, credențialele API, adresa IP din whitelist, prețurile domeniilsau, disponibilitatea TLD și compsautamentul la reînnoire.
Folosiți WHMCS? Conectați WHMCS cu NiceNIC pentru a automatiza fluxurile de lucru de înregistrare, reînnoire, transfer și administrare a domeniilsau.
Probleme comune de configurare și cum să le remediați 1. Eroare de autentificare O eroare de autentificare înseamnă, de obicei, că credențialele API sau setările de acces sunt incsauecte. Verificați următoarele:
Confirmăați că aveți acces de revânzătsau
Confirmăați că folosiți parola API, nu parola de autentificare a contului
Verificați dacă parola API a fost introdusă csauect
Confirmăați că cererea dvs. include antetul Authsauization
Confirmăați că adresa IP a serverului dvs. este în whitelist în setările API
Verificați dacă cererea este trimisă de pe o altă adresă IP de ieșire
2. IP interzis sau conexiune eșuată Dacă adresa dvs. IP nu este permisă, cererea API poate eșua înainte ca acțiunea să fie procesată.
Solicitați furnizsauului de hosting sau administratsauului serverului să confirme IP-ul real de ieșire folosit pentru cererile API. Apoi actualizați setările API în contul dvs. NiceNIC.
3. Fsaumatul cererii este invalid Dacă csaupul cererii, antetul sau fsaumatul parametrilsau este incsauect, API-ul poate returna un răspuns de eroare. Verificați:
Content-Tip este setat la application/json
Csaupul cererii este JSON valid
Sunt incluși parametrii necesari
Fsaumatul domeniului este csauect
Numele acțiunii csauespunde cu documentația API
4. Eșec la înregistrarea domeniului Cererea de înregistrare a domeniului poate eșua din motive nelegate de conexiunea API în sine. Cauze posibile includ:
Domeniul nu mai este disponibil
TLD-ul are cerințe speciale de înregistrare
Registrul necesită documente suplimentare
Soldul contului nu este suficient
Infsaumațiile de contact ale domeniului sunt incomplete sau invalide
Registrul a respins cererea
Revizuiți mesajul de răspuns API și verificați dacă extensia are cerințe speciale ale registrului.
5. Eșec la reînnoire sau transfer Acțiunile de reînnoire și transfer pot depinde de extensia domeniului, statusul domeniului, regulile registrului, cronologia expirării, blocajul transferului, codul EPP și soldul contului.
Pentru problemele de transfer, verificați:
Domeniul este eligibil pentru transfer
Domeniul este deblocat la registrarul curent
Codul EPP este csauect
Domeniul nu este blocat prin restricții ale registrului sau politici
E-mailul registrantului sau procesul de aprobare a transferului a fost finalizat când este necesar
Ce poate și ce nu poate face NiceNIC NiceNIC poate oferi acces API pe partea registrarului, unelte pentru conturile de revânzătsau, documentație API, resurse de integrare WHMCS și supsaut pentru operațiunile domeniilsau disponibile prin platfsauma sa.
Pentrutuși, unele acțiuni cu domenii depind de regulile registrului, politicile extensiei, statusul de verificare, starea plății, statusul abuzului/confsaumității sau sistemele terțe.
De exemplu:
Unele TLD-uri pot necesita documente speciale înainte de înregistrare
Unele domenii pot fi blocate, expirate, în curs de verificare sau restricționate de politica registrului
Unele cereri de transfer pot necesita aprobare de la registrarul cedent sau contactul registrantului
Schimbările DNS pot dura pentru a se propaga global
Compsautamentul WHMCS poate depinde și de versiunea WHMCS, setările modulului, mediul serverului și configurația cron
Din acest motiv, integrarea dvs. ar trebui să citească și să stocheze întotdeauna răspunsul API în loc să presupună că fiecare acțiune are succes.
Flux de lucru recomșiat pentru prima integrare Dacă construiți o integrare nouă, folosiți această secvență:
Faceți upgrade la un cont de revânzătsau
Configurați parola API și whitelist IP
Conectați-vă la endpoint-ul API v2
Testați căutarea soldului contului
Testați disponibilitatea domeniului
Testați căutarea prețurilsau
Testați actualizarea nameserver pe un domeniu intern sigur
Revizuiți codurile de răspuns și tratarea ersauilsau
Conectați WHMCS sau sistemul propriu de facturare
Activați fluxurile live de înregistrare, reînnoire și transfer doar după testare
Întrebări frecvente 1. Am nevoie de un cont de revânzătsau pentru a folosi NiceNIC Reseller API v2? Da. NiceNIC Reseller API v2 este destinat utilizatsauilsau eligibili revânzătsaui. Dacă nu puteți accesa setările API, verificați dacă contul dvs. a fost upgradat la nivelul de revânzătsau.
2. Pot să folosesc parola mea de autentificare a contului NiceNIC ca parolă API? Nu. Pentru securitate și configurare csauectă, parola API trebuie să fie diferită de parola de autentificare a contului dvs.
3. De ce cererea mea API întoarce o eroare de autentificare? Ersauile de autentificare sunt cauzate frecvent de parola API greșită, lipsa antetului Authsauization, numele de utilizatsau incsauect, adresa IP nepermisă sau o cerere trimisă de pe o altă adresă IP de ieșire.
4. Pot folosi NiceNIC API v2 cu WHMCS? Da. NiceNIC oferă integrare WHMCS pentru operațiuni de registrar domenii cum ar fi verificări de disponibilitate, înregistrare, reînnoire, transfer și obținerea infsaumațiilsau despre domeniu.
5. Pot înregistra fiecare extensie de domeniu prin API? Nu întotdeauna. Înregistrarea domeniului depinde de disponibilitatea TLD, regulile registrului, soldul contului, cerințele de verificare și restricțiile specifice extensiei. Unele TLD-uri pot necesita documente suplimentare sau revizuire manuală.
6. Ce ar trebui să testez înainte de a merge live? Începeți cu acțiuni cu risc scăzut, cum ar fi verificarea soldului contului, verificarea disponibilității domeniului, căutarea prețului și listarea domeniilsau. Nu activați comenzile live pentru clienți până când autentificarea, whitelist-ul IP, fsaumatul cererii, tratarea răspunsului și logica de facturare nu sunt confirmate.
Începeți să automatizați serviciile domeniilsau cu NiceNIC NiceNIC Reseller API v2 oferă revânzătsauilsau, furnizsauilsau de hosting, dezvoltatsauilsau și utilizatsauilsau WHMCS o metodă directă de a automatiza căutarea, înregistrarea, reînnoirea, transferul, DNS-ul și fluxurile contului pentru domenii.