API calls involving file upload and download

File download

API calls involving file download through API client are noteworthy because if the request fails, the API client will continue to show the "loading" icon indefinitely.

To avoid this, make all file download calls through CURL instead. An example of a file download call using CURL is below.

CODE

curl -X GET --header 'Accept: application/octet-stream' --header
'Authorization: ec443730-124e-4958-a872-324a975bb500'
-o "/home/user/downloads"
'http://<myMaskingEngine>/masking/api/file-downloads/EXPORT-ZXhwb3J0X2RvY3VtZW50X2dGZU9JMVYxLmpzb24%3D'

The -o flag from above specifies the location to save the file to.

File upload

API calls involving file upload are noteworthy because the generated curl from the Masking API client will be missing the parameter referencing the file; as such, those commands from the Masking API client will not work.

Instead, below are examples of working requests and responses for API calls involving file upload.

For commands specific to your masking engine, work with your interactive client at http://<myMaskingEngine>/masking/api-client/

HTTPS (SSL/TLS) is recommended, but for explanatory purposes these examples use insecure HTTP.

In all code examples, replace \<myMaskingEngine> with the hostname or IP address of your virtual machine.

Creating a file format

REQUEST

CODE

curl -X POST --header 'Content-Type: multipart/form-data' --header
'Accept: application/json' --header 'Authorization:
d1313dd8-2ed9-4699-8e88-2b6a089ae2a6' -F
fileFormat=@/path/to/file_format/delimited_format.txt -F
fileFormatType=DELIMITED
'http://<myMaskingEngine>/masking/api/file-formats'

RESPONSE

CODE

{ "fileFormatId": 123, "fileFormatName": "delimited_format.txt",
"fileFormatType": "DELIMITED"
}

More info

http://<myMaskingEngine>/masking/api-client/#!/fileFormat/createFileFormat

Creating an SSH Key

REQUEST

CODE

curl -X POST --header 'Content-Type: multipart/form-data' --header
'Accept: application/json' --header 'Authorization:
d1313dd8-2ed9-4699-8e88-2b6a089ae2a6' -F
sshKey=@/path/to/ssh_key/this_file_name_is_your_ssh_key_name.txt
'http://<myMaskingEngine>/masking/api/ssh-keys'

RESPONSE

CODE

{ "sshKeyName": "this_file_name_is_your_ssh_key_name.txt"
}

More info

http://<myMaskingEngine>/masking/api-client/#!/sshKey/createSshKey