service-reporting/README.md

   1 # PDF Service
   2
   3 Provides a REST-API to generate PDF reports for terms and their sentiment analysis results. The service uses an .NET Core wrapper for the wkhtmltopdf library to generate pdf out of html code.
   4
   5 `GET`: `/` Shows a demo page
   6 - param: none
   7 - return: pdf file
   8
   9 `POST`: `/generatePDF/` Generates a pdf report for the given terms
  10 - Header: `Content-Type`: `application/json`
  11 (optional) `Accept`: `application/base64` if the pdf should be in base64 instead of `application/pdf`
  12 - Body of request: Term[] e.g.
  13 ```json
  14 [
  15   {
  16     "name": "term 1",
  17     "sentiment": 0.1
  18   },
  19   {
  20     "name": "term 2",
  21     "sentiment": 0.3
  22   },
  23   {
  24     "name": "term 3",
  25     "sentiment": 0.7
  26   }
  27 ]
  28 ```
  29 - return: pdf file
  30
  31 ## API errors
  32 `TODO`
  33
  34 ### Term model
  35 Term(string `Name`, double `Sentiment`)
  36
  37 ## run with docker
  38 - `docker build -t service-reporting .`
  39 - `docker run -p YOUR_PORT:8083 service-reporting:latest`
  40
  41 ## run local
  42 ### requirements
  43 - .net core 2.2
  44 - download [libwkhtml library](https://github.com/rdvojmoc/DinkToPdf/tree/master/v0.12.4) depending on your operating system and put it into `service-reporting` root folder
  45 ### commands
  46 - `dotnet run`
  47
  48 ## examples
  49 - successfull pdf as application/json: `curl -X POST  http://localhost:8083/generatePDF  -H 'Content-Type: application/json'  -d '[ { "name": "A bad term", "sentiment": 0.1 }, { "name": "Another bad term", "sentiment": 0.3 }, { "name": "A neutral term", "sentiment": 0.5 }, { "name": "A good term", "sentiment": 0.65 }, { "name": "Another good term", "sentiment": 0.9 } ] ' -vs > test1.pdf`
  50 - successfull pdf as application/base64: `curl -X POST http://localhost:8083/generatePDF -H 'Accept: application/base64' -H 'Content-Type: application/json' -d '[ { "name": "A bad term", "sentiment": 0.1 }, { "name": "Another bad term", "sentiment": 0.3 }, { "name": "A neutral term", "sentiment": 0.5 }, { "name": "A good term", "sentiment": 0.65 }, { "name": "Another good term", "sentiment": 0.9 } ] ' -vs | base64 -d > test2.pdf`
  51 - invalid sentiment value: `curl -X POST http://localhost:8083/generatePDF -H 'Content-Type: application/json' -d '[ { "name": "Term with invalid sentiment value", "sentiment": 12 } ] ' -vs && echo`
  52 - invalid json structure: `curl -X POST http://localhost:8083/generatePDF -H 'Content-Type: application/json' -d '[ { "name1": "A term with invalid json format", "sentiment": 0.5 } ] ' -vs && echo`