Classifications
***************

This part of the Bugzilla API allows you to deal with the available
classifications. You will be able to get information about them as
well as manipulate them.


Get Classification
==================

Returns an object containing information about a set of
classifications.

**Request**

To return information on a single classification using the ID or name:

   GET /rest/classification/(id_or_name)

+----------------+-------+---------------------------------------+
| name           | type  | description                           |
+================+=======+=======================================+
| **id_or_name** | mixed | An Integer classification ID or name. |
+----------------+-------+---------------------------------------+

**Response**

   {
     "classifications": [
       {
         "sort_key": 0,
         "description": "Unassigned to any classifications",
         "products": [
           {
             "id": 2,
             "name": "FoodReplicator",
             "description": "Software that controls a piece of hardware that will create any food item through a voice interface."
           },
           {
             "description": "Silk, etc.",
             "name": "Spider Secretions",
             "id": 4
           }
         ],
         "id": 1,
         "name": "Unclassified"
       }
     ]
   }

"classifications" (array) Each object is a classification that the
user is authorized to see and has the following items:

+-------------+--------+--------------------------------------------------------------+
| name        | type   | description                                                  |
+=============+========+==============================================================+
| id          | int    | The ID of the classification.                                |
+-------------+--------+--------------------------------------------------------------+
| name        | string | The name of the classification.                              |
+-------------+--------+--------------------------------------------------------------+
| description | string | The description of the classificaion.                        |
+-------------+--------+--------------------------------------------------------------+
| sort_key    | int    | The value which determines the order the classification is   |
|             |        | sorted.                                                      |
+-------------+--------+--------------------------------------------------------------+
| products    | array  | Products the user is authorized to access within the         |
|             |        | classification. Each hash has the following keys:            |
+-------------+--------+--------------------------------------------------------------+

Product object:

+-------------+--------+----------------------------------+
| name        | type   | description                      |
+=============+========+==================================+
| name        | string | The name of the product.         |
+-------------+--------+----------------------------------+
| id          | int    | The ID of the product.           |
+-------------+--------+----------------------------------+
| description | string | The description of the product.  |
+-------------+--------+----------------------------------+

======================================================================

This documentation undoubtedly has bugs; if you find some, please file
them here.