Todos los artículos

Resuelve errores comunes de la API REST

Situación

Cuando trabajas con la API de Wrike, los errores son inevitables. Pueden ocurrir por diversas razones, como derechos de usuario insuficientes, limitaciones de la licencia de la cuenta o un formato incorrecto. En este artículo, hablaremos de los errores de API más comunes y te daremos pasos de solución para que los identifiques y resuelvas rápidamente.

Importante

Comprueba siempre la documentación de la API.

Respuestas de error

Lo siguiente representa una respuesta de error habitual tras una solicitud de API fallida.

Código de estado: XXX
Cuerpo de la respuesta:

{
"errorDescription": "human-readable description of the error.",
"error": "short, standardized code or identifier for the specific error that occurred"
}

Códigos de estado

300 - Múltiples opciones

Posible causa

URL base incorrecta.

Pasos para solucionar

Comprueba que tu URL base sea correcta.
Wrike almacena los datos de los clientes en varios centros de datos en EE. UU. y la Unión Europea. Para acceder a tus datos, usa la URL base adecuada según la ubicación de los datos. Puedes determinar tu URL base mirando la URL en la barra de direcciones cuando accedes a tu cuenta de Wrike en un navegador.

400 - invalid_request

Posible causa

  • El tipo HTTP de la solicitud no es válido, los datos críticos de la solicitud faltan o están incompletos (p. ej., falta el adjunto).
  • Falta la cabecera.
  • El nombre del parámetro de la solicitud no es válido.
  • El parámetro de la solicitud no está admitido para este endpoint.

Ejemplo: Un usuario intenta usar el parámetro 'firstName' en una llamada GET/contacts

Pasos para la resolución de problemas

  • Consulta la documentación de la API para asegurarte de que tu solicitud esté bien formateada: todos los parámetros deben ser válidos y estar admitidos por el endpoint.
  • Asegúrate de incluir en la solicitud todas las cabeceras necesarias.

400 - invalid_parameter

Posible causa

  • Falta el parámetro obligatorio.
  • El valor del parámetro está rellenado o formateado incorrectamente.

Pasos para la resolución de problemas

  • Revisa la documentación y asegúrate de que todos los parámetros marcados como obligatorios estén presentes en tu llamada.
  • Asegúrate de que el valor del parámetro sea correcto y esté formateado según la documentación.

400 - method_not_found

Posible causa

Se usa un método de API incorrecto.

Ejemplo: Un usuario intenta enviar una llamada PUT/tasks que no está admitida. 

Pasos para la resolución de problemas

Asegúrate de que el método que usas esté admitido para el endpoint y configurado correctamente.

403 - not_allowed

Posible causa

La acción solicitada no está permitida debido a limitaciones de licencia/cuota, etc.

  • El usuario no tiene los permisos necesarios para realizar la acción solicitada.

    Ejemplo: Un usuario con una suscripción Business Plus llama al método GET/data_export.

  • La cuenta no tiene la licencia necesaria para realizar la operación.
    Ejemplo: Un Colaborador intenta actualizar el título de una carpeta.

  • La operación no se puede realizar.
    Ejemplo: Un usuario intentó crear una dependencia que ya existe.

Pasos para la resolución de problemas

  • Revisa los permisos del usuario en la configuración de la cuenta de Wrike. Asegúrate de que el usuario tenga los permisos necesarios para acceder al recurso solicitado.
  • Comprueba la licencia de la cuenta. Puede que tengas que actualizar la licencia para usar este método de API.
  • Verifica si el usuario puede realizar la misma operación en la interfaz.

404 - resource_not_found

Posible causa

  • El recurso solicitado no existe.
  • El usuario no tiene acceso al recurso solicitado

Pasos para la resolución de problemas

Comprueba el recurso solicitado y asegúrate de que el usuario cuyo token se usa en la integración tenga acceso a él.

429 - too_many_requests

Posible causa

La tasa de solicitudes desde la misma dirección IP (5000/min) o por usuario (400/min) supera el límite. Se atienden las primeras 400 solicitudes por minuto y cualquier solicitud adicional devuelve el estado 429.

Pasos para la resolución de problemas

429 - rate_limit_exceeded

Posible causa

Se ha superado el límite de velocidad

Pasos para la resolución de problemas

Contacta con nuestro equipo de soporte

500 - server_error

Posible causa

  • El servidor encontró una condición inesperada que le impidió completar la solicitud.
  • El usuario no tiene acceso al recurso solicitado

Pasos para solucionar problemas

Respuesta vacía

Posible causa

Estás intentando obtener un recurso que no existe.

Ejemplo: Un usuario envía una llamada para recuperar tareas de una carpeta vacía con la llamada GET/folders/{folderId}/tasks

Pasos para solucionar problemas

Asegúrate de que el recurso (p. ej. tarea/carpeta/proyecto, etc.) exista en la cuenta.

Consejos profesionales

Identificar la cuenta a la que pertenece tu token

¿Gestionas varias cuentas de Wrike y no estás seguro de a cuál pertenece tu token? No te preocupes, es fácil averiguarlo. Simplemente realiza la llamada GET/account para confirmarlo.

Encontrar al propietario de tu token

Si has estado probando la API con varios usuarios y quieres identificar al propietario de un token concreto, hay una manera sencilla y directa. Recupera los detalles del perfil del usuario enviando una llamada GET/contacts?me=true.

Contactar con Soporte

Si los obstáculos persisten, contacta a nuestro equipo de Soporte y estaremos encantados de ayudarte.

Para acelerar la resolución, por favor proporciónanos los siguientes detalles:

  • Tu objetivo con la llamada de API.
  • La solicitud de API completa que enviaste.
  • La respuesta que recibiste.
  • [En caso de problemas relacionados con permisos o el token]
    La parte intermedia del token, para que podamos descodificarlo en nuestro lado.

    A continuación tienes un ejemplo de un token de acceso. Necesitamos que nos envíes la parte comprendida entre los 2 puntos (en negrita) y que omitas las partes antes y después del punto: 
    eyJ0dCI6InAiLCJhbGciOiJIUzI1NiIsInR2IjoiMSJ9.eyJkIjoie1wiYVwiOjM5MjA2MDIsXCJpXCI6NzIyMzMxOCxcImNcIjo0NjIwNzcwLFwidVwiOjY5NzA4NjcsXCJyXCI6XCJVU1wiLFwic1wiOltcIldcIixcIkZcIixcIklcIixcIlVcIixcIktcIixcIkNcIixcIkRcIixcIk1cIixcIkFcIixcIkxcIixcIlBcIl0sXCJ6XCI6W10sXCJ0XCI6MH0iLCJpYXQiOjE1OTk5MDk0MzV9.q3qOJs2swWSCgZl1ueKYsUyhME4RBD4cl53vZ0pwDcc

    Importante

    ¡Nunca envíes el token completo! Compartir tu token permanente equivale a compartir la contraseña de tu cuenta de Wrike.

Superior

Artículos relacionados