Gran tarea de Postman
Requisitos de la API
El courier intergaláctico debe poder:
-
Solicitar una lista de pedidos disponibles para entrega.
Solo deben devolverse pedidos con estado
CREATED. Los pedidos en otros estados no deben devolverse.Método Endpoint Descripción GET /deliveriesObtener información sobre todas las entregas con estado CREATED. -
Solicitar información detallada de un pedido por ID.
La respuesta debe contener la descripción del pedido, nombre y dirección del remitente y del destinatario; los campos adicionales son opcionales.
Método Endpoint Descripción GET /deliveries/{id}Obtener información de entrega por ID de pedido. El ID se pasa como path variable. -
Crear un nuevo pedido.
Para cada nuevo pedido, el servidor debe generar un ID único y establecer el estado
CREATED.Método Endpoint Descripción POST /deliveriesCrear un nuevo pedido. Los datos del pedido deben pasarse en el cuerpo de la solicitud como JSON con los siguientes campos:
Campo Tipo Obligatorio Restricciones description string + de 1 a 50 caracteres from.name string + de 1 a 30 caracteres from.address string + de 1 a 50 caracteres to.name string + de 1 a 30 caracteres to.address string + de 1 a 50 caracteres client_comment string - hasta 50 caracteres courier_comment string - hasta 50 caracteres -
Actualizar el estado del pedido por ID.
Método Endpoint Descripción PATCH /deliveries/{id}Actualizar el estado del pedido por ID pasado como variable de ruta. El nuevo estado se establece en el cuerpo de la solicitud como JSON con los siguientes campos:
Campo Tipo Obligatorio Restricciones status string + CREATED, IN_PROGRESS, DELIVERED, CANCELLED courier_comment string - hasta 50 caracteres
Autorización JWT
Todas las solicitudes a la API del servidor deben enviarse con un JWT token.
- Duración del token: 30 minutos.
- La solicitud para obtener un token se envía desde la UI de la tarea.
- El token debe pasarse en el Authorization encabezado con tipo Bearer Token.
Уровень повышен!