X
פורסם: 2026-05-26 | עודכן: 2026-05-26
שגיאת אימות ב-NiceNIC API v2: סיבות נפוצות ופתרונות


אם בקשת NiceNIC Reseller API v2 שלך מחזירה שגיאת אימות, הבעיה בדרך כלל נובעת מאישורי API, כותרת Authאוization, הגדרות רשימת ה-IP המורשים, גישת המשווק, או סביבה של השרת ששולחת את הבקשה.

מדריך זה מסביר את הסיבות הנפוצות ביותר ומספק לרשמים, ספקי אירוח, מפתחים, סוכנויות, ומשתמשי WHMCS רשימת בדיקה מעשית לתיקון בעיות אימות NiceNIC API v2 לפני הגשת כרטיס תמיכה.

שגיאת אימות NiceNIC API v2 בדרך כלל משמעותה שהבקשה ל-API אינה ניתנת לאימות. התחל בבדיקה האם יש לחשבונך גישת משווק, האם אתה משתמש בסיסמה ל-API במקום בסיסמת הכניסה לחשבון NiceNIC שלך, האם כותרת Authאוization מעוצבת נכון, והאם כתובת ה-IP היוצאת של השרת שלך מופיעה ברשימת הכתובות המורשות בהגדרות ה-API שלך.

בקשות NiceNIC API v2 צריכות להישלח לנקודת הקצה של ה-API עם הכותרות HTTP הנדרשות, כולל כותרת Authאוization ו-Content-סוג שנקבע ל-application/json.



מה שהשגיאה באימות בדרך כלל מצביעה עליו
שגיאת אימות API משמעותה ש-NiceNIC אינו יכול לאמת את הבקשה ל-API כבעלת תוקף ממשווק מורשה. זאת לא תמיד אומרת ששירות ה-API אינו פעיל. ברוב המקרים, זה אומר שתנאי גישה אחד או יותר אינם נכונים.
הסיבות הנפוצות כוללות:
  • אתה משתמש בסיסמת כניסה לחשבון NiceNIC שלך במקום בסיסמת ה-API
  • סיסמת ה-API לא הוגדרה בהגדרות ה-API שלך
  • כותרת Authאוization חסרה או מעוצבת בצורה שגויה
  • שם המשתמש או סוד ה-API שגויים
  • הבקשה נשלחת מכתובת IP שאינה ברשימת הכתובות המורשות
  • כתובת ה-IP האמיתית היוצאת של השרת שונה מכתובת ה-IP שהוספת
  • החשבון שלך לא שודרג לרמת משווק זכאית
  • הבקשה נשלחת לנקודת קצה שגויה
  • סוג התוכן של הבקשה או פורמט JSON אינם נכונים
  • WHMCS משתמש באישורי API מיושנים, שגויים או לא שלמים
בקשת ה-API שלך צריכה להישלח מכתובת IP של שרת שהוספה בהגדרות ה-API שלך. סיסמת ה-API שלך צריכה להיות שונה מסיסמת הכניסה לחשבון NiceNIC שלך.

אם אתה משתמש ב-WHMCS, אשר שהשרת WHMCS שולח את הבקשות מאותה כתובת IP יוצאת שהוספת בהגדרות ה-API של NiceNIC שלך.


סיבה 1: אתה משתמש בסיסמת כניסה לחשבון במקום בסיסמת ה-API
זאת אחת הסיבות הנפוצות ביותר לשגיאות אימות ב-NiceNIC API. סיסמת הכניסה לחשבון NiceNIC שלך וסיסמת ה-API שלך לא צריכים להיות זהים. סיסמת ה-API חייבת להיות מוגדרת בנפרד בהגדרות ה-API שלך.

כיצד לתקן זאת?
  1. היכנס לחשבון NiceNIC שלך.
  2. גש אל סקטור המשווק.
  3. פתח את הגדרות ה-API.
  4. הגדר סיסמת API השונה מסיסמת הכניסה לחשבון NiceNIC שלך.
  5. עדכן את האינטגרציה של ה-API או את הגדרות ה-WHMCS עם סיסמת ה-API הנכונה.
  6. בדוק שוב את הבקשה ל-API.
למדריך התקנה קיים של NiceNIC API, עיין ב:
https://nicenic.com/suppאוt/API-NiceNIC-3824


סיבה 2: כותרת Authאוization חסרה או שגויה
NiceNIC API v2 דורש כותרת HTTP Authאוization. הפורמט המתועד הוא: Authאוization: username:api_secret
אם הכותרת חסרה, כתובה בצורה שגויה, מקודדת לא נכון, או נשלחת בפורמט שגוי, הבקשה ל-API עלולה להיכשל באימות.

כיצד לתקן זאת?
  • ודא שהבקשה שלך כוללת את כותרת Authאוization.
  • ודא ששם המשתמש נכון.
  • ודא שסוד ה-API הוא סיסמת ה-API שלך, לא סיסמת הכניסה לחשבון.
  • בדוק האם יש רווחים מיותרים לפני או אחרי שם המשתמש או סוד ה-API.
  • ודא שלקוח HTTP, המסגרת או מודול WHMCS שלך אינם מסירים את כותרת Authאוization.
  • ודא שהשרת שלך או ה-proxy אינם חוסמים כותרות מותאמות אישית.
השתמש בתיעוד הרשמי של API v2 לצורת החיבור הנוכחית:
https://nicenic.com/reseller/apiv2.php


סיבה 3: כתובת ה-IP של השרת שלך אינה ברשימת מורשים
הגדרות NiceNIC API דורשות את כתובת ה-IP המורשת לגשת ל-API שלך. אם הבקשה שלך מגיעה מכתובת IP שלא נוספה, האימות עשוי להיכשל גם כאשר שם המשתמש וסיסמת ה-API נכונים.

כיצד לתקן זאת?
  1. בקש מהמפתח או מספק האירוח שלך לאשר את כתובת ה-IP הציבורית היוצאת שבה משתמש השרת שלך.
  2. היכנס לחשבון NiceNIC שלך.
  3. גש ל-משווק > הגדרות API.
  4. הוסף את כתובת ה-IP הנכונה המורשית לגשת ל-API שלך.
  5. שמור את ההגדרה.
  6. שלח בקשת בדיקה נוספת מאותו שרת.

סיבה 4: ה-IP היוצא האמיתי שלך שונה מהכתובת שהוספת
כתובת ה-IP שאתה רואה בלוח הבקרה של האירוח שלך לא תמיד זהה לכתובת ה-IP המשמשת לבקשות API היוצאות.
זה נפוץ במיוחד כאשר המערכת שלך פועלת מאחורי:
  • חומת אש firewall
  • מאזן עומסים
  • פרוקסי
  • שער NAT
  • סביבה מנותבת במכולות
  • רשת אירוח ענן
  • שרת WHMCS נפרד
לדוגמה, אתר האינטרנט שלך עשוי להשתמש בכתובת IP אחת, בעוד שהשרת האחורי או התקנת WHMCS שולחים בקשות API דרך כתובת IP יוצאת שונה.
כיצד לתקן זאת?
  • בקש מספק האירוח שלך לאשר את הכתובת היוצאת האמיתית המשמשת לבקשות API.
  • בדוק את ה-IP היוצא מהשרת ששולח את הבקשה ל-API, לא רק את כתובת האתר.
  • אם WHMCS מותקן על שרת נפרד, הוסף את ה-IP היוצא של שרת ה-WHMCS לרשימת המורשים.
  • אם לאינפרא-סטרוקטורה שלך יש מספר כתובות IP יוצאות, אשר איזו כתובת IP משמשת בפועל בבקשה ל-API.
  • עדכן את הגדרות NiceNIC API שלך עם כתובת ה-IP הנכונה.

סיבה 5: החשבון שלך עדיין אינו זכאי לגישה ל-API
גישה ל-NiceNIC API מיועדת למשתמשים מורשים במשווק. אם חשבונך לא שודרג לרמת משווק, או אם לא הופעלה גישת משווק בחשבונך, ההגדרות ל-API עשויות שלא להיות זמינות או שהאימות ל-API עלול להיכשל.

כיצד לתקן זאת?
  • אשר שחשבון NiceNIC שלך שודרג לרמת משווק.
  • בדוק אם קיימת אפשרות הגדרות API בתפריט המשווק.
  • עיין במידע על תוכנית המשווקים ורמת המשווק.
  • פנה לתמיכה של NiceNIC אם השדרוג למשווק בוצע אך גישת API עדיין אינה זמינה.
דפים קשורים:
https://nicenic.com/reseller/
https://nicenic.com/suppאוt/API-משווק-רמה-3823


