Preguntas frecuentes sobre NiceNIC Domain API v2

NiceNIC Domain API v2 es una API basada en HTTPS y JSON para automatizar la gestión de dominios a través de su cuenta de NiceNIC.

Admite flujos de trabajo clave, como comprobación de disponibilidad de dominios, registro, renovación, transferencia, consultas de cartera, actualizaciones de servidores de nombres y contactos, precios, registros DNS, servidores de nombres personalizados, información de cuenta y operaciones relacionadas con el cumplimiento normativo.

Utilice la API cuando desee conectar los servicios de dominios de NiceNIC directamente a un sitio web, plataforma de alojamiento, sistema de facturación, herramienta interna u otra aplicación.

Cualquier cuenta activa de NiceNIC puede usar Domain API v2. El acceso a la API está disponible tanto para cuentas de Market como para cuentas de Revendedor.

No necesita convertirse en revendedor únicamente para obtener acceso a la API. El tipo de cuenta sigue siendo relevante para los precios: las operaciones de API de pago utilizan los precios asignados a la cuenta de NiceNIC que envía la solicitud.

Abra Configuración de API →

Sí. El acceso a la API en sí es gratuito. No hay ninguna tarifa adicional por habilitar el acceso a la API ni por enviar solicitudes de API compatibles.

Las operaciones de pago, como el registro, la renovación y la transferencia de dominios, se cobran según las tarifas de tu cuenta y las normas de dominio aplicables.

No. El acceso a la API y las tarifas de revendedor son independientes.

Puedes usar la API de dominios v2 con una cuenta de mercado normal de NiceNIC. Cambia a una cuenta de revendedor solo cuando las tarifas de revendedor u otros beneficios para revendedores sean útiles para tu volumen de negocio.

Comparar los planes de revendedor →

La API de dominios v2 usa la estructura actual de la API de NiceNIC, con solicitudes HTTPS, respuestas JSON, autenticación basada en cabeceras y documentación organizada en torno a flujos de trabajo de dominios y cuentas individuales.

Si mantienes una integración basada en una API anterior de NiceNIC, revisa los parámetros y la gestión de respuestas de la API v2 antes de migrar el tráfico de producción, en lugar de dar por hecho que las dos versiones son intercambiables.

Inicia sesión en tu cuenta de NiceNIC y abre Configuración de API. Las solicitudes de la API v2 utilizan tu nombre de usuario de NiceNIC y el secreto de API para autenticarse.

Abra Configuración de API →

Sí. NiceNIC ofrece un entorno de pruebas de API para que los desarrolladores prueben las integraciones antes de conectarlas a la API de producción.

Utilice el entorno de pruebas para validar la autenticación, el formato de las solicitudes, el análisis de las respuestas, el manejo de errores y el flujo de trabajo de su aplicación antes de activar operaciones de dominios reales para clientes.

Abrir el entorno de pruebas de API →

El entorno de pruebas de API está destinado al desarrollo y a las pruebas de integración. La API de producción se utiliza para operaciones de dominios reales y solicitudes de pago con cargo a su cuenta de NiceNIC.

Recomendamos validar la autenticación, el manejo de solicitudes, el procesamiento de respuestas y la lógica de errores en el entorno de pruebas antes de activar operaciones de producción orientadas al cliente.

Envíe solicitudes de API a través de HTTPS e incluya su nombre de usuario de NiceNIC y su secreto de API en el encabezado Authorization.

Host: api.nicenic.net
Authorization: username:api_secret
Content-Type: application/json

Si las restricciones de IP están habilitadas para su cuenta, las solicitudes también deben provenir de una IP de servidor autorizada.

Lea la autenticación de la API →

El endpoint base de la API de producción es:

https://api.nicenic.net/v2/

Las acciones de la API se seleccionan mediante los parámetros documentados para cada endpoint, como category y action. Siga siempre la documentación específica del endpoint para conocer los parámetros obligatorios y opcionales de una operación concreta.

Las respuestas de la API v2 usan JSON y los parámetros de solicitud usan UTF-8.

{
  "code": 0,
  "msg": "success",
  "data": {}
}

Su aplicación debe inspeccionar los campos code y msg devueltos, en lugar de asumir que cada respuesta HTTP representa una operación de dominio completada.

A través de las API documentadas actualmente, puede automatizar flujos de trabajo que incluyen comprobación de disponibilidad de dominios, registro, renovación y transferencia, listado de cartera y detalles de dominios, actualización de servidores de nombres y contactos de dominios, precios de dominios, registros DNS, servidores de nombres hijos, información de cuenta y monitoreo de Abuso y Cumplimiento.

Los flujos de trabajo adicionales se documentan individualmente en la navegación de la API.

Comience con operaciones de lectura de bajo riesgo, como disponibilidad de dominios, precios de dominios, saldo de cuenta y listado de dominios.

