API

Hate XML? You'll love Tokumei's API.

Replace http://example.onion with the location of the Tokumei site you're using.

Read

Just GET these simple files:

http://example.onion/p/1.txt: Plain text contents of post #1. IDs start at 1.
http://example.onion/p/1_werc/tags: Post #1's tags. One per line.
http://example.onion/p/1_werc/filetype: Post #1's file extension. Use it to determine the location of the file attachment below.
http://example.onion/p/1_werc/file.*: Post #1's file attachment. For example, if filetype above returns png, fetch file.png.
http://example.onion/p/1_werc/spam: Number of times post #1 has been flagged as spam.
http://example.onion/p/1_werc/replies/0: Plain text contents of reply #0 to post #1. IDs start at 0.
http://example.onion/p/1_werc/postnum: Post #1's most recent reply ID, or number of replies minus 1.
http://example.onion/postnum: Most recent post ID, or total number of posts (not including replies).
http://example.onion/_werc/tags/tokumei: IDs of all posts tagged with #tokumei. One per line.
http://example.onion/_werc/trending: Space-separated list of the top 10 trending tags.

You can check the modify timestamp in a post or reply file's metadata to see the day it was created. The exact time is stripped to improve anonymity.

Write

Just POST these fields to http://example.onion/p/:

New post
comment: the post text
tags: comma-separated tags (optional)
file: image attachment URL (optional)
password: deletion password (optional)
Reply
comment: the reply text
parent: the post to reply to

Examples

Working with Tokumei's API in another language? Send some example code to hello@tokumei.co and we'll add it here.

rc shell

Get the text of every post tagged with #tokumei:

for(i in `{curl http://example.onion/_werc/tags/tokumei})
    curl http://example.onion/p/$i.txt

Get the approximate creation date of post #1 in seconds since Epoch:

wget http://example.onion/p/1.txt
stat -c %Y 1.txt

Create a new post:

curl -d 'comment=First line%0ASecond line' \
     -d 'tags=firsttag, secondtag' \
     -d 'file=https://example.com/file.png' \
     -d 'password=supersecret' \
     http://example.onion/p/

Reply to post #1:

curl -d 'comment=First line%0ASecond line' \
     -d 'parent=1' \
     http://example.onion/p/

Java / Qt Jambi

There is a partial reference client in Java: Toqumei.

API