1. Requisitos previos
Una cuenta de cPanel.
Conocimientos básicos de línea de comandos y cURL.
2. Instrucciones paso a paso
Crear el token
1. En cPanel, abre Seguridad > Administrar tokens de API.
2. Escribe un nombre para el token y elige si caduca o no.
3. Haz clic en Crear y copia el token.
⚠️ Importante: No podrás volver a verlo en cPanel. Guárdalo en un lugar seguro.
Consultar los registros DNS
4. Ejecuta esta petición (cambia usuario, token y dominios). Devuelve un JSON con todos los registros y su número de línea:
curl -X POST \
-H "Authorization: cpanel usuariocpanel:TOKEN" \
-H "Content-Type: application/json" \
--data '{"cpanel_jsonapi_module":"ZoneEdit","cpanel_jsonapi_func":"fetchzone_records","domain":"dominio.com"}' \
https://tu-dominio.com:2083/json-api/cpanel
Ejemplos de operaciones
5. Editar un registro CNAME (indica la línea del registro):
--data
'{"cpanel_jsonapi_module":"ZoneEdit","cpanel_jsonapi_func":"edit_zone_record","domain":"midominio.com","line":1,"type":"CNAME","name":"www.app","data":"destino.com"}'
6. Crear una cuenta de correo (cuota en MB):
--data
'{"cpanel_jsonapi_module":"Email","cpanel_jsonapi_func":"addpop","domain":"midominio.com","email":"administracion","password":"contraseña","quota":100}'
3. Resultado esperado
Las peticiones devuelven una respuesta JSON de éxito y los cambios aparecen en cPanel.
4. Solución de problemas
Si: ¿Cómo revoco un token?
Solución: En Administrar tokens de API, selecciónalo y haz clic en Revocar.
Si: Error de autenticación.
Solución: Revisa el formato de la cabecera: Authorization: cpanel usuario:token.
5. Resumen y siguientes pasos
Sabes automatizar tareas de cPanel con su API.
Siguiente paso: Cómo depurar y solucionar errores en tareas Cron (PHP y cURL)