XML-RPC Protocol Method: postevent

Given all of the required information on a post, optionally adding security or meta data, will create a new entry. Will return the itemid of the new post.

Inputs
event Scalar. Required. The entry text the user is submitting. Carriage returns are okay (0x0A, 0x0A0D, or 0x0D0A), although 0x0D are removed internally to make everything into Unix-style line-endings (just \ns). Posts may also contain HTML, but be aware that the Dreamwidth server converts newlines to HTML &lt;BR&gt;s when displaying them, so your client should not try to insert these itself.

lineendings Scalar. Required. Specifies the type of line-endings you're using. Possible values are unix (0x0A (\n)), pc (0x0D0A (\r\n)), or mac (0x0D (\r) ). The default is not-Mac. Internally, Dreamwidth stores all text as Unix-formatted text, and it does the conversion by removing all \r characters. If you're sending a multi-line event on Mac, you have to be sure and send a lineendings value of mac or your line endings will be removed. PC and Unix clients can ignore this setting, or you can send it. It may be used for something more in the future.

subject Scalar. Required. The subject for this post. Limited to 255 characters. No newlines.

security Scalar. Optional. Specifies who can read this post. Valid values are public (default), private and usemask. When value is usemask, viewability is controlled by the allowmask.

allowmask Scalar. Optional. Relevant when security is usemask. A 32-bit unsigned integer representing which of the user's trust groups are allowed to view this post. Turn bit 0 on to allow anyone with basic access to read it. Otherwise, turn bit 1-30 on for every trust group that should be allowed to read it. Bit 31 is reserved.

year Scalar. Required. The current 4-digit year (from the user's local timezone).

mon Scalar. Required. The current 1- or 2-digit month (from the user's local timezone).

day Scalar. Required. The current 1- or 2-digit day of the month (from the user's local timezone).

hour Scalar. Required. The current 1- or 2-digit hour from 0 to 23 (from the user's local timezone).

min Scalar. Required. The current 1- or 2-digit minute (from the user's local timezone).

props Struct. Optional. Set arbitrary (but restricted) meta-data properties to this entry. See Journal Entries Metadata for the documentation of the keys and value data types.

usejournal Scalar. Optional. Journal username that authenticating user has 'usejournal' access in, as given in the 'login' mode. If posting to a shared journal, include this key and the username you wish to post to. By default, you post to the journal of "user" as specified above.

Outputs
itemid Scalar. Required. The unique number the server assigned to this post. Currently nothing else in the protocol requires the use of this number so it's pretty much useless, but somebody requested it be returned, so it is.

anum Scalar. Required. The authentication number generated for this entry. It can be used by the client to generate URLs, but that is not recommended. (See the returned 'url' element if you want to link to a post.)

url Scalar. Required. The permanent link address to this post. This is an opaque string--you should store it as is. While it will generally follow a predictable pattern, there is no guarantee of any particular format for these, and it may change in the future.