POST for Geraint

This is an HTTP POST endpoint. Any text/document you POST to this URL will be received by me.

Use with cURL:

To send a plain text message:

curl --data-binary "Hello, world" --header "Content-Type: text/plain" \
    {{url}}

To send an inline picture:

curl --data-binary @small-image.png --header "Content-Type: image/png" \
    {{url}}

To send a picture (or other document) as an attachment:

curl --data-binary @large-image.jpg --header "Content-Type: image/jpeg" \
    --header "Content-Disposition: attachment; filename=\"large-image.jpg\"" \
    {{url}}

Authentication

To authenticate yourself, you can follow an OAuth2-based flow for webhooks. You will need a webhook of your own to receive the token.

curl {{url}} \
    --data "response_type=token&client_id=http://example.com/&webhook_uri=http://example.com/webhook&state=12345"

If you don't have a webhook available, you may add other headers to indicate the sender (e.g. a "Link" with rel="author", or the "From" header borrowed from SMTP) but it will be marked as unverified.

curl --data-binary "Hello, world" --header "Content-Type: text/plain" \
    --header "Link: <mailto:somebody@example.com>;rel=\"author\"" \
    {{url}}

WebSocket support

I'm working on doing something better with WebSocket connections, but at the moment it saves all incoming messages, and I can reply if I happen to be online at the time.