Richardson maturity model: Resources with Silex

app.php

<?php
use Silex\Application;
use Symfony\Component\HttpFoundation\Request;

$app = new Application();

$app->post('/order', function(Request $request) {
    $service = new OrderService();
    $order = OrderFactory::fromArray($request->request->all());
    $service->setOrder($order);
    return json_encode($service->placeOrder());
});

$app->post('/order/{id}/status', function(Application $app, $id) {
    $order = OrderRepository::getById($id);
    if (! $order)
        $app->abort('404', "Order with id $id not found");
    return json_encode($order->getStatus());
});

We now interact with specific resources instead of a single service endpoint.

If we want to create a new order we might do something like this:

POST /order HTTP/1.1

{
  "beer_id": "54cdef43",
  "tip": 5.99
  "credit_card": {
    "number": 4444444444444441,
    "cvc": 123,
    "expires": "10/15"
  }
}

And you will get an order response like so:

{
  "id": "5cf4de3",
  "beer_id": "54cdef43",
  "tip": 5.99,
  "total": 12.39 
}

And if we want to check on the status of an order, we interact with the status resource:

POST /order/5cf4de3/status HTTP/1.1

And we would get a response like:

{
  "id":"54cder",
  "order_id": "5cf4de3",
  "last_updated":"2014-05-06:11-11-11",
  "status":"pending"
}