rev. 334
services/apiref
services/apisrv
services/caches
services/caches/formatters
services/caches/search
services/caches/shortcuts
services/logs
services/oauth
services/replicate
services/users

Submit a log entry
:: services/logs/submit method

Minimum Authentication: Level 3 (see Authentication Levels)
http://www.opencaching.us/okapi/services/logs/submit

Submit a log entry for the geocache. Please note, that you won't be able to use this method until you learn to handle OAuth.

cache_code required

Code of the geocache.

logtype required

Type of an entry. This should be one of: Found it, Didn't find it or Comment.

comment optional

Text to be submitted with the log entry. Plain-text (no HTML).

when optional

A date and time string, in any reasonable format (any acceptable by PHP's strtotime function, ISO 8601 preffered).

Indicates when the cache was found. If given, the log will be published with the given date and time. If not, log will be published using the current date and time.

password optional

Some caches require a password in order to submit a "Found it" log entry. You may check if this cache requires password with req_passwd field of the services/caches/geocache method.

format optional Standard common formatting argument.
callback optional Standard common formatting argument.
Plus required standard OAuth Consumer signing arguments: oauth_consumer_key, oauth_nonce, oauth_timestamp, oauth_signature, oauth_signature_method, oauth_version. Plus 1 oauth_token for Token authorization.

Returned value:

A dictionary of the following structure:

  • success - true, if the log entry was submitted successfully,
  • message - plain-text string, a message which acknowledges success or describes an error (some comments may be rejected),
  • log_uuid - ID of the newly created log entry, or null in case of an error.