סיבה 6: הבקשה שלך נשלחת לנקודת קצה שגויה
NiceNIC API v2 חייבת להישלח לנקודת הקצה המתועדת של API v2.

אם הקוד שלך משתמש בנקודת קצה ישנה, בכתובת URL שגויה, חסר סלאש, או בגרסת API שונה, ייתכן שתקבל כישלון באימות או בטיפול בבקשה.
כיצד לתקן זאת?
  • ודא שהאינטגרציה שלך מצביעה על https://api.NiceNIC/v2/.
  • בדוק אם קיימת נקודת קצה של סביבה ניסיונית, סנדבוקס, או נקודת קצה ישנה שמוגדרת עדיין בקוד שלך.
  • בדוק אם WHMCS או המודול המותאם אישית שלך משתמשים בנקודת הקצה הנוכחית.
  • סקור את יומני השרת שלך כדי לוודא את כתובת ה-URL המלאה המבוקשת.

סיבה 7: Content-סוג או פורמט JSON שגויים
NiceNIC API v2 מחזיר תגובות JSON ומצפה שהבקשות ל-API יפעלו לפי פורמט הבקשה המתועד.
הבקשה שלך צריכה לכלול:
Content-סוג: application/json

אם גוף הבקשה אינו JSON תקין, פרמטרים נדרשים חסרים, או Content-סוג לא מוגדר נכון, הבקשה ל-API עלולה להיכשל לפני שנעשית הפעולה הרצויה.

{{/G252}}
כיצד לתקן זאת?

  • קבע Content-סוג ל-application/json.
  • ודא שגוף הבקשה הוא JSON תקין.
  • ודא שכל הפרמטרים הנדרשים כלולים.
  • ודא ששמות הפרמטרים תואמים לתיעוד ה-API.
  • בדוק האם לקוח ה-HTTP שלך משנה את פורמט גוף הבקשה.
  • רשום את פורמט הבקשה בזמן הבדיקה, אך לעולם אל תרשום פרטי אישור API מלאים בטקסט רגיל.

סיבה 8: אישורי API ל-WHMCS לא מוגדרים נכון
אם אתה משתמש ב-WHMCS, שגיאת אימות עשויה לנבוע מהגדרות מודול הרשם ב-WHMCS ולא מקוד ה-API המותאם אישית שלך.

סיבות נפוצות הקשורות ל-WHMCS כוללות:
  • מודול WHMCS משתמש בסיסמת API שגויה
  • כתובת ה-IP היוצאת של השרת WHMCS אינה ברשימת המורשים
  • שם המשתמש או ערך חשבון המשווק מולאו בצורה שגויה
  • התקנת WHMCS משתמשת בפרטי קונפיגורציה מיושנים
  • סביבת ה-cron או המודול של WHMCS שולחת בקשות משרת שונה
  • הגדרות מודול WHMCS שונו ללא שמירה נכונה
כיצד לתקן זאת
  1. פתח את הגדרות מודול הרשם של WHMCS.
  2. אשר את שם המשתמש וסיסמת ה-API של NiceNIC.
  3. אשר שכתובת ה-IP היוצאת של שרת WHMCS מופיעה ברשימת המורשים בהגדרות NiceNIC API.
  4. בדוק האם WHMCS משתמש בפרטי האינטגרציה הנוכחיים של NiceNIC API.
  5. בדוק פעולה עם סיכון נמוך כגון בדיקת זמינות דומיין לפני הפעלת הזמנות בשידור חי.
עיין בדף האינטגרציה של NiceNIC WHMCS כאן:
https://nicenic.com/reseller/whmcs.php


רשימת תיקון שלב אחר שלב
השתמש ברשימת בדיקה זו לפני הגשת כרטיס תמיכה.
  1. אשר שלחשבון NiceNIC שלך יש גישת משווק.
  2. פתח הגדרות API תחת סקטור המשווק.
  3. קבע סיסמת API שונה מסיסמת הכניסה לחשבון.
  4. אשר שהאינטגרציה שלך ל-API משתמשת בסיסמת ה-API, לא בסיסמת הכניסה.
  5. אשר את פורמט כותרת Authאוization: username:api_secret.
  6. אשר את נקודת הקצה של הבקשה: https://api.NiceNIC/v2/.
  7. אשר ש-Content-סוג נקבע ל-application/json.
  8. אשר שגוף הבקשה שלך הוא JSON תקין.
  9. אשר שכתובת ה-IP היוצאת של השרת מופיעה ברשימת המורשים.
  10. אם אתה משתמש ב-WHMCS, אשר את כתובת ה-IP היוצאת של שרת WHMCS.
  11. בדוק פעולה ב-API עם סיכון נמוך תחילה.
  12. תעד את זמן הבקשה, הפעולה, הדומיין, קוד התגובה והודעת התגובה.


