Attach (end point)

Interacting with the datasetd web service can be done with any web client. For documentation purposes I am assuming you are using curl. This command line program is available on most POSIX systems including Linux, macOS and Windows.

Attaches a document to a JSON Document using <KEY>, and <FILENAME>.

`http://localhost:8485/<COLLECTION_ID>/attachment/<KEY>/<FILENAME>`

Requires a “POST” method. The “POST” is expected to be a multi-part web form providing the source filename in the field “filename”. The document will be written for JSON document in the attachments sub directory under <KEY>.

Example

In this example the <COLLECTION_ID> is “t1”, the <KEY> is “one” and the content upload is “a1.png” in the home directory “/home/jane.doe”. The <SEMVER> is “0.0.1”.

    curl -X POST -H 'Content-Type: multipart/form-data' \
       -F 'filename=@/home/jane.doe/a1.png' \
       http://localhost:8485/t1/attachment/one/a1.png

NOTE: The URL contains the filename used in the saved attachment. If I did not want to call it “a1.png” I could have provided a different name in the URL path.