Post request

Bouchots MUST expose an HTTP endpoint for posting messages.

This endpoint SHOULD accepts HTTP request using POST method.

Request body

Post endpoint SHOULD accept following fields in request body in multipart/form-data format.

message

Mandatory message body in BML format.

Bouchots SHOULD expect error invalid BML, invalid encoding and generally shit posting from moules.

lastId

Optional unique identifier of last known post by coincoin.

Request headers

User-Agent

Optional free text related to posting moule. Usually nickname or browser User Agent.

Response

Response body

If lastId parameters is set, Bouchots SHOULD produce an XML backend or TSV backend as response body with posts newer than lastId.

Response headers

X-Post-Id

Optional unique identifier of the post inserted by the request.

Alternatives

Alternative post endpoint methods/parameters/body/headers MAY be used and documented using discovery file.