= Tagging API =
fulfills use case: UseCaseTagging

implemented in gnowsis-server and the PIMO.

= Using Tagging API from other applications via HTTP =

To use the TagingAPI from Mozilla Firefox and Thunderbird, tags are transmitted as comma separated list via httprequest.

Request from Mozilla Thunderbird:

 * get me tags that contain this string X. Things have to have X in label, altLabel, wikiname or wikitext
   * string x
 * result: 
   * list of:tag-uri + tag + class of tag 


 * get me tags fitting to this email: 
   * message-id
   * subject
   * body
 * result: 
   * list of:tag-uri + tag + class of tag 

 * get me the tags that are already associated to this email(s) (input either one e-mail or many) (has to be fast-as-hell). Used to augment the display of large lists of emails, for example the inbox.
   * message-id
 * result:
   * list of:tag-uri + tag + class of tag 

 * tag this e-mail using that tag:
   * message-id
   * tag-uri
   * operation: add tag/remove tag
 * result:
   * ok/error

 * tag this e-mail using that tag-name:
   * message-id
   * tag-name (the label)
   * operation: add tag/remove tag
 * result:
   * has to create a NEW TAG if tag-name does not exists, creates a URI for the tag.
   * return new tag-uri + ok/error


To identificate an email, we should use the Message-ID and not the mail-uri, because if an email is moved to another folder we will loss the relation of the tags to this mail.