Specifying drilldown for the report action

curl --data "action=report&user=bob&project=demosthenes&x=category&y=state" http://localhost:8080/review/api

This request is asking for a top-level (no drilldown specified) summary of issues in the project demosthenes.

The x-axis of this summary will contain the issue categories, while the y-axis will reflect the issue state (such as new or existing). The response is shown here:

{
        "rows":[{"id":1,"name":"C and C++"}],
        "columns":[{"id":-1,"name":"Existing"},{"id":-1,"name":"New"}],
        "data":[[14,2]],
        "warnings":[]
}

To drill down into this information, or to follow the category tree one level down, we add a drilldown specific to the ID of the item into which we want to drill, on either the x or y axis:

curl --data "action=report&user=bob&project=demosthenes&x=category&y=state&xDrilldown=1" http://localhost:8080/review/api

This request is asking for the next level of the "C and C++" taxonomy to be shown on the x-axis, while the y-axis continues to reflect the issue state:

{
    "rows":[{"id":2, "name":"Attempt to use memory after free"}, {"id":3, "name":"Buffer Overflow"}, ...],
    "columns":[{"id":4, "name":"Existing"}, {"id":3, "name":"Fixed"}], 
    "data":[...],
    "warnings":[]
}

If no such drilldown is possible (for example, asking to drill into state makes no sense), then the top-level summary of that axis will be shown instead.