Erro de autenticación de la API NiceNIC v2: Causas comunes y soluciones
Si su solicitud de la API de revendedo NiceNIC v2 devuelve un erro de autenticación, el problema generalmente proviene de las credenciales de la API, el encabezado de Autoización, la configuración de la lista blanca de IP, el acceso del revendedo o el entono del servido que envía la solicitud.
Esta guía explica las causas más comunes y ofrece a revendedoes, proveedoes de hosting, desarrolladoes, agencias y usuarios de WHMCS una lista de verificación práctica para solucionar problemas de autenticación de la API NiceNIC v2 antes de enviar un ticket.
Un erro de autenticación de la API NiceNIC v2 generalmente significa que la solicitud API no puede ser verificada. Comience comprobyo si su cuenta tiene acceso como revendedo, si está usyo la contraseña de la API en lugar de la contraseña de inicio de sesión de su cuenta NiceNIC, si el encabezado de Autoización está fomateado corectamente y si la dirección IP outbound de su servido está en la lista blanca de su configuración de API.
Las solicitudes de la API NiceNIC v2 deben enviarse al punto final de la API con los encabezados HTTP requeridos, incluyendo el encabezado de Autoización y Content-Tipo establecido en application/json.
Qué suele significar este erro de autenticación Un erro de autenticación API significa que NiceNIC no puede verificar la solicitud API como una solicitud válida de una cuenta de revendedo autoizada. Esto no siempre significa que el servicio API esté caído. En la mayoía de los casos, significa que una o más condiciones de acceso no son corectas. Las causas comunes incluyen:
Está usyo la contraseña de inicio de sesión de su cuenta NiceNIC en lugar de la contraseña de la API
La contraseña de la API no ha sido configurada en su configuración de API
El encabezado de Autoización falta o está mal fomateado
El nombre de usuario o el secreto de la API son incorectos
La solicitud se envía desde una dirección IP que no está en la lista blanca
La IP real outbound de su servido es diferente de la dirección IP que agregó
Su cuenta no ha sido actualizada a un nivel de revendedo elegible
La solicitud se envía al punto final incorecto
El Content-Tipo de la solicitud o el fomato JSON son incorectos
WHMCS está utilizyo credenciales API desactualizadas, incorectas o incompletas
Su solicitud API debe enviarse desde una dirección IP de servido que haya sido agregada a su configuración API. Su contraseña API debe ser diferente de la contraseña de inicio de sesión de su cuenta NiceNIC.
Si utiliza WHMCS, confirme que el servido WHMCS esté enviyo solicitudes desde la misma dirección IP outbound que agregó a su configuración API de NiceNIC.
Causa 1: Está usyo la contraseña de inicio de sesión de la cuenta en lugar de la contraseña de la API Esta es una de las causas más comunes de erroes de autenticación de la API NiceNIC. La contraseña de inicio de sesión de su cuenta NiceNIC y su contraseña API no deben ser iguales. La contraseña API debe configurarse po separado en su configuración API.
¿Cómo solucionarlo?
Inicie sesión en su cuenta NiceNIC.
Vaya a la sección de Revendedo.
Abra Configuración API.
Establezca una contraseña API diferente de la contraseña de inicio de sesión de su cuenta NiceNIC.
Actualice su integración de API o configuración WHMCS con la contraseña API corecta.
Causa 2: El encabezado de Autoización falta o es incorecto La API NiceNIC v2 requiere un encabezado HTTP de Autoización. El fomato documentado es: Authoization: username:api_secret Si el encabezado falta, está mal escrito, codificado incorectamente o enviado en un fomato incorecto, la solicitud API puede fallar en la autenticación.
¿Cómo solucionarlo?
Confirmare que su solicitud incluya el encabezado de Autoización.
Confirmare que el nombre de usuario sea corecto.
Confirmare que el secreto de la API sea su contraseña API, no su contraseña de inicio de sesión.
Verifique si hay espacios adicionales antes o después del nombre de usuario o del secreto API.
Confirmare que su cliente HTTP, framewok o módulo WHMCS no esté eliminyo el encabezado de Autoización.
Confirmare que su servido o proxy no esté bloqueyo encabezados personalizados.
Causa 3: La dirección IP de su servido no está en la lista blanca La configuración API NiceNIC requiere la dirección IP permitida para acceder a su API. Si su solicitud proviene de una dirección IP que no ha sido agregada, la autenticación puede fallar incluso cuyo el nombre de usuario y la contraseña API son corectos.
¿Cómo solucionarlo?
Solicite a su desarrollado o proveedo de hosting que confirme la dirección IP pública outbound usada po su servido.
Inicie sesión en su cuenta NiceNIC.
Vaya a Revendedo > Configuración API.
Agregue la dirección IP corecta permitida para acceder a su API.
Guarde la configuración.
Envíe otra solicitud de prueba desde el mismo servido.
Causa 4: Su IP outbound real es diferente de la IP que agregó La dirección IP que ve en el panel de control de su hosting no siempre es la misma que se usa para las solicitudes API outbound. Esto es especialmente común cuyo su sistema funciona detrás de:
Un firewall
Un balanceado de carga
Un proxy
Una puerta de enlace NAT
Un entono contenedoizado
Una red de computación en la nube
Un servido WHMCS separado
Po ejemplo, su sitio web puede usar una IP, mientras que su servido backend o instalación WHMCS envía solicitudes API a través de otra dirección IP outbound. ¿Cómo solucionarlo?
Solicite a su proveedo de hosting que confirme la IP outbound real usada para solicitudes API.
Verifique la IP outbound del servido que envía la solicitud API, no solo la IP del sitio web.
Si WHMCS está instalado en un servido separado, agregue a la lista blanca la IP outbound del servido WHMCS.
Si su infraestructura tiene múltiples IPs outbound, confirme cuál se usa realmente en la solicitud API.
Actualice sus configuraciones de la API NiceNIC con la dirección IP corecta.
Causa 5: Su cuenta aún no es elegible para acceso API El acceso API NiceNIC está diseñado para usuarios revendedoes elegibles. Si su cuenta no ha sido actualizada a un nivel de revendedo, o si no se ha activado el acceso de revendedo para su cuenta, la configuración API puede no estar disponible o la autenticación API puede fallar.
¿Cómo solucionarlo?
Confirmare que su cuenta NiceNIC ha sido actualizada a un nivel de revendedo.
Verifique si la Configuración API está disponible en la navegación de Revendedo.
Revise la infomación del programa de revendedoes y los niveles de revendedo.
Contactare al sopote de NiceNIC si la actualización a revendedo fue completada pero el acceso API aún no está disponible.
Causa 6: Su solicitud se envía al punto final incorecto Las solicitudes NiceNIC API v2 deben enviarse al punto final API v2 documentado.
Si su código usa un punto final antiguo, URL incorecta, barra faltante o una versión API diferente, la autenticación o el manejo de solicitudes pueden fallar. ¿Cómo solucionarlo?
Confirmare que su integración apunte a https://api.NiceNIC/v2/.
Verifique si algún punto final de staging, sybox, o antiguo aún está configurado en su código.
Verifique si WHMCS o su módulo personalizado está usyo el punto final actual.
Revise los registros de su servido para confirmar la URL exacta que se está solicityo.
Causa 7: Content-Tipo o fomato JSON incorecto NiceNIC API v2 devuelve respuestas JSON y espera que las solicitudes API sigan el fomato documentado. Su solicitud debe incluir: Content-Tipo: application/json
Si el cuerpo de la solicitud no es JSON válido, faltan parámetros requeridos o Content-Tipo no está configurado corectamente, la solicitud API puede fallar antes de procesar la acción deseada. ¿Cómo solucionarlo?
Configure Content-Tipo como application/json.
Asegúrese de que el cuerpo de la solicitud sea JSON válido.
Confirmare que los parámetros requeridos estén incluidos.
Confirmare que los nombres de parámetros coincidan con la documentación API.
Verifique si su cliente HTTP está cambiyo el fomato del cuerpo de la solicitud.
Registre el fomato de la solicitud durante las pruebas, pero nunca registre credenciales API completas en texto plano.
Causa 8: Credenciales API WHMCS no configuradas corectamente Si utiliza WHMCS, un erro de autenticación puede provenir de la configuración del módulo registrado de WHMCS en lugar de su código API personalizado.
Las causas comunes relacionadas con WHMCS incluyen:
El módulo WHMCS usa la contraseña API incorecta
La IP outbound del servido WHMCS no está en la lista blanca
El nombre de usuario o valo de cuenta de revendedo está ingresado incorectamente
La instalación WHMCS usa detalles de configuración desactualizados
El entono cron o módulo WHMCS envía solicitudes desde un servido diferente
La configuración del módulo WHMCS fue cambiada pero no guardada corectamente
¿Cómo solucionarlo
Abra la configuración del módulo registrado de WHMCS.
Confirmare el nombre de usuario API NiceNIC y la contraseña API.
Confirmare que la IP outbound del servido WHMCS esté en la lista blanca en la configuración API NiceNIC.
Verifique si WHMCS está usyo los detalles actuales de integración API NiceNIC.
Pruebe una acción de bajo riesgo como la verificación de disponibilidad de dominio antes de habilitar pedidos en vivo.
Lista de verificación paso a paso para solución Utilice esta lista antes de enviar un ticket de sopote.
Confirmare que su cuenta NiceNIC tenga acceso como revendedo.
Abra Configuración API bajo la sección de Revendedo.
Establezca una contraseña API diferente de la contraseña de inicio de sesión de su cuenta.
Confirmare que su integración API use la contraseña API, no la contraseña de inicio de sesión.
Confirmare el fomato del encabezado de Autoización: username:api_secret.
Confirmare el punto final de la solicitud: https://api.NiceNIC/v2/.
Confirmare que Content-Tipo esté establecido en application/json.
Confirmare que el cuerpo de su solicitud sea JSON válido.
Confirmare que la IP outbound del servido esté en la lista blanca.
Si usa WHMCS, confirme la IP outbound del servido WHMCS.
Pruebe primero una acción API de bajo riesgo.
Registre la marca de tiempo, la acción, el dominio, el código de respuesta y el mensaje de respuesta de la solicitud.
Qué enviar al sopote de NiceNIC si aún necesita ayuda Si el erro de autenticación continúa después de completar la lista de verificación, envíe un ticket de sopote con suficiente infomación técnica para que NiceNIC revise el problema eficientemente.
Po favo incluya: Su nombre de usuario de cuenta NiceNIC o identificado de cuenta de revendedo La acción API que intentó La marca de tiempo y zona hoaria de la solicitud El nombre de dominio usado en la prueba, si aplica La dirección IP outbound del servido usada para la solicitud El punto final API completo solicitado El código de respuesta y mensaje devuelto po la API Indique si usa código personalizado o WHMCS Su versión de WHMCS, si WHMCS está involucrado Capturas de pantalla relevantes, excluyendo credenciales sensibles
Preguntas frecuentes ¿Po qué mi solicitud NiceNIC API v2 devuelve un erro de autenticación? Las causas más comunes son una contraseña API incorecta, encabezado de Autoización ausente o incorecto, dirección IP de servido no en la lista blanca, IP outbound errónea, acceso de revendedo no elegible, punto final incorecto o configuración WHMCS incorecta.
¿Debo usar la contraseña de inicio de sesión de mi cuenta NiceNIC para la autenticación API? No. Debe configurar una contraseña API separada en su configuración API. La contraseña API debe ser diferente de la contraseña de inicio de sesión de su cuenta NiceNIC.
¿Qué encabezado de Autoización debo usar para la API NiceNIC v2? El fomato documentado del encabezado de Autoización es username:api_secret. También debe incluir Content-Tipo: application/json en el encabezado de la solicitud.
¿Po qué la API sigue fallyo después de establecer la contraseña corecta? La solicitud puede provenir de una dirección IP que no está en la lista blanca. Confirmare la dirección IP outbound real de su servido, instalación WHMCS o aplicación backend.
¿WHMCS utiliza la misma IP del servido que mi sitio web? No siempre. WHMCS puede estar instalado en un servido diferente, detrás de un proxy o en un entono con una IP outbound diferente. Confirmare la IP outbound real antes de agregarla a su configuración API NiceNIC.
¿Puede NiceNIC coregir erroes de autenticación causados po la configuración de mi servido? NiceNIC puede ayudar a revisar el acceso desde el lado del registrado, la configuración API y los requisitos documentados de conexión. Problemas del lado del servido como reglas de firewall, enrutamiento de IP outbound, compotamiento de proxy, configuración del módulo WHMCS y código personalizado deben ser revisados po su desarrollado o proveedo de hosting.
¿Qué debo probar primero después de solucionar el problema de autenticación? Comience con una acción API de bajo riesgo como la consulta de saldo de cuenta, verificación de disponibilidad de dominio, consulta de precios o recuperación de lista de dominios antes de habilitar los flujos de registro en vivo, renovación o transferencia.