simple http api brainstorming

SimpleHttp.scala

import library.*
import library.headers.*
import library.json.*

class OrderControllerV1(repository: OrderRepository):
  @get(
    description = "Fetch user by id",
    path = "/api/v1/orders/{orderId}",
    produces = "application/json"
  )
  def fetchById(
    @pathSegment orderId: UUID
  ): Response.Ok[Order, _] | Response.NotFound[String, _] =
    repository.fetch(id) match
      case None    => notFound("order not found")
      case Some(v) => ok(v)

  @post(
    description = "Crete order",
    path = "/api/v1/orders",
    produces = "application/json"
  )
  def fetchById(
    createOrder: CreateOrder
  ): Response.Created[Order, (Location)] = //RawHeader["Header-Name"]
    val createdOrder = repository.create(order)
	
    created()
      .withHeader(Location(s"/api/v1/orders/${createdOrder.id}"))

  //Just an example on how to respond headers

  type Header1 = RawHeader["Header1"]
  type Header2 = RawHeader["Header2"]

  @put(
    description = "Update order",
    path = "/api/v1/orders/{orderId}",
    produces = "application/json"
  )
  def fetchById(
    @pathSegment orderId: UUID, 
    createOrder: CreateOrder
  ): Response.Ok[Order, (Header1, Header2)] | Response.NotFound[String, _] =
    repository.update(orderId, order) match
      case None => notFound("order not found")
      case Some(updatedOrder) =>
        ok(updatedOrder) //Response.Ok[Order, _]
	  .withHeader(Header1("Just an example")) //Response.Ok[Order, (Header1)]
	  .withHeader(Header2("Another example")) //Response.Ok[Order, (Header1, Header2)]

end OrderControllerV1