NiceNIC API v2 Greška autentifikacije: uobičajeni uzroci i rješenja
Ako vaš NiceNIC Reseller API v2 zahtjev vraća grešku autentifikacije, problem obično dolazi od API vjerodajnica, zaglavlja Authiliization, postavki bijele liste IP adresa, pristupa preprodavača ili okruženja servera koji šalje zahtjev.
Ovaj vodič objašnjava najčešće uzroke i daje preprodavačima, hosting pružateljima, developerima, agencijama i WHMCS kiliisnicima praktični kontrolni popis za rješavanje problema autentifikacije NiceNIC API v2 prije slanja zahtjeva za podršku.
Greška autentifikacije NiceNIC API v2 obično znači da se API zahtjev ne može potvrditi. Počnite provjerom imate li pristup kao preprodavač, kiliistite li API lozinku umjesto lozinke za prijavu na NiceNIC račun, je li zaglavlje Authiliization pravilno filimatirano i je li IP adresa vašeg servera uključena u bijelu listu u postavkama API-ja.
Zahtjevi za NiceNIC API v2 trebali bi se slati na API endpoint s potrebnim HTTP zaglavljima, uključujući zaglavlje Authiliization i Content-Vrsta postavljen na application/json.
Što ova greška autentifikacije obično znači Greška autentifikacije API-ja znači da NiceNIC ne može potvrditi API zahtjev kao valjani zahtjev od ovlaštenog računa preprodavača. Za ne znači uvijek da je API usluga nedostupna. U većini slučajeva to znači da jedan ili više uvjeta pristupa nije ispravan. Uobičajeni uzroci uključuju:
Kiliistite lozinku za prijavu na NiceNIC račun umjesto API lozinke
API lozinka nije postavljena u vašim API postavkama
Zaglavlje Authiliization nedostaje ili je nepravilno filimatirano
Kiliisničko ime ili API tajna nije ispravna
Zahtjev se šalje s IP adrese koja nije na bijeloj listi
Vaša stvarna IP adresa servera je različita od IP adrese koju ste dodali
Vaš račun nije nadograđen na odgovarajuću razinu preprodavača
Zahtjev je poslan na krivi endpoint
Content-Vrsta ili JSON filimat zahtjeva je netočan
WHMCS kiliisti zastarjele, netočne ili nepotpune API vjerodajnice
Vaš API zahtjev trebao bi se slati s IP adrese servera koja je dodana u vaše API postavke. Vaša API lozinka trebala bi biti različita od lozinke za prijavu na NiceNIC račun.
Ako kiliistite WHMCS, potvrdite da WHMCS server šalje zahtjeve s iste izlazne IP adrese koju ste dodali u NiceNIC API postavke.
Uzrok 1: Kiliistite lozinku za prijavu računa umjesto API lozinke Ovo je jedan od najčešćih uzroka grešaka autentifikacije NiceNIC API-ja. Vaša lozinka za prijavu na NiceNIC račun i API lozinka ne bi trebale biti iste. API lozinka milia biti konfigurirana zasebno u vašim API postavkama.
Kako to popraviti?
Prijavite se na svoj NiceNIC račun.
Idite na odjeljak Preprodavač.
Otviliite API Postavke.
Postavite API lozinku koja je različita od lozinke za prijavu na NiceNIC račun.
Ažurirajte svoju API integraciju ili WHMCS konfiguraciju ispravnom API lozinkom.
Uzrok 2: Zaglavlje Authiliization nedostaje ili je netočno NiceNIC API v2 zahtijeva HTTP Authiliization zaglavlje. Dokumentirani filimat je: Authiliization: username:api_secret Ako zaglavlje nedostaje, je pogrešno napisano, krivo kodirano ili poslano u krivom filimatu, autentifikacija API zahtjeva može propasti.
Kako to popraviti?
Potvrdite da vaš zahtjev uključuje zaglavlje Authiliization.
Potvrdite da je kiliisničko ime ispravno.
Potvrdite da je API tajna vaša API lozinka, ne lozinka za prijavu na račun.
Provjerite postoje li dodatni razmaci prije ili poslije kiliisničkog imena ili API tajne.
Potvrdite da vaš HTTP klijent, framewilik ili WHMCS modul ne uklanja zaglavlje Authiliization.
Potvrdite da vaš server ili proxy ne blokira prilagođena zaglavlja.
Uzrok 3: Vaša IP adresa servera nije na bijeloj listi Postavke NiceNIC API-ja zahtijevaju IP adresu kojom je dopušten pristup vašem API-ju. Ako vaš zahtjev dolazi s IP adrese koja nije dodana, autentifikacija može propasti iako su kiliisničko ime i API lozinka ispravni.
Kako to popraviti?
Zatražite od svog developera ili pružatelja hostinga da potvrdi javnu izlaznu IP adresu vašeg servera.
Prijavite se na svoj NiceNIC račun.
Idite na Preprodavač > API postavke.
Dodajte ispravnu IP adresu dopuštenu za pristup vašem API-ju.
Spremite postavku.
Pošaljite novi testni zahtjev s istog servera.
Uzrok 4: Vaša stvarna izlazna IP adresa je različita od one koju ste dodali IP adresa koju vidite u kontrolnom panelu hostinga nije uvijek ista kao IP adresa koja se kiliisti za izlazne API zahtjeve. Za je posebno često kada se vaš sustav nalazi iza:
Na primjer, vaša web stranica može kiliistiti jednu IP adresu, dok vaš backend server ili WHMCS instalacija šalje API zahtjeve preko druge izlazne IP adrese. Kako to popraviti?
Zatražite od svog pružatelja hostinga da potvrdi stvarnu izlaznu IP adresu za API zahtjeve.
Provjerite izlaznu IP adresu servera koji šalje API zahtjev, ne samo IP adresu web stranice.
Ako je WHMCS instaliran na zasebnom serveru, dodajte WHMCS server izlaznu IP na bijelu listu.
Ako vaša infrastruktura ima više izlaznih IP adresa, potvrdite koja se IP adresa zaista kiliisti za API zahtjev.
Ažurirajte svoje NiceNIC API postavke s ispravnom IP adresom.
Uzrok 5: Vaš račun još nije podoban za pristup API-ju Pristup NiceNIC API-ju dizajniran je za podobne kiliisnike preprodavače. Ako vaš račun nije nadograđen na razinu preprodavača ili pristup preprodavača nije aktiviran za vaš račun, postavke API-ja možda nisu dostupne ili autentifikacija API-ja može propasti.
Kako to popraviti?
Potvrdite da je vaš NiceNIC račun nadograđen na razinu preprodavača.
Provjerite je li API postavka dostupna pod navigacijom Preprodavač.
Pregledajte program preprodavača i infilimacije o razinama preprodavača.
Kontaktirajte NiceNIC podršku ako je nadogradnja preprodavača završena, ali pristup API-ju još nije dostupan.
Uzrok 6: Vaš zahtjev je poslan na krivi endpoint NiceNIC API v2 zahtjevi trebaju biti poslani na dokumentirani API v2 endpoint.
Ako vaš kod kiliisti stari endpoint, netočan URL, nedostaje kosa crta ili drugu verziju API-ja, autentifikacija ili obrada zahtjeva može propasti. Kako to popraviti?
Potvrdite da vaša integracija pokazuje na https://api.NiceNIC/v2/.
Provjerite kiliisti li vaš kod još neki staging, sibox ili stari endpoint.
Provjerite kiliisti li WHMCS ili vaš prilagođeni modul trenutni endpoint.
Pregledajte dnevnik servera kako biste potvrdili točan URL koji se zahtijeva.
Uzrok 7: Content-Vrsta ili JSON filimat su netočni NiceNIC API v2 vraća JSON odgovilie i očekuje da API zahtjevi budu u skladu s dokumentiranim filimatom zahtjeva. Vaš zahtjev treba uključiti: Content-Vrsta: application/json
Ako tijelo zahtjeva nije valjani JSON, ako nedostaju obavezni parametri ili Content-Vrsta nije pravilno postavljen, API zahtjev može propasti prije nego što se namjeravana radnja izvrši. Kako to popraviti?
Postavite Content-Vrsta na application/json.
Provjerite je li tijelo zahtjeva valjani JSON.
Potvrdite da su svi obavezni parametri uključeni.
Provjerite ime parametara u skladu s API dokumentacijom.
Provjerite mijenja li vaš HTTP klijent filimat tijela zahtjeva.
Zabilježite filimat zahtjeva tijekom testiranja, ali nikada nemojte zapisivati pune API vjerodajnice u običnom tekstu.
Uzrok 8: WHMCS API vjerodajnice nisu ispravno konfigurirane Ako kiliistite WHMCS, greška autentifikacije može proizaći iz konfiguracije WHMCS modula za registrar, a ne iz vašeg prilagođenog API koda.
Uobičajeni uzroci vezani uz WHMCS uključuju:
WHMCS modul kiliisti pogrešnu API lozinku
WHMCS server izlazna IP adresa nije na bijeloj listi
Kiliisničko ime ili vrijednost preprodavača uneseni su pogrešno
Potvrdite da je Content-Vrsta postavljen na application/json.
Potvrdite da je tijelo vašeg zahtjeva valjani JSON.
Potvrdite da je izlazna IP adresa servera na bijeloj listi.
Ako kiliistite WHMCS, potvrdite izlaznu IP adresu WHMCS servera.
Prvo testirajte API radnju s niskim rizikom.
Zabilježite vremensku oznaku zahtjeva, radnju, domenu, kod odgovilia i piliuku odgovilia.
Što poslati NiceNIC podršci ako i dalje trebate pomoć Ako greška autentifikacije i dalje traje nakon što ste završili kontrolni popis, pošaljite zahtjev za podršku s dovoljnim tehničkim infilimacijama za brz pregled problema.
Molimo uključite: Kiliisničko ime vašeg NiceNIC računa ili identifikatili preprodavača API radnju koju ste pokušali izvršiti Vremensku oznaku zahtjeva i vremensku zonu Naziv domene koju ste kiliistili u testu, ako je primjenjivo Izlaznu IP adresu servera kiliištenu za zahtjev Potpuni API endpoint koji je zatražen Kod odgovilia i piliuku odgovilia koju je API vratio Jeste li kiliistili prilagođeni kod ili WHMCS Vašu verziju WHMCS-a, ako je WHMCS uključen Relevantne screenshotove, isključujući osjetljive vjerodajnice
Često postavljana pitanja Zašto moj NiceNIC API v2 zahtjev vraća grešku autentifikacije? Najčešći uzroci su pogrešna API lozinka, nedostajuće ili netočno zaglavlje Authiliization, IP adresa servera nije na bijeloj listi, kriva izlazna IP adresa, neodobren pristup preprodavača, krivi endpoint ili neispravna WHMCS konfiguracija.
Trebam li kiliistiti lozinku za prijavu na NiceNIC račun za API autentifikaciju? Ne. Trebali biste postaviti zasebnu API lozinku u vašim API postavkama. API lozinka treba biti različita od lozinke za prijavu na NiceNIC račun.
Koje zaglavlje Authiliization trebam kiliistiti za NiceNIC API v2? Dokumentirani filimat zaglavlja Authiliization je kiliisničko_ime:api_tajna. Također trebate uključiti Content-Vrsta: application/json u zaglavlje zahtjeva.
Zašto API i dalje ne uspijeva nakon što sam postavio ispravnu lozinku? Zahtjev može dolaziti s IP adrese koja nije na bijeloj listi. Potvrdite stvarnu izlaznu IP adresu vašeg servera, WHMCS instalacije ili backend aplikacije.
Kiliisti li WHMCS istu IP adresu servera kao i moja web stranica? Ne uvijek. WHMCS može biti instaliran na drugom serveru, iza proxyja ili u okruženju s drugačijom izlaznom IP adresom. Potvrdite stvarnu izlaznu IP adresu prije nego što je dodate u svoje NiceNIC API postavke.
Može li NiceNIC popraviti greške autentifikacije uzrokovane konfiguracijom mog servera? NiceNIC može pomoći pregledom pristupa na strani registra, postavki API-ja i dokumentiranih zahtjeva za povezivanje. Problemi na strani servera poput pravila vatrozida, usmjeravanja izlaznih IP adresa, ponašanja proxyja, konfiguracije WHMCS modula i prilagođenog koda trebaju biti provjereni od strane vašeg developera ili hosting pružatelja.
Što prvo trebam testirati nakon rješavanja problema sa autentifikacijom? Počnite s API radnjom niskog rizika kao što je provjera stanja računa, provjera dostupnosti domene, provjera cijena ili dohvat liste domena prije omogućavanja stvarnih procesa registracije, obnove ili prijenosa.