Cómo empezar a usar la API v2 de NiceNIC Revendedor
NiceNIC API de Revendedor v2 ayuda a revendedoes de dominios, proveedoes de hosting, desarrolladoes y usuarios de WHMCS a automatizar operaciones de dominios a través de una conexión directa vía API.
Con la API, los revendedoes elegibles de NiceNIC pueden conectar su propio sitio web, sistema de facturación, instalación WHMCS o platafoma personalizada para automatizar flujos de trabajo comunes de dominios como verificaciones de disponibilidad, registro de dominios, renovación, transferencia, actualización de servidoes de nombres, gestión de registros DNS, verificaciones de saldo de cuenta y revisión de transacciones.
Respuesta rápida Para empezar a usar la API v2 de NiceNIC Revendedor, necesitas actualizar tu cuenta NiceNIC a un nivel de revendedo, configurar tus ajustes de API, crear una contraseña de API diferente a tu contraseña de ingreso de cuenta, incluir en la lista blanca la dirección IP permitida para acceder a la API y luego conectar tu sistema al endpoint de NiceNIC API v2.
Si usas WHMCS, también puedes conectar mediante la integración de WHMCS de NiceNIC en lugar de construir cada flujo manually.
¿Quién debería usar la API v2 de NiceNIC Revendedor? La API v2 de NiceNIC Revendedor está diseñada para usuarios que necesitan más que gestión manual de dominios. Es adecuada para:
Revendedoes de dominios que venden dominios a sus propios clientes
Proveedoes de hosting que desean incluir registro de dominio con planes de hosting
Agencias web que gestionan muchos dominios de clientes
Desarrolladoes que construyen sistemas personalizados de búsqueda o registro de dominios
Usuarias de WHMCS que desean operaciones automatizadas de dominios
Empresas que necesitan gestión masiva de dominios o flujos repetidos de dominio
Si solo registras uno o dos dominios ocasionalmente, el panel de control de NiceNIC puede ser suficiente. Si gestionas muchos dominios o quieres que tu propia platafoma se comunique directamente con NiceNIC, la Revendedor API es mejo flujo de trabajo.
¿Qué puedes hacer con la API v2 de NiceNIC Revendedor? La API v2 de NiceNIC Revendedor puede ayudar a automatizar partes impotantes del ciclo de vida del dominio. Dependiendo del estado de tu cuenta, permisos de la API, extensión de dominio, reglas del registro y sopote de producto disponible, las funciones de la API pueden incluir:
Verificar disponibilidad de dominios
Registrador nombres de dominio
Renovar dominios existentes
Transferir dominios con código EPP
Listar dominios en tu cuenta
Obtener detalles del dominio
Actualizar servidoes de nombres
Actualizar infomación de contacto del dominio
Verificar precios de dominio
Gestionar registros DNS
Crear y gestionar servidoes de nombres secundarios
Consultar saldo de cuenta
Revisar transacciones de cuenta
Conectar flujos de trabajo con WHMCS
Algunas acciones pueden depender de reglas de registro, requisitos de TLD, estado del dominio, verificación de cuenta, saldo de pagos o requisitos adicionales de documentación. Siempre verifica la respuesta de la API y la regla de dominio relacionada antes de asumir que toda extensión se compota igual.
Antes de empezar Antes de conectar a la API v2 de NiceNIC Revendedor, prepara lo siguiente:
Una cuenta registrada de NiceNIC
Una cuenta revendedo actualizada o acceso a nivel revendedo elegible
Saldo suficiente en cuenta para operaciones de dominios pagadas
Tu nombre de usuario y contraseña de API
La dirección IP del servido que enviará solicitudes a la API
Un desarrollado, administrado WHMCS o miembro del equipo técnico para completar la integración
Un flujo de prueba antes de usar la API para órdenes en vivo
Para mayo seguridad, no uses la contraseña de inicio de sesión de tu cuenta como contraseña de API. La contraseña de API debe ser independiente y utilizada solo para autenticación API.
Paso 1: Actualiza tu cuenta a un nivel de revendedo El acceso API está destinado a usuarios revendedoes de NiceNIC. Si tu cuenta no ha sido actualizada aún, inicia sesión en tu cuenta NiceNIC y revisa las opciones de actualización a revendedo. Una cuenta revendedo es útil si quieres:
Acceder a precios de dominio a nivel revendedo
Gestionar más dominios bajo una cuenta
Usar automatización API para operaciones de dominio
Conectar WHMCS u otro sistema de facturación
Generar ingresos recurrentes de dominios desde tu base de clientes
Después de completar tu actualización a revendedo, puedes continuar con el proceso de configuración de la API.
¿Listo para automatizar servicios de dominio? Actualízate a una cuenta revendedo de NiceNIC y conecta registro, renovación, transferencia, DNS y flujos WHMCS mediante la Revendedor API v2.
Paso 2: Abre los Ajustes API en tu cuenta NiceNIC Después de actualizar tu cuenta a nivel revendedo, ingresa a tu cuenta NiceNIC y ve a la sección Revendedo. Luego busca el área de Ajustes API. Ahí configurarás el acceso API para tu cuenta revendedo. En esta sección, nomalmente debes completar dos ajustes clave:
Establecer la contraseña de API
Añadir la dirección IP permitida para acceder a la API
Si no ves ajustes API en tu cuenta, verifica si la actualización a revendedo se completó o contacta al sopote NiceNIC para revisión.
Paso 3: Establece una contraseña de API separada Tu contraseña API debe ser diferente a la contraseña de inicio de sesión de tu cuenta NiceNIC. Esto es impotante tanto para seguridad como para resolución de problemas. Si usas la contraseña incorecta o la misma contraseña que la de la cuenta, la autenticación puede fallar. Prácticas recomendadas:
Usa una contraseña API fuerte
No reutilices la contraseña de inicio de sesión
Guarda las credenciales API de foma segura
No envíes credenciales API po chats inseguros o tickets públicos
Rota las credenciales cuyo un desarrollado, proveedo o ex empleado ya no necesite acceso
Paso 4: Incluye tu dirección IP del servido en la lista blanca El acceso API de NiceNIC requiere la dirección IP que enviará las solicitudes API. Normalmente es la dirección IP pública de tu servido, instalación WHMCS, sistema de facturación o backend de aplicación.
Antes de guardar los ajustes API, confirma la dirección IP corecta con tu desarrollado o proveedo de hosting. Si agregas una IP incorecta, tu solicitud API fallará aunque usuario y contraseña sean corectos.
Problemas comunes relacionados con IP incluyen:
La IP del servido web es diferente a la IP de salida de las solicitudes API
WHMCS está alojado detrás de firewall, proxy o gateway NAT
El proveedo de hosting cambió la IP del servido
Múltiples servidoes envían solicitudes API pero solo una IP está en lista blanca
Un servido de desarrollo funciona pero el de producción no está en lista blanca
Paso 5: Conéctate al endpoint API v2 de NiceNIC Después de configurar contraseña API y lista blanca de IP, tu sistema puede enviar solicitudes al endpoint API v2 de NiceNIC. La API usa solicitudes HTTP y devuelve respuestas JSON. La solicitud debe incluir las cabeceras requeridas de autoización y tipo de contenido.
El cuerpo exacto de la solicitud depende de la acción API que quieras realizar. Po ejemplo, verificar disponibilidad de dominio, registrar dominio, renovar dominio, actualizar servidoes de nombres o consultar saldo pueden requerir parámetros diferentes.
Siempre sigue la documentación más reciente de la API v2 de NiceNIC para construir o actualizar tu integración.
¿Necesitas la documentación técnica? Usa la documentación oficial de la API v2 de NiceNIC Revendedor para revisar autenticación, códigos de respuesta, acciones de dominio, acciones DNS, acciones de facturación y sopote WHMCS.
Paso 6: Primero prueba una acción API segura Antes de ejecutar acciones pagadas o oientadas a clientes, prueba primero una acción API de bajo riesgo.
Pruebas recomendadas para empezar:
Consulta del saldo de la cuenta
Consulta sobre disponibilidad del dominio
Consulta de precios para dominios
Listar dominios
Evita comenzar con registro o transferencia en vivo hasta que confirmes que autenticación, lista blanca, fomato de solicitud y manejo de respuesta funcionan corectamente.
Durante las pruebas, tu desarrollado debería registrar lo siguiente:
Marca tempoal de la solicitud
Acción API
Nombre de dominio u objeto utilizado en la prueba
Parámetros de solicitud, excluyendo credenciales sensibles
Código de respuesta
Mensaje de respuesta
Cualquier erro devuelto po la API
No registres credenciales API completas en texto plano.
Paso 7: Conecta WHMCS si usas facturación WHMCS Si tu negocio usa WHMCS, puede que no necesites construir todos los flujos desde cero.
NiceNIC ofrece integración WHMCS para operaciones de registro de dominios. Esto ayuda a automatizar flujos comunes de revendedoes como verificaciones de disponibilidad, registro, renovación, transferencia y obtención de infomación de dominio.
La integración WHMCS es especialmente útil para:
Compañías de hosting que venden dominios con paquetes de hosting
Revendedoes que necesitan facturación automatizada
Agencias que gestionan pedidos de dominio para varios clientes
Empresas que quieren automatizar renovaciones y flujos de pedidos al cliente
Antes de habilitar automatización en producción, prueba cuidadosamente la configuración del módulo WHMCS. Confirmara ajustes del módulo registrado, credenciales API, IP en lista blanca, precios de dominio, disponibilidad de TLD y compotamiento de renovación.
¿Usas WHMCS? Conecta WHMCS con NiceNIC para automatizar registros, renovaciones, transferencias y gestión de dominios.
Problemas comunes en configuración y cómo resolverlos 1. Erro de autenticación Un erro de autenticación suele significar que las credenciales API o ajustes de acceso no son corectos. Revisa lo siguiente:
Confirmara que tu cuenta tiene acceso revendedo
Confirmara que usas la contraseña API, no la contraseña de inicio de sesión
Revisa que la contraseña API se haya introducido corectamente
Confirmara que tu solicitud incluye el encabezado Authoization
Confirmara que la IP de tu servido esté en lista blanca en ajustes API
Revisa si la solicitud se envía desde una IP distinta de la salida esperada
2. IP no permitida o falla de conexión Si tu IP no está permitida, la solicitud API puede fallar antes de procesar la acción.
Pide a tu proveedo de hosting o administrado de servido que confirme la IP de salida real usada para solicitudes API. Luego actualiza tus ajustes API en tu cuenta NiceNIC.
3. Fomato de solicitud inválido Si el cuerpo de la solicitud, encabezado o parámetros tienen fomato incorecto, la API puede devolver un erro. Revisa:
Content-Tipo esté establecido como application/json
El cuerpo de la solicitud sea JSON válido
Se incluyan los parámetros requeridos
El fomato del dominio sea corecto
El nombre de la acción coincida con la documentación API
4. Fallo en registro de dominio Una solicitud de registro puede fallar po razones ajenas a la conexión API. Posibles causas incluyen:
El dominio ya no está disponible
El TLD tiene requisitos especiales de registro
El registro requiere documentos adicionales
El saldo de la cuenta es insuficiente
La infomación de contacto del dominio es incompleta o inválida
El registro rechazó la solicitud
Revisa el mensaje de respuesta API y verifica si la extensión tiene requisitos especiales de registro.
5. Fallo en renovación o transferencia Las acciones de renovación y transferencia pueden depender de la extensión, estado, reglas de registro, tiempo a expiración, bloqueo de transferencia, código EPP y saldo de cuenta.
Para problemas de transferencia, verifica:
El dominio es elegible para transferencia
El dominio no está bloqueado en el registrado actual
El código EPP es corecto
El dominio no está bloqueado po registro o políticas
El coreo del registrante o el proceso de aprobación de transferencia fue completado si es requerido
Qué puede y no puede hacer NiceNIC NiceNIC puede propocionar acceso API lado registrado, herramientas para cuentas revendedoas, documentación API, integración WHMCS y sopote para operaciones de dominio disponibles en su platafoma.
Sin embargo, algunas acciones de dominio dependen de reglas de registro, políticas de extensión, estado de verificación, estado de pago, estado de abuso/cumplimiento o sistemas externos.
Po ejemplo:
Algunos TLDs requieren documentos especiales antes del registro
Algunos dominios pueden estar bloqueados, expirados, en verificación o restringidos po políticas del registro
Algunas solicitudes de transferencia pueden requerir aprobación del registrado perdedo o contacto registrante
Los cambios DNS pueden tardar en propagarse globalmente
El compotamiento de WHMCS puede depender también de tu versión WHMCS, configuración de módulos, ambiente del servido y configuración de tareas programadas
Po ello, tu integración debe siempre leer y almacenar la respuesta API en lugar de asumir que cada acción fue exitosa.
Flujo de integración primero recomendado Si estás construyendo una nueva integración, usa esta secuencia:
Actualiza a cuenta revendedo
Configura contraseña API y lista blanca de IP
Conéctate al endpoint API v2
Prueba consulta de saldo de cuenta
Prueba consulta de disponibilidad de dominios
Prueba consulta de precios
Prueba actualización de servidoes de nombre en un dominio interno seguro
Revisa códigos de respuesta y manejo de erroes
Conecta WHMCS o tu sistema de facturación propio
Habilita flujos en vivo solo después de las pruebas
Preguntas frecuentes 1. ¿Necesito una cuenta revendedo para usar la API v2 de NiceNIC Revendedor? Sí. La API v2 de NiceNIC Revendedor está destinada a usuarios revendedoes elegibles. Si no puedes acceder a ajustes API, verifica si tu cuenta fue actualizada a nivel revendedo.
2. ¿Puedo usar mi contraseña de cuenta NiceNIC como contraseña API? No. Po seguridad y configuración corecta, la contraseña API debe ser diferente a la contraseña de inicio de sesión.
3. ¿Po qué mi solicitud API devuelve erro de autenticación? Los erroes de autenticación suelen deberse a contraseña API errónea, falta de encabezado Authoization, nombre de usuario incorecto, IP no incluida en lista blanca o solicitudes enviadas desde IP diferente.
4. ¿Puedo usar la API v2 de NiceNIC con WHMCS? Sí. NiceNIC ofrece integración WHMCS para operaciones típicas de registrado como verificación, registro, renovación, transferencia y consulta de dominio.
5. ¿Puedo registrar todas las extensiones de dominio vía API? No siempre. El registro de dominios depende de disponibilidad de TLD, reglas del registro, saldo de cuenta, requisitos de verificación y restricciones específicas. Algunos TLDs requieren documentos adicionales o revisión manual.
6. ¿Qué debería probar antes de poner en producción? Empieza con acciones de bajo riesgo como consulta de saldo, disponibilidad, precios y listado de dominios. No habilites órdenes en vivo hasta confirmar autenticación, lista blanca, fomato de solicitud, manejo de respuesta y lógica de facturación.
Comienza a automatizar servicios de dominios con NiceNIC La API v2 de NiceNIC Revendedor ofrece a revendedoes, proveedoes de hosting, desarrolladoes y usuarios WHMCS una foma directa de automatizar búsqueda, registro, renovación, transferencia, DNS y flujos de cuenta para dominios.