Tukukkk

I am currently implementing a RESTFUL API that provides endpoints to interface with a database .

I want to implement filtering in my API , but I need to provide an endpoint that can provide a way to apply filtering on a table using all the table's columns.

I've found some patterns such as :

GET /api/ressource?param1=value1,param2=value2...paramN=valueN

param1,param2...param N being my table columns and the values.

I've also found another pattern that consists of send a JSON object that represents the query .

To filter on a field, simply add that field and its value to the query :

GET /app/items

{

  "items": [

    {

      "param1": "value1",

      "param2": "value",

      "param N": "value N"

    }

  ]

}

I'm looking for the best practice to achieve this .

I'm using EF Core with ASP.NET Core for implementing this.

Firstly be cautious about filtering on everything/anything. Base the available filters on what users will need and expand from that depending on demand. Less code to write, less complexity, fewer indexes needed on the DB side, better performance.

That said, the approach I use for pages that have a significant number of filters is to use an enumeration server side where my criteria fields are passed back their enumeration value (number) to provide on the request. So a filter field would comprise of a name, default or applicable values, and an enumeration value to use when passing an entered or selected value back to the search. The requesting code creates a JSON object with the applied filters and Base64's it to send in the request:

I.e.

{

  p1: "Jake",

  p2: "8"

}

The query string looks like:
.../api/customer/search?filters=XHgde0023GRw....

On the server side I extract the Base64 then parse it as a Dictionary<string,string> to feed to the filter parsing. For example given that the criteria was for searching for a child using name and age:

// this is the search filter keys, these (int) values are passed to the search client for each filter field.

public enum FilterKeys

{

    None = 0,

    Name,

    Age,

    ParentName

}



public JsonResult Search(string filters)

{

    string filterJson = Encoding.UTF8.GetString(Convert.FromBase64String(filters));

    var filterData = JsonConvert.DeserializeObject<Dictionary<string, string>>(filterJson);



    using (var context = new TestDbContext())

    {

        var query = context.Children.AsQueryable();



        foreach (var filter in filterData)

            query = filterChildren(query, filter.Key, filter.Value);



        var results = query.ToList(); //example fetch.

        // TODO: Get the results, package up view models, and return...

    }

}



private IQueryable<Child> filterChildren(IQueryable<Child> query, string key, string value)

{

    var filterKey = parseFilterKey(key);

    if (filterKey == FilterKeys.None)

        return query;



    switch (filterKey)

    {

        case FilterKeys.Name:

            query = query.Where(x => x.Name == value);

            break;

        case FilterKeys.Age:

            DateTime birthDateStart = DateTime.Today.AddYears((int.Parse(value) + 1) * -1);

            DateTime birthDateEnd = birthDateStart.AddYears(1);

            query = query.Where(x => x.BirthDate <= birthDateEnd && x.BirthDate >= birthDateStart);

            break;

    }

    return query;

}



private FilterKeys parseFilterKey(string key)

{

    FilterKeys filterKey = FilterKeys.None;



    Enum.TryParse(key.Substring(1), out filterKey);

    return filterKey;

}

You can use strings and constants to avoid the enum parsing, however I find enums are readable and keep the sent payload a little more compact. The above is a simplified example and obviously needs error checking. The implementation code for complex filter conditions such as the age to birth date above would better be suited as a separate method, but it should give you some ideas. You can search for children by name, and/or age, and/or parent's name for example.