RESTful API Server▲

Image non disponible

This example shows how to create and host simple RESTful web APIs in a small application using the QHttpServer class. This server accepts calls in REST style and can be used with its counterpart example RESTful Color Palette API client on the client side.

An application that obeys the REST constraints may be informally described as RESTful. The RESTful API Server allows create, read, update and delete operations of colors (unknown resource to be compatible with Reqres API) and users. The RESTful API Server also provides login/logout functionality. The example is based on Reqres API.

To run the server application, execute server binary:

 
Sélectionnez
./colorpaletteserver

or

 
Sélectionnez
./colorpaletteserver --port 1234

An optional port parameter may be provided to specify the port on which the server shall run.

 
Sélectionnez
httpServer.route(
        QString("%1").arg(apiPath), QHttpServerRequest::Method::Get,
        [&api](const QHttpServerRequest &request) { return api.getPaginatedList(request); });

In the example above, the route is specified for the GET method, which returns the JSON array with paginated list of items stored. To achieve that, the QHttpServer::route() method is used with the QHttpServerRequest::Method::Get enumeration.

 
Sélectionnez
httpServer.route(QString("%1/<arg>").arg(apiPath), QHttpServerRequest::Method::Get,
                 [&api](qint64 itemId) { return api.getItem(itemId); });

To get a single item from the list of entities, the item ID is passed in the request query.

 
Sélectionnez
httpServer.route(QString("%1").arg(apiPath), QHttpServerRequest::Method::Post,
                 [&api, &sessionApi](const QHttpServerRequest &request) {
                     if (!sessionApi.authorize(request)) {
                         return QHttpServerResponse(
                                 QHttpServerResponder::StatusCode::Unauthorized);
                     }
                     return api.postItem(request);
                 });

In this example, the route accepts POST method, which adds a new entry to the item list and returns a JSON object that represents the added entry. This request must be authorized. To authorize the request the value of the header TOKEN must be equal to previously returned token from the api/login or the api/register methods.

 
Sélectionnez
QHttpServerResponse postItem(const QHttpServerRequest &request)
{
    const std::optional<QJsonObject> json = byteArrayToJsonObject(request.body());
    if (!json)
        return QHttpServerResponse(QHttpServerResponder::StatusCode::BadRequest);

    const std::optional<T> item = factory->fromJson(*json);
    if (!item)
        return QHttpServerResponse(QHttpServerResponder::StatusCode::BadRequest);
    if (data.contains(item->id))
        return QHttpServerResponse(QHttpServerResponder::StatusCode::AlreadyReported);

    const auto entry = data.insert(item->id, *item);
    return QHttpServerResponse(entry->toJson(), QHttpServerResponder::StatusCode::Created);
}

Besides new entry as JSON object POST methods returns also different HTTP status code: