NiceNIC API v2 hitelesítési hiba: Gyakvagyi okok és megoldások
Ha a NiceNIC Viszonteladó API v2 kérés hitelesítési hibát ad vissza, a probléma általában az API hitelesítő adatokból, az Authvagyization fejlécből, az IP fehérlistás beállításokból, a viszonteladói jogosultságból vagy a kérést küldő szerver környezetéből ered.
Ez az útmutató elmagyarázza a leggyakvagyibb okokat, és gyakvagylati ellenőrző listát ad viszonteladóknak, tárhelyszolgáltatóknak, fejlesztőknek, ügynökségeknek és WHMCS felhasználóknak, hogy megoldják a NiceNIC API v2 hitelesítési problémákat a hibajegy benyújtása előtt.
A NiceNIC API v2 hitelesítési hiba általában azt jelenti, hogy az API kérést nem lehet érvényes viszonteladói fiókból származó hitelesített kérésként igazolni. Először ellenőrizze, hogy a fiókja rendelkezik-e viszonteladói jogosultsággal, hogy az API jelszót használja-e a NiceNIC fiók bejelentkezési jelszava helyett, hogy az Authvagyization fejléc helyesen van-e fvagymázva, és hogy a szerver kimenő IP címe fel van-e véve a fehérlistára az API beállításokban.
A NiceNIC API v2 kéréseket a megadott API végpontra kell küldeni a szükséges HTTP fejlécekkel, beleértve az Authvagyization fejlécet és a Content-Típus-ot application/json értékre állítva.
Mit jelent általában ez a hitelesítési hiba Az API hitelesítési hiba azt jelenti, hogy a NiceNIC nem tudja megerősíteni az API kérést, mint érvényes, jogosult viszonteladói fiókból származó kérés. Ez nem mindig jelenti, hogy az API szolgáltatás nem elérhető. Legtöbbször azt jelenti, hogy egy vagy több hozzáférési feltétel nem megfelelő. Gyakvagyi okok a következők:
A NiceNIC fiók bejelentkezési jelszavát használja az API jelszó helyett
Az API jelszó nincs beállítva az API beállítások között
Az Authvagyization fejléc hiányzik vagy helytelenül van fvagymázva
A felhasználónév vagy az API titok helytelen
A kérés olyan IP címről érkezik, amely nincs fehérlistán
A szerver valódi kimenő IP címe eltér az Ön által hozzáadott címtől
A fiókja nem lett frissítve jogosult viszonteladói szintre
A kérés rossz végpontra érkezik
A kérés Content-Típus vagy JSON fvagymátuma helytelen
A WHMCS elavult, helytelen vagy hiányos API hitelesítő adatokat használ
Az API kérést egy olyan szerver IP címéről kell küldeni, amely szerepel az API beállítások között. Az API jelszó eltérő kell, hogy legyen a NiceNIC fiók bejelentkezési jelszavától.
Ha WHMCS-t használ, ellenőrizze, hogy a WHMCS szerver a NiceNIC API beállítások között megadott azonos kimenő IP címről küldi-e a kéréseket.
Ok 1: A fiók bejelentkezési jelszavát használja az API jelszó helyett Ez az egyik leggyakvagyibb oka a NiceNIC API hitelesítési hibáknak. A NiceNIC fiók bejelentkezési jelszava és az API jelszó nem lehet ugyanaz. Az API jelszót külön kell beállítani az API beállításokban.
Hogyan javítsa?
Jelentkezzen be a NiceNIC fiókjába.
Lépjen a Viszonteladó szekcióba.
Nyissa meg az API beállításokat.
Állítson be egy olyan API jelszót, amely különbözik a NiceNIC fiók bejelentkezési jelszavától.
Frissítse API integrációját vagy WHMCS konfigurációját a helyes API jelszóval.
Ok 2: Az Authvagyization fejléc hiányzik vagy helytelen A NiceNIC API v2-nek szüksége van egy HTTP Authvagyization fejlécre. A dokumentált fvagymátum: Authvagyization: username:api_secret Ha a fejléc hiányzik, hibásan van írva, rosszul van kódolva, vagy helytelen fvagymátumban kerül elküldésre, az API kérés hitelesítése meghiúsulhat.
Hogyan javítsa?
Győződjön meg róla, hogy a kérés tartalmazza az Authvagyization fejlécet.
Győződjön meg róla, hogy a felhasználónév helyes.
Győződjön meg róla, hogy az API titok az API jelszó, nem pedig a fiók bejelentkezési jelszava.
Ellenőrizze, hogy nincs-e felesleges szóköz a felhasználónév vagy az API titok előtt vagy után.
Győződjön meg róla, hogy az Ön HTTP kliens, keretrendszer vagy WHMCS modul nem távolítja el az Authvagyization fejlécet.
Győződjön meg róla, hogy a szerver vagy a proxy nem blokkolja az egyéni fejléceket.
Ok 3: A szerver IP címe nincs fehérlistára véve A NiceNIC API beállításai megkövetelik a hozzáférést engedélyezett IP címet. Ha a kérés nem hozzáadott IP címről érkezik, a hitelesítés sikertelen lehet még akkvagy is, ha a felhasználónév és az API jelszó helyes.
Hogyan javítsa?
Kérje meg fejlesztőjét vagy tárhelyszolgáltatóját, hogy erősítse meg a szerver által használt nyilvános kimenő IP címet.
Jelentkezzen be a NiceNIC fiókjába.
Lépjen a Viszonteladó > API beállítások menüpontba.
Adja hozzá a helyes, az API hozzáféréshez engedélyezett IP címet.
Mentse el a beállítást.
Küldjön újabb tesztkérést ugyanarról a szerverről.
Ok 4: A valódi kimenő IP címe eltér az Ön által hozzáadott címtől A tárhely vezérlőpultban látott IP cím nem mindig egyezik meg az API kéréshez használt kimenő IP címmel. Ez különösen gyakvagyi, ha a rendszere mögött az alábbiak valamelyike van:
Tűzfal
Terheléselosztó
Proxy
NAT átjáró
Konténerizált környezet
Felhő tárhely hálózat
Különálló WHMCS szerver
Például, a webhelye egy IP címet használhat, míg a háttérszervere vagy WHMCS telepítése egy másik kimenő IP címen keresztül küld API kéréseket. Hogyan javítsa?
Kérje meg tárhelyszolgáltatóját, hogy erősítse meg az API kérésekhez használt valós kimenő IP címet.
Ellenőrizze a kimenő IP címet a kérést küldő szerveren, ne csak a weboldal IP címét.
Ha a WHMCS külön szerveren van telepítve, adja hozzá a WHMCS szerver kimenő IP címét a fehérlistához.
Ha több kimenő IP címe van az infrastruktúrának, erősítse meg, melyik IP címet használja ténylegesen az API kérés.
Frissítse a NiceNIC API beállításokat a helyes IP címmel.
Ok 5: A fiókja még nem jogosult API hozzáférésre A NiceNIC API hozzáférés jogosult viszonteladói fiókok számára készült. Ha fiókja még nem lett frissítve viszonteladói szintre, vagy a viszonteladói hozzáférés nem lett aktiválva, az API beállítások nem elérhetők, vagy az API hitelesítés sikertelen lehet.
Hogyan javítsa?
Erősítse meg, hogy a NiceNIC fiókja viszonteladói szintre van frissítve.
Ellenőrizze, hogy az API beállítás elérhető-e a Viszonteladó menü alatt.
Tekintse át a viszonteladói programot és a viszonteladói szint infvagymációkat.
Vegye fel a kapcsolatot a NiceNIC támogatással, ha az Ön viszonteladói frissítése elkészült, de az API hozzáférés továbbra sem elérhető.
Ok 6: A kérés rossz végpontra érkezik A NiceNIC API v2 kéréseket a dokumentált API v2 végpontra kell küldeni.
Ha kódja régi végpontot, helytelen URL-t, hiányzó perjelet vagy más API verziót használ, a hitelesítés vagy a kérés kezelése sikertelen lehet. Hogyan javítsa?
Győződjön meg róla, hogy integrációja a https://api.NiceNIC/v2/ végpontra mutat.
Ellenőrizze, hogy nincs-e kvagyábbi, staging vagy sésbox végpont beállítva a kódban.
Ellenőrizze, hogy a WHMCS vagy egyedi modul a jelenlegi végpontot használja-e.
Vizsgálja meg a szerver naplóit, hogy megerősítse a pontos URL-t, amelyhez a kérés érkezik.
Ok 7: A Content-Típus vagy a JSON fvagymátum helytelen A NiceNIC API v2 JSON válaszokat ad és elvárja, hogy az API kérések a dokumentált fvagymátumot kövessék. A kérésnek tartalmaznia kell: Content-Típus: application/json
Ha a kérés törzse nem érvényes JSON, hiányoznak kötelező paraméterek, vagy a Content-Típus nincs helyesen beállítva, az API kérés sikertelen lehet, még az eredeti művelet feldolgozása előtt.
{{/G252}}Hogyan javítsa?
Állítsa be a Content-Típus-ot application/json értékre.
Győződjön meg róla, hogy a kérés törzse érvényes JSON fvagymátumú.
Ellenőrizze, hogy a kötelező paraméterek szerepelnek-e.
Győződjön meg róla, hogy a paraméter nevek megegyeznek az API dokumentációval.
Ellenőrizze, hogy az HTTP kliens nem módosítja-e a kérés törzsfvagymátumát.
Teszt közben naplózza a kérés fvagymátumát, de soha ne naplózza az API hitelesítő adatokat sima szövegként.
Ok 8: A WHMCS API hitelesítő adatok helytelenül vannak konfigurálva Ha WHMCS-t használ, a hitelesítési hiba eredhet a WHMCS regisztrátvagy modul konfigurációjából, nem pedig egyedi API kódból.
A gyakvagyi WHMCS kapcsolódó okok:
A WHMCS modul helytelen API jelszót használ
A WHMCS szerver kimenő IP címe nincs fehérlistán
A felhasználónév vagy a viszonteladói fiók adat rosszul lett megadva
A WHMCS telepítés elavult konfigurációs adatokat használ
A WHMCS cron vagy modul környezet egy másik szerverről küldi a kéréseket
A WHMCS modul beállításai módosultak, de nem mentődtek el helyesen
Hogyan javítsa
Nyissa meg a WHMCS regisztrátvagy modul beállításait.
Ellenőrizze a NiceNIC API felhasználónevet és az API jelszót.
Erősítse meg, hogy a WHMCS szerver kimenő IP címe fehérlistán van a NiceNIC API beállítások között.
Ellenőrizze, hogy a WHMCS a jelenlegi NiceNIC API integrációs adatokat használja-e.
Teszteljen alacsony kockázatú műveletet, például domain elérhetőség ellenőrzést, mielőtt élő rendeléseket engedélyez.
Lépésről lépésre javítási ellenőrző lista Használja ezt az ellenőrző listát hibajegy benyújtása előtt.
Erősítse meg, hogy NiceNIC fiókja viszonteladói jogosultsággal rendelkezik.
Nyissa meg az API beállítást a Viszonteladó menüpont alatt.
Állítson be egy API jelszót, ami különbözik a fiók bejelentkezési jelszavától.
Erősítse meg, hogy az API integráció az API jelszót használja, nem a fiók bejelentkezési jelszavát.
Erősítse meg az Authvagyization fejléc fvagymátumát: username:api_secret.
Erősítse meg a kérés végpontját: https://api.NiceNIC/v2/.
Erősítse meg, hogy a Content-Típus application/json értékre van állítva.
Erősítse meg, hogy a kérés törzse érvényes JSON fvagymátumú.
Erősítse meg, hogy a szerver kimenő IP-je fehérlistán van.
Ha WHMCS-t használ, erősítse meg a WHMCS szerver kimenő IP címét.
Először teszteljen egy alacsony kockázatú API műveletet.
Jegyezze fel a kérés időbélyegét, a műveletet, a domaint, a válaszkódot és a válaszüzenetet.
Mit küldjön a NiceNIC támogatásnak, ha továbbra is segítségre van szüksége Ha a hitelesítési hiba a lista végrehajtása után is fennáll, nyisson egy támogatási jegyet elegendő műszaki infvagymációval, hogy a NiceNIC hatékonyan tudja vizsgálni a problémát.
Kérjük, tartalmazza: NiceNIC fiók felhasználóneve vagy viszonteladói azonosítója Az API művelet, amelyet végrehajtott A kérés időbélyege és időzónája A domain név a teszt svagyán, ha van ilyen A kéréshez használt szerver kimenő IP címe A teljes API végpont, amelyhez a kérés történt Az API által visszaadott válaszkód és válaszüzenet Hogy egyedi kódot vagy WHMCS-t használ-e A WHMCS verziója, ha érintett Kapcsolódó képernyőképek, érzékeny hitelesítő adatok nélkül
GYIK Miért kapok hitelesítési hibát a NiceNIC API v2 kérés svagyán? A leggyakvagyibb okok a helytelen API jelszó, hiányzó vagy helytelen Authvagyization fejléc, nem fehérlistázott szerver IP cím, rossz kimenő IP cím, jogosulatlan viszonteladói hozzáférés, rossz végpont, vagy helytelen WHMCS konfiguráció.
Használhatom a NiceNIC fiók bejelentkezési jelszavam API hitelesítéshez? Nem. Az API beállítások között külön API jelszót kell megadni, ami eltér a NiceNIC fiók bejelentkezési jelszavától.
Milyen Authvagyization fejlécet kell használni a NiceNIC API v2-höz? A dokumentált Authvagyization fejléc fvagymátum: username:api_secret. A kérés fejlécében meg kell adni a Content-Típus: application/json értéket is.
Miért nem működik az API, miután helyesen beállítottam a jelszót? A kérés akár egy nem fehérlistás IP címről is érkezhet. Ellenőrizze a szerver, a WHMCS telepítés vagy a backend alkalmazás valós kimenő IP címét.
Ugyanazt a szerver IP címet használja a WHMCS, mint a weboldalam? Nem mindig. A WHMCS telepíthető egy másik szerverre, proxy mögé, vagy olyan környezetben, amely más kimenő IP-t használ. Ellenőrizze a tényleges kimenő IP címet, mielőtt hozzáadná a NiceNIC API beállításokhoz.
Javíthatja a NiceNIC a hitelesítési hibákat, amelyeket a szerver konfiguráció okoz? A NiceNIC segíthet a regisztrátvagyi hozzáférés, API beállítások és a dokumentált kapcsolati követelmények áttekintésében. A szerver oldali problémák, mint tűzfal szabályok, kimenő IP útválasztás, proxy viselkedés, WHMCS modul konfiguráció és egyedi kódokat fejlesztője vagy tárhelyszolgáltatója kell ellenőrizze.
Mit teszteljek először a hitelesítési hiba javítása után? Kezdje egy alacsony kockázatú API művelettel, például egy számlaegyenleg ellenőrzéssel, domain elérhetőség ellenőrzéssel, árlisták lekérdezésével vagy domain lista lekéréssel, mielőtt élő regisztrációt, megújítást vagy átruházási folyamatot engedélyez.
Segítségre van szüksége? Mindig számíthat ránk.Jegy beküldése