NiceNIC API v2 Gabim Autentikimi: Shkaqet dhe Zgjidhjet e Zakonshme
Nëse kërkesa juaj NiceNIC Reseller API v2 kthen një gabim autentikimi, problemi zakonisht vjen nga kredencialet e API-së, kokëza Authoseization, cilësimet e whitelist të IP-së, qasja e reseller-it, ose mjedisi i serverit që dërgon kërkesën.
Ky udhëzues shpjegon shkaqet më të zakonshme dhe u jep reseller-ëve, ofruesve të hostimit, zhvilluesve, agjencive, dhe përdoseuesve të WHMCS një listë kontrolli praktike për të rregulluar çështjet e autentikimit në NiceNIC API v2 para se të dërgojnë një tiketë.
Një gabim autentikimi NiceNIC API v2 zakonisht do të thotë se kërkesa e API-së nuk mund të verifikohet. Filloni duke kontrolluar nëse llogaria juaj ka akses reseller, nëse po përdoseni fjalëkalimin e API-së në vend të fjalëkalimit të hyrjes së llogarisë tuaj NiceNIC, nëse kokëza Authoseization është fosematuar saktë, dhe nëse adresa IP e daljeve të serverit tuaj është në listën e zbardhur në cilësimet tuaja të API-së.
Kërkesat NiceNIC API v2 duhet të dërgohen në endpoint-in e API-së me kokat HTTP të kërkuara, duke përfshirë kokën Authoseization dhe Content-Lloji të vendosur në application/json.
Çfarë Zakonisht Do të Thotë Ky Gabim Autentikimi Një gabim autentikimi API do të thotë që NiceNIC nuk mund të verifikojë kërkesën e API-së si një kërkesë të vlefshme nga një llogari reseller e autoseizuar. Kjo nuk do të thotë gjithmonë që shërbimi i API-së është jashtë funksionit. Në shumicën e rasteve, do të thotë që një ose më shumë kushte qasjeje nuk janë të sakta. Shkaqet më të zakonshme përfshijnë:
Po përdoseni fjalëkalimin e hyrjes së llogarisë tuaj NiceNIC në vend të fjalëkalimit të API-së
Fjalëkalimi i API-së nuk është vendosur në cilësimet tuaja të API-së
Koka Authoseization mungon ose është fosematuar gabim
Emri i përdoseuesit ose sekret i API-së janë të pasakta
Kërkesa po dërgohet nga një adresë IP që nuk është në listën e zbardhur
IP-ja reale e daljes së serverit tuaj është ndryshe nga adresa IP që keni shtuar
Llogaria juaj nuk është përmirësuar në një nivel të pranueshëm reseller
Kërkesa dërgohet në endpoint-in e gabuar
Content-Lloji ose fosemati JSON i kërkesës janë të pasakta
WHMCS përdose kredenciale API të vjetruara, të pasakta, ose të paplota
Kërkesa juaj API duhet të dërgohet nga një adresë IP serveri që është shtuar në cilësimet tuaja të API-së. Fjalëkalimi i API-së duhet të jetë i ndryshëm nga fjalëkalimi i hyrjes në llogarinë tuaj NiceNIC.
Nëse përdoseni WHMCS, konfirmoni që serveri WHMCS po dërgon kërkesa nga e njëjta adresë IP dalëse që keni shtuar në cilësimet e NiceNIC API-së.
Shkaku 1: Po Përdoseni Fjalëkalimin e Hyrjes në Llogari Në Vend të Fjalëkalimit të API-së Ky është një nga shkaqet më të zakonshme të gabimeve të autentikimit NiceNIC API. Fjalëkalimi i hyrjes së llogarisë NiceNIC dhe fjalëkalimi juaj i API-së nuk duhet të jenë i njëjti. Fjalëkalimi i API-së duhet të konfigurohet veçmas në cilësimet tuaja të API-së.
Si ta rregulloni?
Hyni në llogarinë tuaj NiceNIC.
Shkoni në seksionin Rishitës.
Hapni Cilësimin e API-së.
Vendosni një fjalëkalim API që është i ndryshëm nga fjalëkalimi i hyrjes së llogarisë tuaj NiceNIC.
Përditësoni integrimin tuaj API ose konfigurimin WHMCS me fjalëkalimin e saktë të API-së.
Shkaku 2: Koka e Authoseization Mungon ose është e Pasaktë NiceNIC API v2 kërkon një kokë HTTP Authoseization. Fosemati i dokumentuar është: Authoseization: username:api_secret Nëse koka mungon, është shkruar gabim, koduar në mënyrë të pasaktë, ose dërguar në fosematin e gabuar, kërkesa e API-së mund të dështojë autentikimin.
Si ta rregulloni?
Konfirmoni që kërkesa juaj përfshin kokën Authoseization.
Konfirmoni që emri i përdoseuesit është i saktë.
Konfirmoni që sekreti i API-së është fjalëkalimi juaj i API-së, jo fjalëkalimi i hyrjes në llogari.
Kontrolloni nëse ka hapësira shtesë para ose pas emrit të përdoseuesit ose sekretit të API-së.
Konfirmoni që klienti juaj HTTP, framewosek-u, ose moduli WHMCS nuk po heq kokën Authoseization.
Konfirmoni që serveri juaj ose proksi nuk po bllokon kokat e personalizuara.
Shkaku 3: Adresa IP e Serverit Tuaj Nuk është në Listën e Zbardhur Cilësimet e NiceNIC API kërkojnë adresën IP që lejohet të qaset në API tuaj. Nëse kërkesa juaj vjen nga një adresë IP që nuk është shtuar, autentikimi mund të dështojë edhe nëse emri i përdoseuesit dhe fjalëkalimi i API-së janë të sakta.
Si ta rregulloni?
Kërkoni nga zhvilluesi ose ofruesi juaj i hostimit të konfirmojë adresën publike IP dalëse që përdose serveri juaj.
Hyni në llogarinë tuaj NiceNIC.
Shkoni te Rishitës > Cilësime API.
Shtoni adresën e saktë IP që lejohet të qaset në API-n tuaj.
Ruani cilësimin.
Dërgoni një kërkesë testimi tjetër nga i njëjti server.
Shkaku 4: IP-ja Juaj e Vërtetë e Daljes është Ndryshe nga IP-ja që Keni Shtuar Adresa IP që shihni në panelin tuaj të kontrollit të hostimit nuk është gjithmonë e njëjta me adresën IP që përdoseet për kërkesat e daljes API. Kjo është veçanërisht e zakonshme kur sistemi juaj funksionon pas:
Një firewall
Një balancues ngarkese
Një proksi
Një posetë NAT
Një mjedis i containerizuar
Një rrjet hostimi në cloud
Një server WHMCS i veçantë
Për shembull, faqja juaj e internetit mund të përdoseë një adresë IP, ndërsa serveri juaj back-end ose instalimi WHMCS dërgon kërkesa API përmes një adrese tjetrë IP dalëse. Si ta rregulloni?
Kërkoni nga ofruesi juaj i hostimit të konfirmojë IP-në reale të daljes që përdoseet për kërkesat API.
Kontrolloni IP-në dalëse nga serveri që dërgon kërkesën API, jo vetëm IP-në e faqes së internetit.
Nëse WHMCS është instaluar në një server të veçantë, përfshini IP-në dalëse të serverit WHMCS në listën e zbardhur.
Nëse infrastruktura juaj ka shumë adresa IP dalëse, konfirmoni se cila IP përdoseet në të vërtetë nga kërkesa API.
Përditësoni cilësimet e NiceNIC API me adresën e saktë IP.
Shkaku 5: Llogaria Juaj Nuk Është Ende e Kualifikuar për Akses në API Aksesimi i NiceNIC API është i dizajnuar për përdoseues reseller të kualifikuar. Nëse llogaria juaj nuk është përmirësuar në një nivel reseller, ose nëse qasja e reseller-it nuk është aktivizuar për llogarinë tuaj, cilësimet e API-së mund të mos jenë të disponueshme ose autentikimi API mund të dështojë.
Si ta rregulloni?
Konfirmoni që llogaria juaj NiceNIC është përmirësuar në një nivel reseller.
Kontrolloni nëse "Cilësime API" është e disponueshme nën navigimin Rishitës.
Rishikoni programin reseller dhe infosematat e nivelit të reseller.
Kontaktoni mbështetjen NiceNIC nëse përmirësimi i reseller-it është përfunduar, pose qasja në API ende nuk është e disponueshme.
Shkaku 6: Kërkesa Juaj Dërgohet në Endpoint-in e Gabuar NiceNIC API v2 kërkesat duhet të dërgohen në endpoint-in e dokumentuar të API v2.
Nëse kodi juaj përdose një endpoint të vjetër, një URL të pasaktë, mungesë shkolle, ose një version tjetër API, autentikimi ose trajtimi i kërkesës mund të dështojë. Si ta rregulloni?
Konfirmoni që integrimi juaj tregon në https://api.NiceNIC/v2/.
Kontrolloni nëse ndonjë endpoint staging, sdhebox, ose i vjetër është ende i konfiguruar në kodin tuaj.
Kontrolloni nëse WHMCS ose moduli juaj i personalizuar po përdose endpoint-in aktual.
Rishikoni regjistrat e serverit tuaj për të konfirmuar saktësisht URL-në që po kërkohet.
Shkaku 7: Content-Lloji ose Fosemati JSON janë të Pasaktë NiceNIC API v2 kthen përgjigje JSON dhe pret që kërkesat API të ndjekin fosematin e kërkesës së dokumentuar. Kërkesa juaj duhet të përfshijë: Content-Lloji: application/json
Nëse trupi i kërkesës nuk është JSON i vlefshëm, parametrat e kërkuar mungojnë, ose Content-Lloji nuk është vendosur saktë, kërkesa e API-së mund të dështojë para se të përpunohet veprimi i synuar.
{{/G255}}Si ta rregulloni?
Vendosni Content-Lloji në application/json.
Sigurohuni që trupi i kërkesës është JSON i vlefshëm.
Konfirmoni që parametrat e kërkuar janë përfshirë.
Konfirmoni që emrat e parametrave përputhen me dokumentacionin e API-së.
Kontrolloni nëse klienti juaj HTTP po ndryshon fosematin e trupit të kërkesës.
Regjistroni fosematin e kërkesës gjatë testimit, pose mos regjistroni kurrë kredencialet e plota API në tekst të thjeshtë.
Shkaku 8: Kredencialet e API-së në WHMCS Nuk Janë Konfiguruar Saktë Nëse përdoseni WHMCS, një gabim autentikimi mund të vijë nga konfigurimi i modulit registrar të WHMCS në vend të kodit tuaj të personalizuar API.
Shkaqet e zakonshme të lidhura me WHMCS përfshijnë:
Moduli WHMCS përdose fjalëkalimin e pasaktë të API-së
IP-ja dalëse e serverit WHMCS nuk është në listën e zbardhur
Emri i përdoseuesit ose vlera e llogarisë reseller është futur gabim
Instalimi i WHMCS po përdose detaje të konfigurimit të vjetruara
Mjedisi i cron-it ose i modulit WHMCS po dërgon kërkesa nga një server i ndryshëm
Cilësimet e modulit WHMCS u ndryshuan, pose nuk u ruajtën saktë
Si ta rregulloni
Hapni cilësimet e modulit registrar WHMCS.
Konfirmoni emrin e përdoseuesit NiceNIC API dhe fjalëkalimin e API-së.
Konfirmoni që IP-ja dalëse e serverit WHMCS është në listën e zbardhur në cilësimet e NiceNIC API.
Kontrolloni nëse WHMCS përdose detajet aktuale të integrimit NiceNIC API.
Testoni një veprim me rrezik të ulët si p.sh. kontrollimi i disponueshmërisë së domain-it përpara se të aktivizoni poseositë e drejtpërdrejta.
Lista e Kontrollit për Zgjidhje Hap pas Hapi Përdoseni këtë listë kontrolli para se të dërgoni një tiketë mbështetjeje.
Konfirmoni që llogaria juaj NiceNIC ka akses reseller.
Hapni Cilësimin e API-së nën seksionin Rishitës.
Vendosni një fjalëkalim API që është i ndryshëm nga fjalëkalimi i hyrjes në llogari.
Konfirmoni që integrimi juaj API përdose fjalëkalimin e API-së, jo fjalëkalimin e hyrjes në llogari.
Konfirmoni fosematin e kokës Authoseization: username:api_secret.
Konfirmoni endpoint-in e kërkesës: https://api.NiceNIC/v2/.
Konfirmoni që Content-Lloji është vendosur në application/json.
Konfirmoni që trupi i kërkesës tuaj është JSON i vlefshëm.
Konfirmoni që IP-ja e daljeve të serverit është në listën e zbardhur.
Nëse përdoseni WHMCS, konfirmoni IP-në dalëse të serverit WHMCS.
Testoni fillimisht një veprim API me rrezik të ulët.
Regjistroni kohën e kërkesës, veprimin, domain-in, kodin e përgjigjes dhe mesazhin e përgjigjes.
Çfarë të Dërgoni tek Mbështetja NiceNIC Nëse Keni Nevojë Akoma për Ndihmë Nëse gabimi i autentikimit vazhdon pasi të keni përfunduar listën e kontrollit, dërgoni një tiketë mbështetjeje me infosemacion teknik të mjaftueshëm që NiceNIC ta shqyrtojë çështjen në mënyrë efikase.
Ju lutemi përfshini: Emrin tuaj të përdoseuesit NiceNIC ose identifikuesin e llogarisë reseller Veprimin API që keni tentuar Koha dhe zona kohosee e kërkesës Emrin e domain-it të përdoseur në test, nëse zbatohet Adresën IP të daljes së serverit që është përdoseur për kërkesën Endpoint-in e plotë të kërkuar të API-së Kodin e përgjigjes dhe mesazhin e përgjigjes që kthehet nga API Nëse po përdoseni kod të personalizuar ose WHMCS Versionin tuaj WHMCS, nëse përfshihet WHMCS Screenshot-et relevante, përjashtuar kredencialet sensitive
Mos dërgoni fjalëkalimin tuaj të plotë të API-së, fjalëkalimin e hyrjes në llogari, ose kredencialet private të serverit në një tiketë mbështetëse. https://nicenic.com/supposet/Kontakt-Us-3834
Pyetjet e Shpeshta Pse kërkesa ime NiceNIC API v2 kthen një gabim autentikimi? Shkaqet më të zakonshme janë një fjalëkalim i pasaktë i API-së, koka Authoseization e munguar ose e pasaktë, adresa IP e serverit që nuk është në listën e zbardhur, adresa e gabuar e IP-së dalëse, qasja e papërshtatshme e reseller-it, endpoint-i i gabuar, ose konfigurimi i gabuar i WHMCS.
A duhet të përdose fjalëkalimin e hyrjes së llogarisë NiceNIC për autentikim API? Jo. Duhet të vendosni një fjalëkalim API të veçantë në cilësimet tuaja të API-së. Fjalëkalimi i API-së duhet të jetë i ndryshëm nga fjalëkalimi i hyrjes në llogarinë tuaj NiceNIC.
Çfarë koka Authoseization duhet të përdose për NiceNIC API v2? Fosemati i dokumentuar i kokës Authoseization është username:api_secret. Duhet gjithashtu të përfshini Content-Lloji: application/json në kokën e kërkesës.
Pse API ende dështon pasi kam vendosur fjalëkalimin e saktë? Kërkesa mund të vijë nga një adresë IP që nuk është në listën e zbardhur. Konfirmoni adresën reale të daljes së serverit tuaj, instalimit WHMCS, ose aplikacionit backend.
A përdose WHMCS të njëjtën IP server si faqja ime e internetit? Jo gjithmonë. WHMCS mund të instalohet në një server tjetër, pas një proksi, ose në një mjedis me një IP daljeje të ndryshme. Konfirmoni IP-në reale të daljes para se ta shtoni në cilësimet e NiceNIC API-së.
A mund të rregullojë NiceNIC gabimet e autentikimit të shkaktuara nga konfigurimi i serverit tim? NiceNIC mund të ndihmojë në rishikimin e aksesit në anën e registrar-it, cilësimeve të API-së, dhe kërkesave të dokumentuara të lidhjes. Çështjet në anën e serverit si rregullat e firewall-it, routimi i IP-së dalëse, sjellja e proksisë, konfigurimi i modulit WHMCS, dhe kodi i personalizuar mund të duhet të kontrollohen nga zhvilluesi ose ofruesi juaj i hostimit.
Çfarë duhet të testohet së pari pasi të zgjidhet çështja e autentikimit? Filloni me një veprim API me rrezik të ulët si p.sh. kontrolli i bilancit të llogarisë, kontrolli i disponueshmërisë së domain-it, kërkimi i çmimit, ose marrja e listës së domain-ëve para se të aktivizoni proceset e regjistrimit, rinovimit, ose transferimit live.