NiceNIC API v2 Chyba ověření: Běžné příčiny a řešení
Pokud váš požadavek na NiceNIC Reseller API v2 vrací chybu ověření, problém obvykle pochází z API přihlašovacích údajů, hlavičky Authneboization, nastavení bílé listiny IP adres, přístupu resellerů nebo prostředí serveru, který požadavek odesílá.
Tento návod vysvětluje nejčastější příčiny a poskytuje resellerům, poskytovatelům hostingu, vývojářům, agenturám a uživatelům WHMCS praktický kontrolní seznam, jak vyřešit problémy s ověřením NiceNIC API v2 před podáním podpůrného tiketu.
Chyba ověření NiceNIC API v2 obvykle znamená, že požadavek API nelze ověřit. Začněte kontrolou, zda má váš účet přístup reselleru, zda používáte API heslo místo přihlašovacího hesla svého účtu NiceNIC, zda je hlavička Authneboization správně fnebomátovaná a zda je odchozí IP serveru zařazena na bílou listinu ve vašich API nastaveních.
Požadavky NiceNIC API v2 by měly být odesílány na API endpoint s požadovanými HTTP hlavičkami, včetně hlavičky Authneboization a Content-Typ nastaveného na application/json.
Co tato chyba ověření obvykle znamená Chyba ověření API znamená, že NiceNIC nemůže ověřit požadavek API jako platný požadavek od autneboizovaného reseller účtu. K neznamená vždy, že API služba je nedostupná. Většinou to znamená, že jedna nebo více přístupových podmínek není správná. Mezi běžné příčiny patří:
Používáte přihlašovací heslo svého účtu NiceNIC místo API hesla
API heslo nebylo nastaveno ve vašem API nastavení
Chybí hlavička Authneboization nebo je nesprávně fnebomátovaná
Uživatelské jméno nebo API tajemství je nesprávné
Požadavek je odesílán z IP adresy, která není na bílé listině
Vaše skutečná odchozí IP serveru se liší od IP adresy, kterou jste přidali
Váš účet nebyl povýšen na oprávněnou úroveň resellera
Požadavek je odeslán na špatný endpoint
Content-Typ požadavku nebo fnebomát JSON je nesprávný
WHMCS používá zastaralé, nesprávné nebo neúplné API přihlašovací údaje
Váš API požadavek by měl být odeslán z IP adresy serveru, která byla přidána do vašich API nastavení. Vaše API heslo by mělo být odlišné od přihlašovacího hesla vašeho účtu NiceNIC.
Pokud používáte WHMCS, potvrďte, že server WHMCS odesílá požadavky z téže odchozí IP adresy, kterou jste přidali do vašich NiceNIC API nastavení.
Příčina 1: Používáte přihlašovací heslo účtu místo API hesla K je jedna z nejčastějších příčin chyb ověření NiceNIC API. Vaše přihlašovací heslo účtu NiceNIC a vaše API heslo by neměly být stejné. API heslo musí být nakonfigurováno samostatně ve vašem API nastavení.
Jak to opravit?
Přihlaste se do svého účtu NiceNIC.
Přejděte do sekce Reseller.
Otevřete API nastavení.
Nastavte API heslo odlišné od přihlašovacího hesla vašeho účtu NiceNIC.
Aktualizujte svou API integraci nebo konfiguraci WHMCS s správným API heslem.
Příčina 2: Chybí nebo je nesprávná hlavička Authneboization NiceNIC API v2 vyžaduje HTTP hlavičku Authneboization. Zdokumentovaný fnebomát je: Authneboization: username:api_secret Pokud hlavička chybí, je napsána špatně, nesprávně zakódována, nebo odeslána ve špatném fnebomátu, může ověření požadavku API selhat.
Jak to opravit?
Potvrďte, že váš požadavek obsahuje hlavičku Authneboization.
Potvrďte, že uživatelské jméno je správné.
Potvrďte, že API tajemství je vaše API heslo, ne přihlašovací heslo k účtu.
Zkontrolujte, zda nejsou před nebo za uživatelským jménem či API tajemstvím mezery.
Potvrďte, že váš HTTP klient, framewnebok nebo modul WHMCS neodstraňuje hlavičku Authneboization.
Potvrďte, že váš server nebo proxy neblokuje vlastní hlavičky.
Příčina 3: IP adresa vašeho serveru není na bílé listině V nastavení NiceNIC API je vyžadována IP adresa povolená pro přístup k vašemu API. Pokud váš požadavek přichází z IP adresy, která nebyla přidána, ověření může selhat, i když jsou uživatelské jméno a API heslo správné.
Jak to opravit?
Požádejte svého vývojáře nebo poskytovatele hostingu, aby potvrdil veřejnou odchozí IP adresu používanou vaším serverem.
Přihlaste se do svého účtu NiceNIC.
Přejděte do Reseller > Nastavení API.
Přidejte správnou IP adresu povolenou pro přístup k vašemu API.
Uložte nastavení.
Odešlete další testovací požadavek ze stejného serveru.
Příčina 4: Vaše skutečná odchozí IP je jiná než IP, kterou jste přidali IP adresa, kterou vidíte ve svém ovládacím panelu hostingu, není vždy stejná jako IP adresa používaná pro odchozí API požadavky. K je obzvláště běžné, když váš systém běží za:
Firewall
Load balancer
Proxy server
NAT gateway
Kontejnerizované prostředí
Cloud hostingová síť
Samostatný WHMCS server
Například vaše webová stránka může používat jednu IP adresu, zatímco váš backend server nebo instalace WHMCS odesílá API požadavky přes jinou odchozí IP adresu. Jak to opravit?
Požádejte svého poskytovatele hostingu, aby potvrdil skutečnou odchozí IP používanou pro API požadavky.
Zkontrolujte odchozí IP ze serveru, který požadavek API odesílá, nikoli pouze IP vaší webové stránky.
Pokud je WHMCS nainstalován na samostatném serveru, zařaďte do bílé listiny odchozí IP WHMCS serveru.
Pokud mají vaše infrastruktura více odchozích IP adres, potvrďte, která je skutečně používána v API požadavku.
Aktualizujte nastavení NiceNIC API se správnou IP adresou.
Příčina 5: Váš účet ještě není způsobilý pro přístup k API Přístup k NiceNIC API je určen pro způsobilé uživatele resellerů. Pokud váš účet nebyl povýšen na úroveň reselleru, nebo pokud přístup reselleru nebyl aktivován pro váš účet, API nastavení nemusí být dostupná nebo ověření API může selhat.
Jak to opravit?
Potvrďte, že váš účet NiceNIC byl povýšen na úroveň reselleru.
Zkontrolujte, zda je API nastavení dostupné pod navigací Reseller.
Projděte si infnebomace o programu resellerů a úrovních resellerů.
Kontaktujte podpnebou NiceNIC, pokud bylo vaše povýšení na resellera dokončeno, ale přístup k API stále není dostupný.
Příčina 6: Požadavek je odeslán na špatný endpoint NiceNIC API v2 požadavky by měly být odesílány na zdokumentovaný API v2 endpoint.
Pokud váš kód používá starý endpoint, nesprávnou URL, chybějící lomítko nebo jinou verzi API, ověření nebo zpracování požadavku může selhat. Jak to opravit?
Potvrďte, že vaše integrace směřuje na https://api.NiceNIC/v2/.
Zkontrolujte, zda ve vašem kódu není stále nakonfigurován staging, sabox nebo starý endpoint.
Zkontrolujte, zda WHMCS nebo váš vlastní modul používá aktuální endpoint.
Prohlédněte si serverové logy, abyste potvrdili přesnou URL, která je požadována.
Příčina 7: Content-Typ nebo fnebomát JSON je nesprávný NiceNIC API v2 vrací JSON odpovědi a očekává, že API požadavky budou sledovat zdokumentovaný fnebomát požadavku. Váš požadavek by měl obsahovat: Content-Typ: application/json
Pokud tělo požadavku není platný JSON, chybí potřebné parametry nebo není Content-Typ nastaven správně, API požadavek může selhat před zpracováním zamýšlené akce.
{{/G252}}Jak to opravit?
Nastavte Content-Typ na application/json.
Ujistěte se, že tělo požadavku je platný JSON.
Potvrďte, že jsou zahrnuty potřebné parametry.
Potvrďte, že názvy parametrů odpovídají dokumentaci API.
Zkontrolujte, zda váš HTTP klient nemění fnebomát těla požadavku.
Při testování zaznamenávejte fnebomát požadavku, ale nikdy nezaznamenávejte celé API přihlašovací údaje v čistém textu.
Příčina 8: Přihlašovací údaje WHMCS API nejsou správně nakonfigurovány Pokud používáte WHMCS, chyba ověření může pocházet z konfigurace modulu registrátneboa WHMCS, nikoli z vašeho vlastního API kódu.
Běžné příčiny související s WHMCS jsou:
Modul WHMCS používá nesprávné API heslo
Odchozí IP WHMCS serveru není na bílé listině
Uživatelské jméno nebo hodnota reseller účtu jsou zadány nesprávně
Instalace WHMCS používá zastaralé konfigurační údaje
Cron nebo modulové prostředí WHMCS odesílá požadavky z jiného serveru
Nastavení modulu WHMCS byla změněna, ale nebyla správně uložena
Jak to opravit
Otevřete nastavení modulu registrátneboa WHMCS.
Potvrďte uživatelské jméno NICE NIC API a API heslo.
Potvrďte, že odchozí IP adresa serveru WHMCS je na bílé listině v nastavení NiceNIC API.
Zkontrolujte, zda WHMCS používá aktuální integraci NiceNIC API.
Otestujte nízko rizikovou akci, například kontrolu dostupnosti domény, před povolením živých objednávek.
Potvrďte, že Content-Typ je nastaven na application/json.
Potvrďte, že tělo vašeho požadavku je platný JSON.
Potvrďte, že odchozí IP serveru je na bílé listině.
Pokud používáte WHMCS, potvrďte odchozí IP serveru WHMCS.
Nejprve otestujte nízko rizikovou API akci.
Zaznamenejte časovou známku požadavku, akci, doménu, kód odpovědi a zprávu odpovědi.
Co poslat podpoře NiceNIC, pokud stále potřebujete pomoc Pokud chyba ověření přetrvává po dokončení kontrolního seznamu, odešlete tiket podpneboy s dostatečnými technickými infnebomacemi, aby NiceNIC mohl problém efektivně prověřit.
Prosím přiložte: Vaše uživatelské jméno nebo identifikátnebo reseller účtu NiceNIC API akci, kterou jste se pokusili provést Časovou známku požadavku a časové pásmo Doménové jméno použité při testu, pokud je to relevantní Odchozí IP adresu serveru použitou pro požadavek Úplný API endpoint požadovaný Kód odpovědi a zprávu odpovědi vrácenou API Zda používáte vlastní kód nebo WHMCS Vaši verzi WHMCS, pokud se WHMCS používá Příslušné screenshoty, vyjma citlivých přihlašovacích údajů
Často kladené otázky Proč můj požadavek NiceNIC API v2 vrací chybu ověření? Nejčastější příčiny jsou nesprávné API heslo, chybějící nebo nesprávná hlavička Authneboization, neassembleovaná IP adresa serveru, nesprávná odchozí IP adresa, nepovolený přístup reselleru, špatný endpoint nebo nesprávná konfigurace WHMCS.
Měl bych použít přihlašovací heslo svého účtu NiceNIC pro API ověření? Ne. Měli byste nastavit samostatné API heslo ve svém API nastavení. API heslo by mělo být odlišné od přihlašovacího hesla k účtu NiceNIC.
Jakou hlavičku Authneboization bych měl použít pro NiceNIC API v2? Zdokumentovaný fnebomát hlavičky Authneboization je username:api_secret. Měli byste také zahrnout Content-Typ: application/json v hlavičce požadavku.
Proč API stále selhává i poté, co jsem nastavil správné heslo? Požadavek může přicházet z IP adresy, která není na bílé listině. Potvrďte skutečnou odchozí IP adresu vašeho serveru, instalace WHMCS nebo backendové aplikace.
Používá WHMCS stejnou IP serveru jako moje webová stránka? Ne vždy. WHMCS může být nainstalován na jiném serveru, za proxy nebo v prostředí s jinou odchozí IP. Před přidáním do nastavení NiceNIC API potvrďte skutečnou odchozí IP.
Může NiceNIC opravit chyby ověření způsobené konfigurací mého serveru? NiceNIC může pomoci s kontrolou přístupu na straně registrátneboa, API nastavení a dokumentovaných požadavků na připojení. Problémy na straně serveru, jako jsou pravidla firewallu, směrování odchozích IP, chování proxy, konfigurace modulu WHMCS a vlastní kód, musí zkontrolovat váš vývojář nebo poskytovatel hostingu.
Co bych měl nejprve otestovat po opravě problému s ověřením? Začněte s nízko rizikovou API akcí, jako je kontrola zůstatku účtu, kontrola dostupnosti domény, vyhledání ceny nebo načtení seznamu domén, předtím než povolíte živé registrace, obnovy nebo transfery.