Cómo solucionar el error de integración de la API de WordPress: Credenciales inválidas

Cómo solucionar el error de integración de la API de WordPress: Credenciales inválidas

wordpress api integration troubleshooting

¿Qué es la REST API de WordPress?

La REST API de WordPress es una función integrada que permite que aplicaciones externas como FlowHunt se comuniquen con tu sitio web de WordPress. Te permite crear, leer, actualizar y eliminar contenido de forma programática, lo que la hace esencial para integrar FlowHunt con tu sitio de WordPress para la gestión automatizada de contenido y funcionalidades de chatbot.

¿Cómo generar una contraseña de aplicación en WordPress?

Las contraseñas de aplicaciones de WordPress ofrecen una forma segura de autenticar solicitudes a la API sin usar tus credenciales de inicio de sesión principales:

  1. Inicia sesión en el panel de administración de WordPress
  2. Ve a Usuarios > Perfil o Usuarios > Todos los usuarios y edita tu usuario
  3. Desplázate a la sección Contraseñas de aplicación
  4. Ingresa un nombre para tu aplicación (ejemplo: “Integración FlowHunt”)
  5. Haz clic en Agregar nueva contraseña de aplicación
  6. Copia la contraseña generada inmediatamente: no se mostrará de nuevo
  7. Usa tu nombre de usuario de WordPress y esta contraseña de aplicación para la autenticación API

¿Qué causa los errores de integración con la API de WordPress?

Los errores de integración con la API de WordPress suelen ocurrir por varios motivos comunes:

Problemas de autenticación

  • Nombre de usuario o contraseña de aplicación incorrectos
  • Usar tu contraseña habitual de WordPress en vez de una contraseña de aplicación
  • Contraseñas de aplicación expiradas o revocadas

Problemas de configuración del servidor

  • El proveedor de hosting desactiva la REST API de WordPress
  • Plugins de seguridad bloquean solicitudes a la API
  • Formato incorrecto de la URL del endpoint de la API
  • Medidas de seguridad en el servidor impiden conexiones externas

Limitaciones en hosting compartido

  • Proveedores de hosting pueden desactivar la REST API por defecto por seguridad
  • Limitación de la frecuencia de solicitudes a la API (rate limiting)
  • Reglas de firewall que bloquean llamadas externas a la API

¿Cómo solucionar el error “Credenciales de API inválidas”?

Si encuentras el error “Credenciales de API inválidas” al conectar FlowHunt con WordPress, sigue estos pasos para solucionar el problema:

Paso 1: Verifica tu endpoint de la API

  1. Asegúrate de usar el formato correcto del endpoint de la API: https://tusitio.com/wp-json/wp/v2/
  2. Prueba el endpoint accediendo desde tu navegador; deberías ver datos en formato JSON
  3. Verifica que la URL de tu sitio sea correcta y accesible

Paso 2: Revisa tus credenciales

  1. Confirma que estás usando tu nombre de usuario de WordPress (no el correo electrónico)
  2. Asegúrate de usar una contraseña de aplicación, no tu contraseña habitual
  3. Genera una nueva contraseña de aplicación si es necesario
  4. Asegúrate de no copiar espacios extra en las credenciales

Paso 3: Verifica que la REST API esté habilitada

  1. Visita https://tusitio.com/wp-json/wp/v2/users/me estando logueado
  2. Si ves los datos del usuario, la API está funcionando
  3. Si ves un error, es posible que la REST API esté deshabilitada

Paso 4: Revisa conflictos con plugins

  1. Desactiva temporalmente los plugins de seguridad
  2. Prueba la conexión a la API nuevamente
  3. Si funciona, configura tu plugin de seguridad para permitir el acceso a la API
  4. Plugins comunes que pueden bloquear la API: Wordfence, Sucuri, iThemes Security

¿Cómo resolver problemas de API en hosting compartido?

Los proveedores de hosting compartido suelen tener restricciones adicionales que pueden causar problemas de integración:

