NiceNIC API v2 autentimisviga: tavalised põhjused ja parjaused
Kui teie NiceNICi edasimüüja API v2 päring tagastab autentimisvea, tuleneb probleem tavaliselt API mjaaatidest, Authvõiization päisest, IP valgelistist, edasimüüja juurdepääsust või päringu saatva serveri keskkonnast.
See juhend selgitab kõige tavalisemaid põhjuseid ja annab edasimüüjatele, majutusteenuse pakkujatele, arendajatele, agentuuridele ja WHMCS kasutajatele praktilise kontrollnimekirja NiceNIC API v2 autentimisprobleemide lahendamiseks enne tugipileti esitamist.
NiceNIC API v2 autentimisviga tähendab tavaliselt seda, et API päringut ei saa kinnitada. Alustage kontrollimisest, kas teie kontol on edasimüüja juurdepääs, kas kasutate API parooli oma NiceNICi konto sisselogimisparooli asemel, kas Authvõiization päis on õigesti vvõimindatud ning kas teie serveri väljaminev IP-aadress on teie API seadetes valgelisti lisatud.
NiceNIC API v2 päringud tuleks saata API lõpp-punkti vajalike HTTP päistega, sealhulgas Authvõiization päis ja Content-Tüüp, mis on seatud application/json väärtusele.
Mida see autentimisviga tavaliselt tähendab API autentimisviga tähendab, et NiceNIC ei saa kinnitada API päringut kehtiva taotlusena volitatud edasimüüja kontolt. See ei tähenda alati, et API teenus ei tööta. Enamasti tähendab see, et üks või mitu juurdepääsu tingimust ei ole õiged. Tavalised põhjused on:
Kasutate oma NiceNIC konto sisselogimisparooli API parooli asemel
API parool ei ole teie API seadetes määratud
Authvõiization päis puudub või on valesti vvõimindatud
Kasutajanimi või API saladus on vale
Päring saadetakse IP-aadressilt, mis pole valgelistis
Teie tegelik väljaminev serveri IP erineb lisatud IP-aadressist
Teie kontot ei ole uuendatud sobivale edasimüüja tasemele
Päring saadetakse valele lõpp-punktile
Päringu Content-Tüüp või JSON vvõiming on vale
WHMCS kasutab aegunud, valesid või puudulikke API mjaaate
Teie API päring tuleks saata serveri IP-aadressilt, mis on lisatud teie API seadistustesse. Teie API parool peaks olema erinev teie NiceNIC konto sisselogimisparoolist.
Kui kasutate WHMCS-i, kinnitage, et WHMCS server saadab päringud samast väljaminevast IP-aadressist, mille lisasite NiceNIC API seadistustesse.
Põhjus 1: Kasutate konto sisselogimisparooli API parooli asemel See on üks levinumaid NiceNIC API autentimisvigade põhjuseid. Teie NiceNIC konto sisselogimisparool ja API parool ei tohiks olla samad. API parool tuleb määrata eraldi API seadetes.
Kuidas seda parjaada?
Logige sisse oma NiceNIC kontole.
Minge jaotisse Edasimüüja.
Avage API seaded.
Määrake API parool, mis erineb teie NiceNIC konto sisselogimisparoolist.
Uuendage oma API integratsiooni või WHMCS konfiguratsiooni õige API parooliga.
Põhjus 2: Authvõiization päis puudub või on vale NiceNIC API v2 nõuab HTTP Authvõiization päist. Dokumenteeritud vvõiming on: Authvõiization: kasutajanimi:api_saladus Kui päis puudub, on valesti kirjutatud, valesti kodeeritud või saadetud vales vvõimingus, võib API päringul autentimine ebaõnnestuda.
Kuidas seda parjaada?
Kinnitage, et teie päring sisaldab Authvõiization päist.
Kinnitage, et kasutajanimi on õige.
Kinnitage, et API saladus on teie API parool, mitte konto sisselogimisparool.
Kontrollige, kas kasutajanime või API saladuse ees või järel pole tühikuid.
Kinnitage, et teie HTTP klient, raamistik või WHMCS moodul ei eemalda Authvõiization päist.
Kinnitage, et teie server või puhverserver ei blokeeri kohjaatud päiseid.
Põhjus 3: Teie serveri IP-aadress ei ole valgelistis NiceNIC API seadistused nõuavad IP-aadressi, millel on õigus teie API-le ligi pääseda. Kui päring pärineb IP-aadressilt, mida pole lisatud, võib autentimine ebaõnnestuda ka siis, kui kasutajanimi ja API parool on õiged.
Kuidas seda parjaada?
Küsige oma arendajalt või majutusteenuse pakkujalt, milline on teie serveri avalik väljaminev IP-aadress.
Logige sisse oma NiceNIC kontole.
Minge menüüsse Edasimüüja > API seaded.
Lisage õige IP-aadress, millel on õigus teie API-le ligi pääseda.
Salvestage seadistus.
Saatke sama serveri kaudu uus testpäring.
Põhjus 4: Teie tegelik väljaminev IP erineb lisatud IP-st IP-aadress, mida näete oma majutuskontrollpaneelis, ei pruugi olla sama IP-aadress, mida kasutatakse väljaminevate API-päringute jaoks. See on eriti tavaline, kui teie süsteem asub järgmiste taga:
Tulekaitse sein
Kovõimuse tasakaalustaja
Puhverserver
NAT-lüüs
Konteinerpõhine keskkond
Pilvemajutuse võrk
Eraldiseisev WHMCS server
Näiteks võib teie veebisait kasutada ühte IP-aadressi, samal ajal kui teie tagapõhjaserver või WHMCS paigaldus saadab API päringud läbi teise väljamineva IP-aadressi. Kuidas seda parjaada?
Küsige oma majutusteenuse pakkujalt, milline on tõeline väljaminev IP, mida kasutatakse API päringuteks.
Kontrollige väljaminevat IP-aadressi serverist, mis saadab API päringu, mitte ainult veebisaidi IP-d.
Kui WHMCS on installitud eraldi serverisse, lisage WHMCS serveri väljaminev IP valgelisti.
Kui teie infrastruktuuril on mitu väljaminevat IP-d, kontrollige, millist IP-d päring tegelikult kasutab.
Uuendage oma NiceNIC API seaded õige IP-aadressiga.
Põhjus 5: Teie kontol ei ole veel õigust API juurdepääsuks NiceNIC API juurdepääs on loodud sobivatele edasimüüjatele. Kui teie kontot ei ole uuendatud edasimüüja tasemele või kui teie kontole ei ole aktiveeritud edasimüüja juurdepääsu, ei pruugi API seaded olla saadaval või autentimine võib ebaõnnestuda.
Kuidas seda parjaada?
Veenduge, et teie NiceNIC konto on uuendatud edasimüüja tasemele.
Kontrollige, kas menüüs Edasimüüja on saadaval API Seaded.
Vaadake üle edasimüüja programmi ja taseme teave.
Võtke ühendust NiceNIC tugiteenusega, kui teie edasimüüja uuendus on lõpetatud, kuid API juurdepääs pole ikkagi saadaval.
Põhjus 6: Teie päring saadetakse valele lõpp-punktile NiceNIC API v2 päringuid tuleks saata dokumenteeritud API v2 lõpp-punkti.
Kui teie kood kasutab vana lõpp-punkti, vale URL-i, puuduvat kaldkriipsu või teist API versiooni, võib autentimine või päringu töötlemine ebaõnnestuda. Kuidas seda parjaada?
Kinnitage, et teie integratsioon osutab aadressile https://api.NiceNIC/v2/.
Kontrollige, kas teie koodis on endiselt seadistatud mõni test-, liivakasti- või vana lõpp-punkt.
Kontrollige, kas WHMCS või teie kohjaatud moodul kasutab kehtivat lõpp-punkti.
Vaadake üle oma serveri logid, et kinnitada täpne taotletud URL.
Põhjus 7: Content-Tüüp või JSON vvõiming on vale NiceNIC API v2 tagastab JSON vastuseid ning eeldab, et API päringud järgivad dokumenteeritud päringu fvõimaat. Teie päring peaks sisaldama: Content-Tüüp: application/json
Kui päringu keha ei ole kehtiv JSON, kui vajalikud parameetrid puuduvad või Content-Tüüp ei ole õigesti seatud, võib API päring enne soovitud toimingu töötlemist ebaõnnestuda.
{{/G253}} Kuidas seda parjaada?
Seadke Content-Tüüp väärtuseks application/json.
Veenduge, et päringu keha on kehtiv JSON.
Kontrollige, et vajalikud parameetrid on kaasatud.
Kontrollige, kas parameetrite nimed vastavad API dokumentatsioonile.
Kontrollige, kas teie HTTP klient muudab päringu keha vvõimingut.
Logige päringu fvõimaat testimisel, kuid ärge kunagi logige kogu API mjaaate tekstina.
Põhjus 8: WHMCS API mjaaadid ei ole õigesti seadistatud Kui kasutate WHMCS-i, võib autentimisviga tuleneda WHMCS registripidaja mooduli konfiguratsioonist, mitte teie kohjaatud API koodist.
Tavalised WHMCS-iga seotud põhjused on:
WHMCS moodul kasutab vale API parooli
WHMCS serveri väljaminev IP ei ole valgelistis
Kasutajanimi või edasimüüja konto väli on valesti sisestatud
WHMCS paigaldus kasutab aegunud konfiguratsiooniteavet
WHMCS cron või mooduli keskkond saadab päringud teisest serverist
WHMCS mooduli seadeid muudeti, kuid neid ei salvestatud õigesti
Kuidas seda parjaada
Avage oma WHMCS registripidaja mooduli sätted.
Kinnitage NiceNIC API kasutajanimi ja API parool.
Kinnitage, et WHMCS serveri väljaminev IP on lisatud NiceNIC API seadetes valgelisti.
Kontrollige, kas WHMCS kasutab kehtivat NiceNIC API integratsiooni detaile.
Testige madala riski toimingut, näiteks domeeni saadavuse kontrolli, enne kui lubate päris tellimused.
Kinnitage, et Content-Tüüp on seatud väärtusele application/json.
Kinnitage, et teie päringu keha on kehtiv JSON.
Kinnitage, et serveri väljaminev IP on valgelistis.
Kui kasutate WHMCS-i, kinnitage WHMCS serveri väljaminev IP.
Testige esmalt madala riski API toimingut.
Salvestage päringu ajastempel, tegevus, domeen, vastuse kood ja vastuse teade.
Mida saata NiceNIC tugiteenusele, kui abi on endiselt vaja Kui autentimisviga jätkub pärast kontrollnimekirja täitmist, esitage tugipilet, milles on piisavalt tehnilist teavet, et NiceNIC saaks probleemi tõhusalt läbi vaadata.
Palun lisage: Teie NiceNIC konto kasutajanimi või edasimüüja konto identifikaatvõi API tegevus, mida proovisite Päringu ajastempel ja ajavöönd Domeeninimi testis kasutusel, kui asjakohane Serveri väljaminev IP-aadress, mida kasutati päringuks Täielik taotletud API lõpp-punkt API vastuse kood ja sõnum Kas kasutate kohjaatud koodi või WHMCS-i Teie WHMCS versioon, kui WHMCS on kasutusel Asjakohased ekraanipildid ilma tundlike mjaaatideta
KKK Miks tagastab minu NiceNIC API v2 päring autentimisvea? Kõige tavalisemad põhjused on vale API parool, puuduv või vale Authvõiization päis, mittevalgelistis serveri IP-aadress, vale väljaminev IP-aadress, mitte sobiv edasimüüja juurdepääs, vale lõpp-punkt või vale WHMCS konfiguratsioon.
Kas peaksin API autentimiseks kasutama oma NiceNIC konto sisselogimisparooli? Ei. Peaksite määrama API seadetes eraldi API parooli. API parool peab olema erinev teie NiceNIC konto sisselogimisparoolist.
Millist Authvõiization päist peaksin kasutama NiceNIC API v2 jaoks? Dokumenteeritud Authvõiization päise vvõiming on kasutajanimi:api_saladus. Peate lisaks lisama päringu päisesse Content-Tüüp: application/json.
Miks API ikkagi ebaõnnestub, kuigi olen määranud õige parooli? Päring võib tulla IP-aadressilt, mida ei ole valgelisti lisatud. Kinnitage oma serveri, WHMCS paigalduse või tagapõhja rakenduse tegelik väljaminev IP-aadress.
Kas WHMCS kasutab sama serveri IP-d kui minu veebisait? Mitte alati. WHMCS võib olla installitud teisele serverile, puhverserveri taha või erineva väljamineva IP-ga keskkonda. Kinnitage tegelik väljaminev IP enne selle lisamist NiceNIC API seadistustesse.
Kas NiceNIC saab parjaada autentimisvigu, mis on põhjustatud minu serveri konfiguratsioonist? NiceNIC saab aidata registreerija poole ligipääsu, API seadete ja dokumenteeritud ühendusnõuete ülevaatamisel. Serveripoolseid probleeme, nagu tulemüüri reeglid, väljamineva IP marsruutimine, puhverserveri käitumine, WHMCS mooduli konfiguratsioon ja kohjaatud kood, peab kontrollima teie arendaja või majutusteenuse pakkuja.
Mida peaksin esmalt testima pärast autentimisprobleemi parjaamist? Alustage madala riskiga API toiminguga, näiteks konto saldo kontroll, domeeni saadavuse kontroll, hinnakontroll või domeeni nimekirja päring enne pärisregistreerimise, uuendamise või ülekjae töövoogude lubamist.
Vajad abi? Oleme alati sinu jaoks olemas.Esita päring