45 lines
1.9 KiB
XML
45 lines
1.9 KiB
XML
<xml>
|
|
<brief>Retrieve log entries of a specified user</brief>
|
|
<issue-id>80</issue-id>
|
|
<desc>
|
|
<p>Retrieve log entries of a specified user.</p>
|
|
</desc>
|
|
<req name='user_uuid'>
|
|
<p>ID of the user. (Use services/users/by_username to get it.)</p>
|
|
</req>
|
|
<opt name='limit' default='20'>
|
|
<p>Integer N. If given, no more than N logs will be returned (the most recent ones).
|
|
Maximum allowed value is 1000.</p>
|
|
<p>Note: Some users have thousands of log entries!</p>
|
|
</opt>
|
|
<opt name='offset' default='0'>
|
|
<p>Combined with the <b>limit</b> argument, this gives you an abbility to get
|
|
<b>all</b> log entries of the user (with multiple requests).</p>
|
|
</opt>
|
|
<common-format-params/>
|
|
<returns>
|
|
<p>A list of log entries, ordered by descending date. Each entry is a
|
|
dictionary of the following format:</p>
|
|
|
|
<ul>
|
|
<li><b>uuid</b> - ID of the log entry,</li>
|
|
<li>
|
|
<p><b>date</b> - date and time (ISO 8601) when the log entry was submitted.</p>
|
|
<p>Please note that log entries often contain dates only (with the times
|
|
truncated to midnight, as in the local timezone). In such cases, you may
|
|
want to avoid displaying the time. You may assume that if the <b>date</b>
|
|
value contains the "00:00:00" string, then it is date-only.</p>
|
|
</li>
|
|
<li><b>cache_code</b> - code of the geocache,</li>
|
|
<li>
|
|
<p><b>type</b> - string; log type. This could be <b>pretty much
|
|
everything</b>, but there are some primary types (see logs/entry
|
|
method for more info).</p>
|
|
</li>
|
|
<li>
|
|
<b>comment</b> - <a href='%OKAPI:docurl:html%'>HTML string</a>, text entered
|
|
with the log entry.
|
|
</li>
|
|
</ul>
|
|
</returns>
|
|
</xml> |