Errores

Todos los errores devolverán el código de respuesta HTTP más específico y apropiado de la siguiente tabla:

Códigos de retorno

Código	Error	Descripción
400	Solicitud incorrecta	Se recibió una solicitud malformada del cliente. Esta es la respuesta más genérica proporcionada por la API
401	No autorizado	No estás autorizado y no puedes acceder al recurso solicitado
403	Prohibido	No tienes permiso para acceder al recurso solicitado
404	No encontrado	El recurso solicitado no se puede encontrar. Puede que esté disponible más tarde
405	Método no permitido	Se usó un método HTTP no compatible para el recurso solicitado
406	No aceptable	El tipo Accept o Accept-Encoding solicitado por el cliente no está disponible
409	Conflicto	La solicitud no se puede completar porque hay un conflicto con el recurso existente
410	Desaparecido	El recurso solicitado ya no está disponible y nunca lo estará en el futuro
411	Longitud requerida	El recurso solicitado espera que el cliente proporcione un Content-Length
413	Entidad de la solicitud demasiado grande	El cuerpo de la solicitud proporcionado por el cliente era demasiado grande; el recurso se niega a procesarlo
415	Tipo de medio no compatible	El cliente ha proporcionado un Content-Type incorrecto (o ninguno)
422	Entidad no procesable	La solicitud no está malformada y el tipo de medio es aceptable, pero el recurso no puede procesar la solicitud
429	Demasiadas solicitudes	Se ha alcanzado el límite de tasa. Consulta la sección de limitación de tasa para obtener más información
500	Error interno del servidor	El servidor no pudo procesar tu solicitud debido a un error interno inesperado del servidor
501	No implementado	El recurso solicitado no ha sido implementado
503	Servicio no disponible	El servicio solicitado no está disponible temporalmente

Formato estándar de respuesta

Todos los errores tendrán un cuerpo de respuesta estándar con dos campos, code y message. Se pueden usar más campos, pero son opcionales.

Ejemplos

Esta es la forma más sencilla del cuerpo de retorno de un error; los clientes pueden confiar en que estos campos estarán presentes en cada error.

Respuestas de error - Ejemplo 1 (Base)

{
  "code": 429,
  "message": "Has superado tu número de solicitudes. Por favor, inténtalo de nuevo más tarde"
}

El siguiente ejemplo tiene, además de los campos estándar, errores asociados con esta solicitud específica.

Respuestas de error - Ejemplo 2 (Más complejo)

{
  "code": 422,
  "message": "Entidad no procesable",
  "cause": "La validación falló",
  "errors": [
    {
      "resource": "Issue",
      "field": "title",
      "code": "missing_field"
    },
    ...
  ]
}