Código de estado HTTP

Este documento define la especificación de códigos de retorno HTTP de la API REST de MTPush.

La nueva versión de la API Push de MTPush v4 cumple esta especificación.

Definición de códigos de estado

Código Descripción Explicación
200 OK Correcto
400 Solicitud incorrecta La solicitud no es válida. La descripción correspondiente explicará el motivo.
401 No verificado No hay información de verificación o la verificación ha fallado.
403 Rechazado La solicitud se entendió, pero no se aceptó. La descripción correspondiente explicará el motivo.
404 No encontrado El recurso no existe, el usuario solicitado no existe y el formato solicitado no es compatible.
405 El método de solicitud no es apropiado La interfaz no admite solicitudes con este método.
410 Sin conexión El recurso solicitado está fuera de servicio. Consulte el anuncio correspondiente.
429 Demasiadas solicitudes La solicitud ha superado el límite de frecuencia. La descripción correspondiente explicará el motivo específico.
500 Error interno del servicio Se ha producido un error interno en el servidor. Se debe contactar con nosotros para resolver el problema lo antes posible.
502 Proxy no válido El servidor del servicio está fuera de línea o en proceso de actualización. Intentarlo de nuevo más tarde.
503 Fallo temporal del servicio El servidor no pudo responder a la solicitud. Intentarlo de nuevo más tarde.
504 Tiempo de espera del agente El servidor está en ejecución, pero no puede responder a la solicitud. Intentarlo de nuevo más tarde.

Especificaciones que se deben seguir

  • El código 200 debe indicar un resultado correcto. No utilizar el código de retorno 200 para todas las excepciones.
  • Para errores de lógica de negocio, intentar utilizar 4xx para códigos de error específicos; en caso contrario, utilizar 400.
  • Para errores internos del servidor, si no existe un código de error específico, utilizar 500.
  • Cuando se produzcan excepciones de negocio, el contenido devuelto utiliza el formato JSON para definir la información de error.
Icon Solid Transparent White Qiyu
Contacto