Contacta a tu proveedor de hosting

  1. Pregunta si permiten solicitudes a la REST API de WordPress
  2. Consulta sobre limitaciones de frecuencia o medidas de seguridad
  3. Solicita que habiliten la REST API si está desactivada
  4. Pregunta sobre reglas de firewall que puedan bloquear conexiones externas

Métodos alternativos de autenticación

  1. Prueba autenticación básica si las contraseñas de aplicación no funcionan
  2. Algunos hostings compartidos funcionan mejor con métodos de autenticación distintos
  3. Considera usar plugins de autenticación JWT si están disponibles

Revisa el panel de control del hosting

  1. Busca configuraciones de API o seguridad en tu panel de control de hosting
  2. Algunos proveedores tienen opciones para activar/desactivar la REST API
  3. Revisa si hay direcciones IP o dominios bloqueados

¿Cómo probar la conexión con la API de WordPress?

Para verificar que tu API de WordPress funciona correctamente:

Usando el navegador

  1. Visita https://tusitio.com/wp-json/wp/v2/posts para ver si devuelve publicaciones
  2. Revisa https://tusitio.com/wp-json/wp/v2/ para ver el índice de la API
  3. Prueba endpoints autenticados con las credenciales correctas

Usando herramientas de línea de comandos

curl -X GET "https://tusitio.com/wp-json/wp/v2/posts" \
  -u "usuario:contraseña_de_aplicación"

Códigos de respuesta comunes de la API

  • 200: Éxito – la API funciona correctamente
  • 401: No autorizado – revisa tus credenciales
  • 403: Prohibido – la API puede estar desactivada o bloqueada
  • 404: No encontrado – revisa la URL del endpoint

¿Cómo configurar plugins de seguridad para acceso a la API?

Si los plugins de seguridad están bloqueando tus solicitudes a la API:

Configuración de Wordfence

  1. Ve a Wordfence > Firewall > Todas las opciones del firewall
  2. Busca “Desactivar ejecución de código en el directorio de cargas”
  3. Agrega la IP del servidor de FlowHunt a la lista blanca
  4. Habilita “Permitir acceso a la REST API”

Otros plugins de seguridad

  1. Busca configuraciones de REST API o acceso a la API
  2. Agrega las IPs de FlowHunt a la lista blanca
  3. Crea excepciones para solicitudes API legítimas
  4. Desactívalo temporalmente para probar y luego configúralo correctamente

Preguntas y respuestas similares

P: ¿Por qué mi API de WordPress funciona en el navegador pero no con FlowHunt?
R: Normalmente indica problemas de autenticación. El navegador usa tu sesión iniciada, mientras que FlowHunt requiere autenticación por contraseña de aplicación.

P: ¿Puedo usar mi contraseña habitual de WordPress para la integración API?
R: No, debes usar contraseñas de aplicación por seguridad. Las contraseñas habituales no funcionan con la REST API.

P: ¿Qué hago si mi proveedor de hosting no soporta la REST API de WordPress?
R: Considera cambiar a un proveedor que soporte funciones modernas de WordPress, o pide que habiliten el acceso a la REST API.

P: ¿Cómo saber si mi plugin de seguridad está bloqueando solicitudes a la API?
R: Desactiva temporalmente los plugins de seguridad y prueba la conexión. Si funciona, configura el plugin para permitir el acceso a la API.

P: ¿Por qué recibo errores diferentes en hosting compartido y dedicado?
R: El hosting compartido suele tener más restricciones y limitaciones de seguridad que no existen en entornos dedicados o VPS.

Saber más

Claves API
Claves API

Claves API

Las claves API permiten que otros programas accedan a los Flujos sin utilizar los Chatbots de FlowHunt. Usa Flujos para automatizar procesos y flujos de trabajo...

3 min de lectura
API Keys FlowHunt +3
Integración con WordPress
Integración con WordPress

Integración con WordPress

Integra WordPress con tus flujos de trabajo de IA y envía automáticamente el contenido generado directamente a tu sitio web.

2 min de lectura
WordPress Integration +4