Resuelve errores comunes de la API REST
- Situación
- Respuestas de error
- Códigos de estado
- Consejos profesionales
- Contactar con el equipo de soporte
Al trabajar 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 resolución para que puedas identificarlos y solucionarlos rápidamente.
Importante
Revisa siempre dos veces la documentación de la API.<\/a>
A continuación verás una respuesta de error habitual resultante de una solicitud de API fallida.
Código de estado<\/strong>: XXX
Cuerpo de la respuesta<\/strong>:
{\n\"errorDescription\": \"descripción legible para humanos del error.\",\n\"error\": \"código corto y estandarizado o identificador del error específico que ocurrió\"\n}Códigos de estado
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.
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<\/em>: Un usuario intenta usar el parámetro 'firstName<\/span><\/span>' en una llamada GET\/contacts<\/span><\/span><\/a>
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.
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.
Posible causa
Se usa un método de API incorrecto.
Ejemplo: Un usuario intenta enviar una llamada PUT/tasks que no es compatible.
Pasos para la resolución de problemas
Asegúrate de que el método que usas esté admitido para el endpoint y configurado correctamente.
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<\/em>: Un usuario con una suscripción Business Plus<\/a> llama al método GET\/data_export<\/span><\/span><\/a>
- La cuenta no tiene la licencia necesaria para realizar la operación.
Ejemplo<\/em>: Un Collaborator<\/a> intenta actualizar el título de una carpeta. - La operación no se puede realizar.
Ejemplo<\/em>: Un usuario intentó crear una dependencia<\/a> 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.
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
- Si recibes respuestas HTTP 429 a tu solicitud, piensa en usar reintentos con retroceso exponencial.
- Divide la carga entre varios usuarios.
- Si el problema persiste, ponte en contacto con nuestro equipo de soporte
Posible causa
Se ha superado el límite de velocidad
Pasos para la resolución de problemas
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
- Consulta la página de estado de Wrike para ver si hay problemas generales.
- Si no hay incidencias, contacta con nuestro equipo de soporte para investigar más a fondo.
Posible causa
Estás intentando obtener un recurso que no existe.
Ejemplo<\/em>: Un usuario envía una llamada para recuperar tareas de una carpeta vacía con la llamada GET\/folders\/{folderId}\/tasks<\/span><\/span><\/a>
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
¿Tienes varias cuentas de Wrike y no sabes a cuál está asociado tu token? No te preocupes, es fácil de averiguar. Simplemente haz la llamada GET\/account<\/span><\/span><\/a> para confirmarlo.
Cómo rastrear al propietario de tu token
Si has estado probando la API con varios usuarios y quieres identificar al propietario de un token en particular, hay una forma simple y directa. Recupera los detalles del perfil del usuario enviando una llamada GET\/contacts?me=true<\/span><\/span><\/a>.
Si los inconvenientes persisten, por favor, contacta a nuestro Equipo de Soporte y estaremos encantados de ayudarte.
Para acelerar la resolución, envíanos la siguiente información:
- Tu objetivo con la llamada a la API.
- La solicitud completa de API que enviaste.
- La respuesta que recibiste.
-
[En caso de problemas relacionados con permisos o con el token] <\/em>
La parte central del token, para que podamos descodificarlo de nuestro lado.
A continuación tienes un ejemplo de un token de acceso. Necesitamos que nos envíes la parte comprendida entre 2 puntos (en negrita) y que omitas las partes antes y después del punto:eyJ0dCI6InAiLCJhbGciOiJIUzI1NiIsInR2IjoiMSJ9.eyJkIjoie1wiYVwiOjM5MjA2MDIsXCJpXCI6NzIyMzMxOCxcImNcIjo0NjIwNzcwLFwidVwiOjY5NzA4NjcsXCJyXCI6XCJVU1wiLFwic1wiOltcIldcIixcIkZcIixcIklcIixcIlVcIixcIktcIixcIkNcIixcIkRcIixcIk1cIixcIkFcIixcIkxcIixcIlBcIl0sXCJ6XCI6W10sXCJ0XCI6MH0iLCJpYXQiOjE1OTk5MDk0MzV9.q3qOJs2swWSCgZl1ueKYsUyhME4RBD4cl53vZ0pwDccImportante
¡Nunca envíes el token completo! Compartir tu token permanente equivale a compartir la contraseña de tu cuenta de Wrike.