Luego confirme la autenticación, el análisis de respuestas, el manejo de errores y el manejo de pedidos pendientes antes de habilitar registros, renovaciones o transferencias en vivo.

Sí. El endpoint Check Domain Availability admite múltiples nombres de dominio separados por comas.

example.com,example.net,example.org

No asuma que cada operación de API admite el mismo formato de entrada de múltiples dominios. El registro, la renovación y la transferencia deben seguir la documentación de su endpoint individual.

Utilice el endpoint Get Domain Pricing. Los tipos de precios documentados incluyen register, renew, transfer y all.

Las respuestas de registro también pueden incluir un valor is_premium que indica si el registro consultado es premium.

Debido a que los pedidos a través de la API utilizan precios a nivel de cuenta, consulte los precios actuales antes de enviar pedidos de clientes de pago, en lugar de depender indefinidamente de precios almacenados en caché.

No. Aunque la documentación de la API admite períodos de hasta 1 a 10 años para las extensiones aplicables, cada TLD puede tener reglas de registro diferentes.

Los períodos de registro, los períodos de renovación, la elegibilidad para transferencia, los requisitos de contacto y los requisitos de verificación pueden variar según la extensión. Su aplicación debe seguir las reglas vigentes para el TLD correspondiente.

Se trata de operaciones separadas y no deben tratarse como intercambiables.

Utilice siempre el código y el mensaje devueltos para determinar el estado de una solicitud a la API.

Ver códigos de respuesta de la API →

Una respuesta 201 significa que la operación ha sido aceptada para su procesamiento, pero no necesariamente ha alcanzado su estado final.

Para el registro de dominios, una respuesta 201 indica que el pedido se ha enviado y está a la espera del procesamiento final por parte del registro.

No le comunique a un cliente final que el dominio está activo hasta que su sistema haya confirmado el resultado final. Siga la documentación del endpoint de registro para conocer las reglas más recientes sobre la gestión de pedidos pendientes y reembolsos.

Una transferencia pendiente significa que la solicitud de transferencia ha sido aceptada para su procesamiento, no que el dominio ya haya completado su transferencia a NiceNIC.

La finalización de la transferencia puede depender del procesamiento del registro y del registrador, así como del estado de transferencia actual del dominio. Mantenga la transferencia en estado pendiente hasta que se confirme su finalización.

Sí. La API List Domains admite la recuperación de portafolios con opciones de paginación, ordenación y filtrado.

Utilice Get Domain Details cuando necesite información detallada de un dominio individual, como información de registro, información de caducidad, servidores de nombres y datos de contacto del dominio.

La API de dominios NiceNIC v2 incluye operaciones de abuso y cumplimiento diseñadas para plataformas y revendedores que gestionan portafolios de dominios de clientes.

Puede identificar dominios asociados con denuncias de abuso y recuperar información de cumplimiento legible por máquina para dominios individuales. Según el caso, la respuesta puede incluir estado del dominio, impacto actual, acción recomendada, información de retención, información de la denuncia y URL notificadas.

Esto permite mostrar el estado de cumplimiento directamente en su propio portal de clientes o sistema de operaciones.

Sí. NiceNIC ofrece una integración de registrador para WHMCS a empresas que ya utilizan WHMCS para facturación y aprovisionamiento.

Utilice la API de dominios v2 directamente cuando esté creando su propia aplicación o flujo de trabajo. Utilice la integración con WHMCS cuando desee integrar operaciones de dominios en un entorno WHMCS existente.

Ver la integración con WHMCS →

Cualquier lenguaje de programación o entorno de ejecución del lado del servidor capaz de enviar solicitudes HTTPS y analizar JSON puede integrarse con la API de dominios v2.

Las opciones habituales incluyen PHP, Python, Node.js y Java. Mantenga las credenciales de la API en el lado del servidor y nunca exponga su secreto de API en JavaScript del navegador ni en código de cliente descargable.

Se puede aplicar limitación de frecuencia para proteger la estabilidad de la API y la seguridad de la plataforma.

Si se espera que su integración en producción genere un volumen de solicitudes alto y sostenido, contacte con NiceNIC antes del lanzamiento para que se pueda revisar su patrón de uso previsto.

Incluya la marca de tiempo de la solicitud, la categoría y la acción de la API, el nombre de dominio cuando corresponda, los parámetros de solicitud no confidenciales, el código de respuesta y el mensaje devueltos, y si la solicitud procedía del entorno de pruebas o de producción.

Enviar un ticket →

Utilice la navegación de la API en la documentación. Cada operación tiene su propia página con los parámetros admitidos, ejemplos de solicitud, ejemplos de respuesta y el comportamiento específico de la operación.

Las preguntas frecuentes explican el comportamiento general de la API; la documentación de cada endpoint debe considerarse la fuente de verdad para el formato exacto de las solicitudes.

Abrir documentación de la API →