Api introduction

[ael-code]

Overview

Api was implemented thanks to a blueprint module inside webant.

With this pr we are going to expose all GET functionalities provided by archivant.

The rest api are graph-organized:

• search and get volumes (with pagination support): /volumes/
• get specific volume: /volumes/<volumeID>
• get all attachments of a volume: /volumes/<volumeID>/attachments/
• get specific attachment: /volumes/<volumeID>/attachments/<attachmentID>
• get file associated with an attachment: /volumes/<volumeID>/attachments/<attachmentID>/file

Errors

The following is an error example:

{
  "error": {
    "code": 404, 
    "message": "volume not found",
    "details": "could not found volume with id: 'not666not'"
  }
}

Testing

the blueprint is registered at /api/v1
to start you can try with /api/v1/volumes/

To be done

• documentation
• expose all other functionalities provided by archivant.

[boyska]

The code seems very good. It would be incredibly cool to have unit tests for http "things", so that we don't have to manually test all of the APIs :/