Documentación y guía de inicio rápido de NiceNIC Domain API v2

Pruebe su integración antes de salir a producción

Use el entorno de pruebas de API de NiceNIC para probar su integración con la API de dominios antes de pasar a producción. Valide la autenticación, las solicitudes de API, el manejo de respuestas y el flujo de trabajo de su 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.

Haga su primera llamada a la API en 4 pasos

Comience con una solicitud de solo lectura antes de habilitar registros, renovaciones o transferencias en producción. Esto le permite validar la autenticación, el formato de las solicitudes y el procesamiento de las respuestas sin realizar un pedido 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.

Elija el flujo de trabajo que necesite

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.

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.

Comprenda las respuestas de éxito, pendientes y de error

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 transferencia también documenta 201 como una orden pendiente. Por lo tanto, su aplicación debe tratar una transferencia pendiente como aceptada para su procesamiento, no como prueba de que la transferencia ya se ha completado.

Consulte 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. Utilice el endpoint de precios antes de enviar una solicitud de pago cuando su aplicación necesite conocer el costo actual a nivel de cuenta.

Conozca la diferencia entre servidores de nombres, registros DNS y servidores de nombres de subdominio

Automatice el monitoreo del portafolio, 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 próxima acción recomendada, el estado de suspensión y la cronología, el número de quejas, las fechas de las quejas, las categorías, la clasificación de abuso DNS, el estado de las pruebas y las URLs reportadas, cuando corresponda. Esto permite que las plataformas y los revendedores muestren el estado de cumplimiento dentro de sus propios sistemas operativos, en lugar de depender únicamente de la revisión manual.

Elija el modelo de integración que se ajuste a su sistema

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.

Cuando falla una solicitud a la API

Comience con la respuesta devuelta y el estado de configuración, en lugar de reintentar repetidamente la misma acción de pago.