AnonAPI

From Pangeanic
Revision as of 07:07, 1 July 2022 by Admin (talk | contribs) (→‎Pangeanic Anonymization API)
(diff) ← Older revision | Latest revision (diff) | Newer revision → (diff)
Jump to navigation Jump to search

Pangeanic Anonymization API

External programs, legacy systems, programmers using console or API clients can access the anonymization functionalities using the generic APIs.


The updated description of APIs can be found at the following repositories:


Pangeanic’s API is a simple RESTFul implementation where typically the requests are sent as POSTs with a json encoded body. When handling files the content is sent or received in base-64 encoded form.


As an example, the API definition for the anonymization of a single sentence would be:

POST to endpoint: https://production_access_server_url:8080/NexRelay/v1/translate Headers: Content-Type : application/json

Request Body: { "src":"en", "tgt":"en", "apikey":"your_api_key", "engineid":"your_engine_id", "text":["My Name is John"] }

Answer Body: [

   [
       {
           "src": "My name is John",
           "tgt": "My name is _________"
       }
   ]

Both https and http endpoints are configurable in the Access Server.


List Engines [/corp/engines]

List All available engines [POST] This edpoint is required to list the list of IDs of the available engines fo your APIKey + Request (application/json)

       {
           "apikey": "your-apikey-here"
       }

Document Processing API

HOST: http://prod.pangeamt.com:8080/PGFile/v1

File Uploading [/sendfile]

Send a File [POST]


Main request. Send a file to the service for anonymization. The process parameters have to be included The success response is a json with file guid.

+ Request (multipart/form-data;boundary=----WebKitFormBoundary8M3sSU13ul5lXSJm)

       ------WebKitFormBoundary8M3sSU13ul5lXSJm
           Content-Disposition: form-data; name="json"


           {
               "title":"filename.docx",
               "processname":"translation",
               "engine":"123",
               "src":"en",
               "tgt": "en" ,
               "apikey":"your-apikey-here",
               "username": "testuser",
               "notiflink": "testlink",
               "processoption": "1"
           }
       ------WebKitFormBoundary8M3sSU13ul5lXSJm
           Content-Disposition: form-data; name="file"; filename="filename.docx"
           Content-Type: application/vnd.openxmlformats-officedocument.wordprocessingml.document
           data
       ------WebKitFormBoundary8M3sSU13ul5lXSJm--

+ Response 200 (application/json)

       {
       "fileId": "8d4e1c5be60d4e04850f55ec135f2554"
       }

+ Response 500 (application/json)

       {
       "error": true,
       "error_message" : "the-error-message"
       }


Checking file status [/checkfile?apikey&fileid]

Use /checkfile to get the processing status of a file, this is a json post where body can have three forms:

  • just the apikey, the response will return info about all files being processed for the apikey.
  • guid, to get info about a single file

Use a get request like:

https://server_address:server_port/PGFile/v1/checkfile?apikey=your_api_key

https://server_address:server_port/PGFile/v1/checkfile?apikey=your_api_key&guid=d9b95ffb3bc347efa6a7cb90ca80ca74
The returned answer is a json list containing one json object for every file. The important field returned for every file is the status, an integer with possible values:

  • 10, file is queued for process at the server
  • 6 or 7, file is being analyzed
  • 20, 30 or 40, file is being processed
  • 100, file processed successsfully, waiting download
  • 110 or 120, file downloaded
  • -10 or -20 (negative values), processing error

Check the processing status of a file [GET] + Response 200 (application/json)

       [
           {
               "fileId": "1dc77dc5ba6d44828b860537dae07187", 
               "translatedPath": None, 
               "engineId": 58, 
               "glossaryId": 0, 
               "src": "es", 
               "tgt": "en", 
               "isZip": False, 
               "ztot": 0, 
               "zfinished": 0, 
               "translatedName": None, 
               "processName": "translate", 
               "processOptionId": 1, 
               "link": "", 
               "status": 10, 
               "id": 16567, 
               "fileName": "test.txt"
           }
       ]

Checking and downloading file [/retrievefile]

This is a POST request that can be used to get info about a file that is being processed and download the processed file is process has finished.

    • WARNING** this endpoint is NOT safe for very big files: the file is returned in base64

encoding and requires a lot of memory at server and client side.

When file is finished a 200 response is returned with the file. If file is in processs a 200 response is returned with the status data. Errors will generate a 401 response.

Check and get File [POST]

+ Request (application/json)

       {
           "apikey": "your-api-key-here",
           "guid": "1dc77dc5ba6d44828b860537dae07187"
       }

+ Response 200 (application/json)

       # response when file is not finished
       {
           "success": True, 
           "error": {}, 
           "status": "10", 
           "data": {}
       }  
       # response when file is finished
       {
           "success": True,
           "error": {}, 
           "status": "110", 
           "data": {
               "guid": "d74b06fd52434ad2bfbe82ebbff96464", 
               "fileType": "txt", 
               "filename": "test.txt", 
               "file": "U2VlIHRoaW5ncyB0byBkbywgcmVzdGF1cmFudHMsIGFuZCBob3RlbHMNCg=="
           }
       }

+ Response 401 (application/json)

       {
           "success": False, 
           "error": {
               "statusCode": 401, 
               "code": 6, 
               "message": "Invalid GUID"
           }, 
           "data": {}
       }

Downloading file [/download?apikey&fileid]

Simple get request to retrieve a file. The get parameters are:

  • apikey
  • fileid, the file GUID

The file is returned as a stream (similar to a call to wget)