מה לשלוח לתמיכה של NiceNIC אם אתה עדיין זקוק לעזרה
אם שגיאת האימות ממשיכה לאחר שסיימת את רשימת הבדיקה, הגש כרטיס תמיכה עם מידע טכני מספק כדי ש-NiceNIC יוכל לבדוק את הבעיה בצורה יעילה.

אנא כלול:
שם המשתמש שלך ב-NiceNIC או מזהה חשבון המשווק
הפעולה ב-API שניסית לבצע
חותמת הזמן של הבקשה ואזור הזמן
שם הדומיין ששימש בבדיקה, אם רלוונטי
כתובת ה-IP היוצאת של השרת ששימשה לבקשה
כתובת ה-API המלאה שביקשת
קוד התגובה והודעת התגובה שהוחזרו על ידי ה-API
האם אתה משתמש בקוד מותאם אישית או ב-WHMCS
גרסת WHMCS שלך, אם WHMCS מעורב
צילוםי מסך רלוונטיים, ללא אישורי כניסה רגישים

אל תשלח את סיסמת ה-API המלאה, סיסמת כניסה לחשבון או פרטי שרת פרטיים בכרטיס תמיכה.
https://nicenic.com/suppאוt/צור קשר-Us-3834


שאלות נפוצות
מדוע בקשת NiceNIC API v2 שלי מחזירה שגיאת אימות?
הסיבות השכיחות ביותר הן סיסמת API לא נכונה, כותרת Authאוization חסרה או שגויה, כתובת IP של שרת לא מורשת, כתובת IP יוצאת שגויה, גישת משווק שאינה זכאית, נקודת קצה שגויה, או קונפיגורציה שגויה של WHMCS.

האם עלי להשתמש בסיסמת הכניסה לחשבון NiceNIC שלי לאימות API?
לא. עליך להגדיר סיסמת API נפרדת בהגדרות ה-API שלך. סיסמת ה-API צריכה להיות שונה מסיסמת הכניסה לחשבון NiceNIC שלך.

איזו כותרת Authאוization עלי להשתמש עבור NiceNIC API v2?
פורמט כותרת Authאוization המתועד הוא username:api_secret. בנוסף, עליך לכלול Content-סוג: application/json בכותרת הבקשה.

מדוע ה-API עדיין נכשל לאחר שהגדרתי את הסיסמה הנכונה?
יתכן שהבקשה מגיעה מכתובת IP שאיננה ברשימת הכתובות המורשות. אשר את כתובת ה-IP היוצאת האמיתית של השרת שלך, התקנת WHMCS או היישום האחורי.

האם WHMCS משתמש באותה כתובת IP של השרת כמו האתר שלי?
לא תמיד. WHMCS עשוי להיות מותקן על שרת אחר, מאחורי פרוקסי, או בסביבה עם כתובת IP יוצאת שונה. אשר את כתובת ה-IP היוצאת בפועל לפני שתוסיף אותה להגדרות API של NiceNIC שלך.

האם NiceNIC יכול לתקן שגיאות אימות הנובעות מהגדרת השרת שלי?
NiceNIC יכולה לסייע בבדיקת גישת הצד של הרשם, הגדרות ה-API, ודרישות החיבור המתועדות. בעיות בצד השרת כגון כללי חומת אש, ניתוב IP יוצא, התנהגות פרוקסי, הגדרות מודול WHMCS וקוד מותאם אישית עשויות להצריך בדיקה על ידי המפתח או ספק האירוח שלך.

מה עלי לבדוק תחילה לאחר תיקון בעיית האימות?
התחל בפעולה ב-API עם סיכון נמוך כגון בדיקת יתרת חשבון, בדיקת זמינות דומיין, חיפוש מחירים או שליפת רשימת דומיינים לפני הפעלת רישום, חידוש או העברת דומיינים בשידור חי.
צריך עזרה? אנחנו תמיד כאן בשבילך. שלח פניה
זכויות יוצרים © 2006-2026 חברת NICENIC INTERNATIONAL GROUP CO., LIMITED כל הזכויות שמורות