Privateer in tank-notes

Markdown Help

Privateer is a [plugin for tidldyweb](https://github.com/cdent/tiddlywebplugins.privateer) that makes it possible to generate a special URI for a private tiddler that allows access without requiring authentication. The idea is that if you have some private content you would like to share with one person, you mint a special URI for them.

The access only works for GET requests and only for the one URI.

The first version of privateer was used [on Tiddlyspace](http://privateer.tiddlyspace.com/). That space provides information on the API.

Below is a simple script for pasting content to a tank and then returning a privateer URI. You will need to generate an [[API]]@docs [auth key](/auth).

```
#!/bin/sh

# curl up the business for doing the whatsits

KEY='Your API Key Here'

TITLE=${1:-latestpaste}
HOST=${2:-https://tank.peermore.com}
BAG=${3:-Your Bag Here}

CONTENT=`echo; echo; cat`

URL=$HOST/bags/$BAG/tiddlers/$TITLE

STATUS=`curl --silent /tmp/curlout -w %{http_code} -X PUT -H "X-Tank-Key: $KEY" \
    -H "Content-Type: text/plain" \
    --data-binary "type: text/plain$CONTENT" \
    $URL`

if [ "$STATUS" = "000201" ] || [ "$STATUS" = "000204" ]
then
    curl -s -i -X POST -H "X-Tank-Key: $KEY" -H "Content-Type: application/json" \
        --data-binary "{\"uri\": \"$URL\"}" \
        $HOST/_ |grep '^Location:'
else
    echo $STATUS
    exit 1
fi
```

Autocomplete tags from:

Global tags Local tags