getdaycounts — This mode retrieves the number of journal entries per day. Useful for populating calendar widgets in GUI clients.
This mode retrieves the number of journal entries per day. Useful for populating calendar widgets in GUI clients.
The protocol request mode:
Username. Leading and trailing whitespace is ignored, as is case.
The authentication method used for this request. Default is 'clear', for plain-text authentication. 'cookie' or any of the challenge-response methods are also acceptable.
Deprecated. Password in plain-text. For the default authentication method, either this needs to be sent, or
Deprecated. Alternative to plain-text
password. Password as an MD5 hex digest. Not perfectly secure, but defeats the most simple of network sniffers.
If using challenge-response authentication, this should be the challenge that was generated for your client.
If using challenge-response authentication, this should be the response hash you generate based on the challenge's formula.
(Optional) Protocol version supported by the client; assumed to be 0 if not specified. See Chapter 27, Protocol Versions for details on the protocol version.
(Optional) If getting the day counts of a shared journal, include this key and the username you wish to get the counts of. By default, you load the counts of "user" as specified above.
OK on success or
FAIL when there's an error. When there's an error, see
errmsg for the error text. The absence of this variable should also be considered an error.
The error message if
FAIL, not present if
OK. If the success variable is not present, this variable most likely will not be either (in the case of a server error), and clients should just report "Server Error, try again later.".
For each day that the user has posted a journal entry, a key in the form
yyyy-mm-dd is returned, with the value being the number of entries posted that day. The absence of a key implies zero entries for that day, as well as the presence of a key with the value "
0". Note that
dd are always two digits, zero padded, so the total key length will always be 10 characters.