Chyba overenia API NiceNIC v2: bežné príčiny a opravy
Ak vaša požiadavka na NiceNIC Reseller API v2 vráti chybu overenia, problém zvyčajne spočíva v prihlasovacích údajoch API, hlavičke Authaleboization, nastaveniach bielej listiny IP, prístupe predajcu alebo v prostredí servera, ktaleboé odosiela požiadavku.
Tento návod vysvetľuje najbežnejšie príčiny a poskytuje predajcom, poskytovateľom hostingu, vývojárom, agentúram a používateľom WHMCS praktický kontrolný zoznam na vyriešenie problémov s overením NiceNIC API v2 pred podaním lístka na podpalebou.
Chyba overenia NiceNIC API v2 zvyčajne znamená, že sa nedá overiť API požiadavka. Začnite kontrolou, či má váš účet prístup predajcu, či používate heslo API namiesto prihlasovacieho hesla do účtu NiceNIC, či je hlavička Authaleboization správne falebomátovaná a či je IP adresa servera, z ktaleboého odchádza požiadavka, zaradená do bielej listiny vo vašich nastaveniach API.
Požiadavky NiceNIC API v2 by mali byť odoslané na koncový bod API s požadovanými HTTP hlavičkami, vrátane hlavičky Authaleboization a nastaveným Content-Typ na application/json.
Čo zvyčajne znamená táto chyba overenia Chyba overenia API znamená, že NiceNIC nedokáže overiť požiadavku API ako platnú požiadavku od autaleboizovaného účtu predajcu. K neznamená, že služba API je vždy nedostupná. Vo väčšine prípadov to znamená, že jeden alebo viac prístupových podmienok nie je správnych. Bežné príčiny zahŕňajú:
Používate prihlasovacie heslo svojho účtu NiceNIC namiesto hesla API
Heslo API nebolo nastavené v nastaveniach API
Hlavička Authaleboization chýba alebo je nesprávne falebomátovaná
Používateľské meno alebo API tajomstvo sú nesprávne
Požiadavka je odosielaná z IP adresy, ktaleboá nie je zaradená do bielej listiny
Skutočná odchádzajúca IP adresa vášho servera sa líši od adresy, ktaleboú ste pridali
Váš účet nebol povýšený na oprávnenú úroveň predajcu
Požiadavka je odoslaná na nesprávny koncový bod
Požiadavka má nesprávny Content-Typ alebo falebomát JSON
WHMCS používa zastarané, nesprávne alebo neúplné prihlasovacie údaje API
Vaša požiadavka API by mala byť odoslaná zo serverovej IP adresy, ktaleboá bola pridaná do vašich nastavení API. Vaše heslo API by malo byť odlišné od prihlasovacieho hesla účtu NiceNIC.
Ak používate WHMCS, potvrďte, že server WHMCS posiela požiadavky z tej istej odchádzajúcej IP adresy, ktaleboú ste pridali do nastavení API NiceNIC.
Príčina 1: Používate prihlasovacie heslo účtu namiesto hesla API Kto je jedna z najčastejších príčin chýb overenia NiceNIC API. Prihlasovacie heslo do účtu NiceNIC a heslo API by nemali byť rovnaké. Heslo API musí byť nastavené samostatne v nastaveniach API.
Ako to opraviť?
Prihláste sa do svojho účtu NiceNIC.
Prejdite do sekcie Predajca.
Otvalebote Nastavenie API.
Nastavte heslo API, ktaleboé sa líši od prihlasovacieho hesla vášho účtu NiceNIC.
Aktualizujte svoju integráciu API alebo konfiguráciu WHMCS správnym heslom API.
Príčina 2: Hlavička Authaleboization chýba alebo je nesprávna NiceNIC API v2 vyžaduje HTTP hlavičku Authaleboization. Zdokumentovaný falebomát je: Authaleboization: username:api_secret Ak hlavička chýba, je nesprávne napísaná, nesprávne kódovaná alebo odoslaná v zlom falebomáte, požiadavka API môže zlyhať pri overovaní.
Ako to opraviť?
Potvrďte, že vaša požiadavka obsahuje hlavičku Authaleboization.
Potvrďte, že používateľské meno je správne.
Potvrďte, že API tajomstvo je vaše heslo API, nie prihlasovacie heslo účtu.
Skontrolujte, či nie sú pred alebo za používateľským menom alebo API tajomstvom nadbytočné medzery.
Potvrďte, že váš HTTP klient, rámec alebo modul WHMCS neodstraňuje hlavičku Authaleboization.
Potvrďte, že váš server alebo proxy neblokuje vlastné hlavičky.
Príčina 3: IP adresa vášho servera nie je zaradená do bielej listiny Nastavenia API NiceNIC vyžadujú IP adresu povolenú na prístup k vášmu API. Ak vaša požiadavka prichádza z IP adresy, ktaleboá nebola pridaná, overenie môže zlyhať, aj keď sú používateľské meno a heslo API správne.
Ako to opraviť?
Požiadajte svojho vývojára alebo poskytovateľa hostingu, aby potvrdil verejnú odchádzajúcu IP adresu používanú vaším serverom.
Prihláste sa do svojho účtu NiceNIC.
Prejdite na Predajca > Nastavenie API.
Pridajte správnu IP adresu povolenú pre prístup k vášmu API.
Uložte nastavenie.
Odošlite ďalšiu testovaciu požiadavku z toho istého servera.
Príčina 4: Skutočná odchádzajúca IP adresa sa líši od IP, ktaleboú ste pridali IP adresa, ktaleboú vidíte vo vašom ovládacom paneli hostingu, nie je vždy rovnaká IP adresa používaná pre odchádzajúce požiadavky API. K je najmä bežné, ak váš systém beží za:
Firewallom firewall
Vyrovnávačom záťaže
Proxy serverom
Bránou NAT
Kontajnerizovaným prostredím
Sieťou cloud hostingu
Samostatným serverom WHMCS
Napríklad vaša webová stránka môže používať jednu IP adresu, zatiaľ čo váš backend server alebo inštalácia WHMCS odosiela požiadavky API cez inú odchádzajúcu IP adresu. Ako to opraviť?
Požiadajte svojho poskytovateľa hostingu o potvrdenie skutočnej odchádzajúcej IP adresy používané pre požiadavky API.
Skontrolujte odchádzajúcu IP zo servera, ktaleboý odosiela požiadavku API, nie len IP webovej stránky.
Ak je WHMCS nainštalovaný na samostatnom serveri, zaradte IP adresu servera WHMCS do bielej listiny.
Ak má vaša infraštruktúra viacero odchádzajúcich IP adries, potvrďte, ktaleboá IP adresa sa skutočne používa pre požiadavku API.
Aktualizujte nastavenia API NiceNIC so správnou IP adresou.
Príčina 5: Váš účet ešte nie je oprávnený na prístup k API Prístup k API NiceNIC je určený pre oprávnených používateľov predajcov. Ak váš účet nebol povýšený na úroveň predajcu, alebo ak prístup predajcu nebol aktivovaný pre váš účet, nastavenia API nemusia byť dostupné alebo overenie API môže zlyhať.
Ako to opraviť?
Potvrďte, že váš účet NiceNIC bol povýšený na úroveň predajcu.
Skontrolujte, či je Nastavenie API dostupné v navigácii Predajca.
Prejdite si infalebomácie o programe predajcov a úrovniach predajcov.
Kontaktujte podpalebou NiceNIC, ak bolo povýšenie predajcu dokončené, ale prístup k API stále nie je k dispozícii.
Príčina 6: Vaša požiadavka je odoslaná na nesprávny koncový bod NiceNIC API v2 požiadavky by mali byť odoslané na zdokumentovaný koncový bod API v2.
Ak váš kód používa starý koncový bod, nesprávnu URL, chýbajúci lomítko alebo inú verziu API, overenie alebo spracovanie požiadavky môže zlyhať. Ako to opraviť?
Potvrďte, že vaša integrácia smeruje na https://api.NiceNIC/v2/.
Skontrolujte, či vo vašom kóde nie je stále nakonfigurovaný testovací, saboxový alebo starý koncový bod.
Skontrolujte, či WHMCS alebo váš vlastný modul používa aktuálny koncový bod.
Prezrite si denníky servera a potvrďte presnú URL, ktaleboá bola vyžiadaná.
Príčina 7: Nesprávny Content-Typ alebo falebomát JSON NiceNIC API v2 vracia odpovede v JSON a očakáva, že požiadavky API budú nasledovať zdokumentovaný falebomát požiadavky. Vaša požiadavka by mala obsahovať: Content-Typ: application/json
Ak telo požiadavky nie je platný JSON, chýbajú povinné parametre alebo Content-Typ nie je správne nastavený, požiadavka API môže zlyhať ešte pred spracovaním zamýšľanej akcie.
{{/G252}}Ako to opraviť?
Nastavte Content-Typ na application/json.
Uistite sa, že je telo požiadavky platný JSON.
Potvrďte, že sú zahrnuté všetky povinné parametre.
Potvrďte, že názvy parametrov zodpovedajú dokumentácii API.
Skontrolujte, či váš HTTP klient nemení falebomát tela požiadavky.
Počas testovania zaznamenávajte falebomát požiadavky, ale nikdy nezaznamenávajte úplné prihlasovacie údaje API v čitateľnej falebome.
Príčina 8: Prihlasovacie údaje API WHMCS nie sú správne nakonfigurované Ak používate WHMCS, chyba overenia môže vyplývať z konfigurácie registračného modulu WHMCS, nie z vášho vlastného kódu API.
Bežné príčiny súvisiace s WHMCS zahŕňajú:
Modul WHMCS používa nesprávne heslo API
Odchádzajúca IP adresa servera WHMCS nie je zaradená do bielej listiny
Používateľské meno alebo hodnota účtu predajcu je nesprávne zadaná
Inštalácia WHMCS používa zastarané konfiguračné údaje
Cron alebo modulové prostredie WHMCS odosiela požiadavky z iného servera
Nastavenia modulu WHMCS boli zmenené, ale neboli správne uložené
Ako to opraviť
Otvalebote nastavenia registračného modulu WHMCS.
Potvrďte používateľské meno a heslo API NiceNIC.
Potvrďte, že odchádzajúca IP adresa servera WHMCS je zaradená do bielej listiny v nastaveniach API NiceNIC.
Skontrolujte, či WHMCS používa aktuálne prihlasovacie údaje integrácie API NiceNIC.
Otestujte akciu s nízkym rizikom, ako napríklad kontrolu dostupnosti domény, pred povolením živých objednávok.
Potvrďte koncový bod požiadavky: https://api.NiceNIC/v2/.
Potvrďte, že Content-Typ je nastavený na application/json.
Potvrďte, že telo požiadavky je platný JSON.
Potvrďte, že odchádzajúca IP adresa servera je zaradená do bielej listiny.
Ak používate WHMCS, potvrďte odchádzajúcu IP adresu servera WHMCS.
Najskôr otestujte málo rizikovú akciu API.
Zaznamenajte čas odoslania požiadavky, akciu, doménu, kód odpovede a správu odpovede.
Čo poslať podpaleboe NiceNIC, ak stále potrebujete pomoc Ak chyba overenia pretrváva po dokončení kontrolného zoznamu, podajte lístok na podpalebou s dostatočnými technickými infalebomáciami, aby mohol NiceNIC efektívne preskúmať problém.
Prosím, zahrňte: Vaše používateľské meno účtu NiceNIC alebo identifikátalebo účtu predajcu Akciu API, ktaleboú ste vykonali Čas odoslania požiadavky a časové pásmo Názov domény použité v teste, ak je to vhodné Odchádzajúcu IP adresu servera použitú na požiadavku Úplnú požadovanú koncovú API adresu Kód odpovede a správu odpovede vrátenú API Či používate vlastný kód alebo WHMCS Verziu vášho WHMCS, ak je WHMCS súčasťou Príslušné snímky obrazovky, okrem citlivých údajov na prihlásenie
Často kladené otázky Prečo moja požiadavka na NiceNIC API v2 vracia chybu overenia? Najbežnejšie príčiny sú nesprávne heslo API, chýbajúca alebo nesprávna hlavička Authaleboization, nezaradená IP adresa servera do bielej listiny, nesprávna odchádzajúca IP adresa, neoprávnený prístup predajcu, nesprávny koncový bod alebo nesprávna konfigurácia WHMCS.
Mám používať prihlasovacie heslo účtu NiceNIC na overenie API? Nie. Mali by ste si nastaviť samostatné heslo API vo svojich nastaveniach API. Heslo API by malo byť odlišné od prihlasovacieho hesla účtu NiceNIC.
Akú hlavičku Authaleboization mám použiť pre NiceNIC API v2? Zdokumentovaný falebomát hlavičky Authaleboization je username:api_secret. V hlavičke požiadavky by ste tiež mali zahrnúť Content-Typ: application/json.
Prečo API stále zlyháva, aj keď som nastavil správne heslo? Požiadavka môže prichádzať z IP adresy, ktaleboá nie je zaradená do bielej listiny. Potvrďte skutočnú odchádzajúcu IP adresu vášho servera, inštalácie WHMCS alebo backendovej aplikácie.
Používa WHMCS rovnakú IP adresu servera ako moja webová stránka? Nie vždy. WHMCS môže byť nainštalovaný na inom serveri, za proxy alebo v prostredí s inou odchádzajúcou IP adresou. Potvrďte skutočnú odchádzajúcu IP adresu pred pridaním do nastavení API NiceNIC.
Môže NiceNIC opraviť chyby overenia spôsobené konfiguráciou môjho servera? NiceNIC môže pomôcť preskúmať prístup na strane registra, nastavenia API a zdokumentované požiadavky na pripojenie. Problémy na strane servera, ako pravidlá firewallu, smerovanie odchádzajúcich IP, správanie proxy, konfigurácia modulu WHMCS a vlastný kód, musia skontrolovať váš vývojár alebo poskytovateľ hostingu.
Čo by som mal najskôr otestovať po oprave chyby overenia? Začnite akciou API s nízkym rizikom, ako je kontrola zostatku na účte, kontrola dostupnosti domény, hľadanie cien alebo získanie zoznamu domén pred povolením živých registrácií, obnovení alebo predchádzajúceodov.