Quem pediu: Dara Quinn, responsável pelo atacado da Hartwell Coffee Roasters, uma torrefação fictícia.
Por quê: as cafeterias fazem os pedidos por e-mail, e Dara digita de novo cada pedido em uma planilha. Uma pequena página web permitirá que as cafeterias peçam diretamente; essa página precisa de uma API por trás.
O que você constrói: Order e OrderLine no EF Core com um OrdersContext; um OrderDto para as respostas; um OrderService que cria, lê, cancela e lista pedidos; os registros; e os endpoints GET /orders/{id}, POST /orders, POST /orders/{id}/cancel e GET /orders?customer=.
Como fica quando está pronto: uma cafeteria consegue fazer um pedido e receber 201 com a localização dele, ler o pedido de volta, cancelá-lo uma vez (204 e depois 409) e percorrer seus pedidos por páginas; uma entrada incorreta recebe um 400 com uma mensagem por campo, e pedidos desconhecidos recebem 404.
A Hartwell Coffee Roasters vende café em grãos para cafeterias, e seus pedidos ficam em e-mails. Você constrói a API que a nova página de pedidos vai chamar, em seis etapas, cada uma partindo do código que você terminou na etapa anterior: um modelo de EF Core, um OrderService, os registros e um endpoint GET, um POST validado, o cancelamento e uma lista paginada por cliente. Funciona com os mesmos substitutos sinalizados das lições desta unidade.