Información general de la API
Documentación y guía de inicio rápido de NiceNIC Domain API v2
La API v2 de dominios de NiceNIC está disponible tanto para cuentas estándar como para cuentas de revendedor. Usa este resumen para configurar el acceso, confirmar tu primera solicitud, comprender el modelo de respuesta de la API e ir directamente a la sección correspondiente en la navegación izquierda.
El acceso a la API y los precios de revendedor son independientes.
Cuenta estándar: acceso a la API con precios de Cuenta estándar.
Cuenta de Revendedor: acceso a la API con los precios asignados al nivel de revendedor actual.
Comparar niveles y precios de revendedor →
Cuenta estándar: acceso a la API con precios de Cuenta estándar.
Cuenta de Revendedor: acceso a la API con los precios asignados al nivel de revendedor actual.
Comparar niveles y precios de revendedor →
Endpoint base
https://api.nicenic.net/v2/
Encabezados requeridos
Host: api.nicenic.net Authorization: username:api_secret Content-Type: application/json
Respuesta de éxito estándar
{ "code": 0, "msg": "success", "data": {} }
Entorno de pruebas de API
Prueba tu integración antes de pasar a producción
Usa el entorno de pruebas de la API de NiceNIC para probar la integración de tu API de dominios antes de pasar a producción. Valida la autenticación, las solicitudes a la API, la gestión de respuestas y el flujo de trabajo de tu aplicación en un entorno de pruebas dedicado.
Ideal para revendedores, proveedores de alojamiento, desarrolladores y plataformas que estén preparando una integración con API.
Inicio rápido
Haz tu primera llamada a la API en 4 pasos
Empieza con una solicitud de solo lectura antes de habilitar registros, renovaciones o transferencias en el entorno real. Esto te permite validar la autenticación, el formato de la solicitud y la gestión de respuestas sin realizar un pedido de pago.
1
Habilitar el acceso a la API
Abre la configuración de la API, crea u obtén tu API Secret y configura las IP de servidor autorizadas según corresponda.
2
Confirmar la autenticación
Usa HTTPS con el encabezado Authorization en el formato username:api_secret.
3
Ejecuta una prueba segura
Comienza consultando la disponibilidad de dominios, precios, el saldo de la cuenta o el listado de dominios.
4
Manejar la respuesta
Lee y guarda los valores devueltos en los campos code y msg antes de activar las acciones de producción de pago.
Primera solicitud recomendada: disponibilidad de dominio
El endpoint de disponibilidad admite múltiples dominios en una sola solicitud separando los nombres de dominio con comas.
curl "https://api.nicenic.net/v2/?category=domain&action=check&domains=example.com,example.net" \ -H "Authorization: username:api_secret" \ -H "Content-Type: application/json"
Mapa de API
Elige el flujo de trabajo que necesitas
La siguiente vista general refleja la navegación izquierda. Úsela para identificar el flujo de trabajo correcto y, a continuación, abra la página dedicada del endpoint correspondiente para consultar los parámetros, ejemplos de solicitudes y ejemplos de respuestas.
| Sección | Para qué sirve | Funciones documentadas |
|---|---|---|
| Primeros pasos | Conectarse de forma segura y comprender la gestión de respuestas. | Descripción general de la API, entorno de pruebas de la API, autenticación, códigos de respuesta. |
| Gestión de dominios | Automatizar el ciclo de vida principal del dominio. | Disponibilidad, listar dominios, detalles del dominio, registro, renovación, transferencia entrante, servidores de nombres, contactos, precios. |
| Abuso y cumplimiento | Supervisar los dominios que requieren atención de cumplimiento. | Listar los dominios con informes de abuso y recuperar el estado de abuso legible por máquina, el ciclo de vida de la retención, la información de las reclamaciones y la acción recomendada. |
| Registros DNS | Gestiona registros DNS alojados de forma programática. | Lista, crea, actualiza y elimina registros DNS. |
| Servidores de nombres subordinados | Gestiona los registros host / glue para servidores de nombres bajo tu propio dominio. | Crea, lista, actualiza y elimina servidores de nombres subordinados. |
| Cuenta y facturación | Conecta la automatización con comprobaciones a nivel de cuenta. | Saldo de la cuenta e información de cuenta relacionada con las transacciones. |
| API de WHMCS | Integra NiceNIC en un flujo de trabajo de facturación de WHMCS existente. | Disponibilidad, registro, renovación, transferencia, detalles del dominio, servidores de nombres, contactos y funciones adicionales del módulo de registrador. |
| Preguntas frecuentes de la API | Resuelve dudas habituales sobre acceso, seguridad, pruebas y flujo de trabajo. | Elegibilidad, credenciales, gestión de solicitudes, operaciones compatibles y orientación sobre integración. |
Flujo de trabajo recomendado
Secuencia recomendada para la primera integración
Una integración de producción fiable debe validar las condiciones de acceso y de compra antes de comenzar a enviar pedidos reales de clientes.
1. Autenticación
Secreto de API + IP autorizada
Secreto de API + IP autorizada
→
2. Disponibilidad
Prueba de conectividad de solo lectura
Prueba de conectividad de solo lectura
→
3. Precios
Consultar el costo actual a nivel de cuenta
Consultar el costo actual a nivel de cuenta
→
4. Saldo
Confirmar fondos para acciones de pago
Confirmar fondos para acciones de pago
→
5. Manejo de respuestas
Procesar código + mensaje
Procesar código + mensaje
→
6. Operaciones en vivo
Registrar / Renovar / Transferir
Registrar / Renovar / Transferir
No asumas que una solicitud de la API ha finalizado solo porque haya sido aceptada. Algunas operaciones pueden devolver un estado pendiente y requerir aún el procesamiento del registro antes de que se confirme el estado final del dominio.
Comportamiento en producción
Comprende las respuestas de éxito, pendientes y de error
code: 0 — Respuesta de éxito Los ejemplos de endpoints actuales usan el código 0 para respuestas completadas con éxito.
code: 201 — Pedido pendiente La documentación de registro y transferencia puede devolver el código 201 cuando se ha enviado un pedido, pero el procesamiento final aún está pendiente.
code: 400 — Error de solicitud Los ejemplos de endpoints usan el código 400 para errores en los parámetros de la solicitud.
Comportamiento del registro pendiente
Para el registro de dominios, la documentación actual indica que una respuesta 201 significa que el pedido se envió correctamente y que se dedujo la tarifa, pero la activación final sigue sujeta a la confirmación del registro. Si el dominio no se puede activar, la tarifa de registro se devuelve al saldo de la cuenta de NiceNIC en un plazo de 24 horas.
Comportamiento de transferencia pendiente
El endpoint de transferencias también documenta 201 como un pedido pendiente. Por tanto, tu aplicación debe considerar una transferencia pendiente como aceptada para su procesamiento, no como prueba de que la transferencia ya se haya completado.
Precios
Consulta los precios antes de realizar operaciones de pago
El endpoint de precios de NiceNIC puede recuperar los precios de registro, renovación y transferencia de un dominio. Los valores de type documentados son register, renew, transfer y all. El período documentado es de 1 a 10 años, con posibles excepciones específicas de TLD.
Las respuestas de precios de registro también pueden devolver un indicador is_premium. Usa el endpoint de precios antes de enviar una solicitud de pago cuando tu aplicación necesite conocer el coste actual según el nivel de tu cuenta.
El acceso gratuito a la API no modifica tu nivel de precios. Las cuentas estándar aplican los precios de cuenta estándar; las cuentas de revendedor aplican los precios asignados a su nivel actual de revendedor.
Operaciones de dominios y DNS
Conoce la diferencia entre servidores de nombres, registros DNS y servidores de nombres subordinados
| Operación | Cuándo usarlo | Capacidad documentada |
|---|---|---|
| Actualizar servidores de nombres | Quiere delegar un dominio a diferentes servidores de nombres autoritativos. | El endpoint de servidores de nombres del dominio admite un servidor de nombres primario, uno secundario y servidores adicionales, y la página actual documenta un límite de hasta seis. |
| Registros DNS | Está utilizando el alojamiento DNS de NiceNIC y necesita gestionar los registros de zona. | Se documentan APIs independientes para listar, crear, actualizar y eliminar registros DNS. |
| Servidores de nombres subordinados | Necesitas registros host / glue como ns1.example.com. |
Crear, listar, actualizar y eliminar servidores de nombres subordinadoss. El endpoint de creación requiere que el nombre de host del servidor de nombres coincida con el dominio y acepta una dirección IP. |
Portafolio y cumplimiento
Automatiza la supervisión de tu cartera, no solo los pedidos de dominios
La API de dominios v2 también incluye operaciones de lectura útiles después del registro. El endpoint List Domains admite paginación, ordenamiento, filtrado por estado y filtrado por retención, mientras que Get Domain Details devuelve fechas de registro, fechas de vencimiento, servidores de nombres e información de contacto del titular.
Supervisión de abuso y cumplimiento
La API de abuso y cumplimiento de NiceNIC puede enumerar dominios con informes de abuso y devolver un resumen detallado legible por máquina para un dominio específico. El endpoint detallado de abuso documenta seis frases de estado a nivel de dominio: Normal, Under Review, Pending ClientHold, ClientHold, Closed y ServerHold.
La respuesta puede incluir el impacto actual, la siguiente acción recomendada, el estado de retención y su cronología, el recuento de quejas, las fechas de las quejas, las categorías, la clasificación de abuso de DNS, el estado de las pruebas y las URL reportadas cuando proceda. Esto permite que las plataformas y los revendedores muestren el estado de cumplimiento en sus propios sistemas operativos en lugar de depender únicamente de revisiones manuales.
API directa o WHMCS
Elige el modelo de integración que se adapte a tu sistema
| Opción | Ideal para | Qué ofrece la documentación actual |
|---|---|---|
| API de dominios v2 | Sitios web a medida, plataformas SaaS, sistemas internos, flujos de facturación o aprovisionamiento personalizados. | Integración directa mediante HTTPS + JSON en operaciones de dominios, DNS, servidores de nombres subordinados, cuentas y cumplimiento normativo. |
| Módulo WHMCS | Empresas de hosting y revendedores que ya utilizan WHMCS. | Disponibilidad, registro, renovación, transferencia, detalles del dominio, servidores de nombres, contactos, bloqueo/desbloqueo, recuperación de EPP, registro de errores y modo de prueba opcional. |
La documentación actual de WHMCS indica como requisitos WHMCS 7.0 o superior, PHP 7.0 o superior con cURL, credenciales válidas de la API de NiceNIC y soporte para SSL/TLS.
Solución de problemas
Cuando falla una solicitud a la API
Comienza revisando la respuesta devuelta y el estado de la configuración en lugar de reintentar la misma acción de pago de forma repetida.
Error de autenticación o acceso
- Confirma el nombre de usuario de NiceNIC y el API Secret.
- Confirma que el encabezado Authorization esté presente y tenga el formato correcto.
- Confirma que el API Secret no se haya restablecido ni rotado.
- Si las restricciones de IP están habilitadas, compruebe que la solicitud proviene de la dirección IP autorizada del servidor de salida.
Error en el parámetro de la solicitud
- Compara la solicitud con los parámetros documentados del endpoint específico.
- Confirma los valores obligatorios, los formatos y los nombres de las acciones.
- Comprueba los periodos de registro específicos del TLD o los requisitos de contacto cuando corresponda.
Una operación de pago no se completa de inmediato.
- Lee el
codey elmsgdevueltos. - No trate una respuesta pendiente
201como una finalización definitiva. - Confirma el saldo de tu cuenta y los precios vigentes antes de reintentar una acción de pago.
¿Necesitas soporte de NiceNIC?
- Registra la marca de tiempo de la solicitud y la acción de la API.
- Incluye el nombre de dominio o el objeto involucrado, según corresponda.
- Incluye el código y el mensaje devueltos.
- Comparte únicamente parámetros no confidenciales; nunca publiques el API Secret completo en un ticket.
Siguiente paso
Empieza con una solicitud de prueba segura
Habilita el acceso a la API, confirma la autenticación, ejecuta una consulta de disponibilidad o de precios y verifica la gestión de respuestas antes de activar operaciones de pago orientadas a tus clientes.
Última verificación: 26 de agosto de 2026
