ver. 1633 (9589a0d)

Changes to the OKAPI interface or administration

Changes to the interface are always backward compatible. You need not to update your applications after any change. But there may be new recommendations (indicated by bold text) on how to use OKAPI methods.

The following changes are available at Opencaching.PL:

Version Date Change
1623 2017-09-14 Added services/caches/edit for changing geocaches' log passwords.
1564 2017-09-06 Added location field to services/logs/entry.
1545 2017-08-30 Fixed: Submitting OCPL event cache logs now exactly behaves like the native log functions.
1498 2017-08-18 Added options date_created and date_hidden to the services/caches/search order_by parameter.
1459 2017-06-13 The scheme for the installation URLs of several Opencaching sites has changed from http to https.
1398 2017-06-04 Added advice on the length of saved personal notes.
1381 2017-04-25 Documentation tags OCPL and OCDE have been added, informing about different behaviour of OKAPI methods on the two Opencaching code branches.
1337 2016-07-27 Found geocaches are now marked properly in services/caches/formatters/garmin method.
1287 2016-04-24 Added the log_uuids return field to services/logs/submit.
1282 2016-04-23 Some OKAPI installation can be accessed through multiple URLs. The new services/apisrv/installation field okapi_base_urls tells you which URLs are available for this installation.
1260 2016-04-09 Added the Changelog page.
1256 2016-04-05 The is_admin flag for users has been deprecated.
1255 2016-04-05 Improved submitting HTML log entries. The comment_format parameter of services/logs/submit now works consistent and deterministic on all OC sites.
1237 2016-03-31 New methods for adding, editing and deleting log images.
1200 2016-03-17 Consumer keys may be revoked by OC site admins.
1194 2016-03-17 Fixed: services/oauth/authorize will no longer delete Opencaching.DE cookies when called with parameter interactivity=confirm_user.
1184 2016-03-14 OCDE geocache log entries with and without time are more reasonably ordered. Developers are recommended to keep the order as returned by OKAPI instead of ordering by the log date.
1183 2016-03-13 The registration date of users can be retrieved.
1177 2016-03-12 Added the 'needs maintenance' flag to log entries and geocaches. The needs_maintenance option of services/logs/submit has been deprecated; use needs_maintenance2 instead.
1169 2016-03-11 Added Romanian translation.
1154 2016-03-04 For caches with the mark 'listing is outdated' (available only on some OC sites), a corresponding message is prepended to the description field. DO NOT rely on this message being there or having a certain content. It may change in the future.
1145 2016-02-10 The home location of users can be queried, if given in the user's profile (requires OAuth level 3).
1133 2016-01-16 The URL of the OC site's registration page can be retrieved via apisrv/installation.
1132 2016-01-15 Fixed: Restored the namespace definition for GPX.
1131 2016-01-15 Added an advice to the documentation on how to submit log entries without time.
1127 2016-01-14 Allowed to search for multiple users that (not) found a geocache.
1126 2016-01-07 Improved posting plaintext logs on OCPL sites.
1125 2015-12-22 Enabled full 21-bit Unicode for submitting logs on some OC sites.
1119 2015-11-26 Fixed: Solved rare problem when searching by distance or bbox (OKAPI crashed).
1117 2015-09-24 Added the new ignored_status search option which allows to search for caches ignored by the user. This replaces the exclude_ignored option, which has been deprecated.
1115 2015-09-20 There is a new Opencaching.FR website, which is a local view of Opencaching.DE. Use to access it.
1112 2015-09-09 Quicker refreshing of map tiles after geocache name changes.
1101 2015-08-01 Fixed: Return an HTTP 400 when "negative" dates are passed to services/logs/submit.
1100 2015-08-01 Fixed: Improved uuid creation for submitted logs.
1097 2015-08-01 services/caches/map/tile now is available to chosen consumers (closed BETA).
1095 2015-07-31 Fixed: Pipe chars (|) in user names are treated as errors.
1092 2015-07-28 The user's last-login date on the OC site is updated when running OAuth level 3 methods.
1089 2015-07-20 The OKAPI code repository has moved from Google Code to Github.
1074 2015-06-29 When quering the is_watched state of a geocache or searching for watched caches, indirect watches via geocache lists are included. (Geocache lists so far are available only at OCDE and cannot be directly accessed via OKAPI.)
1070 2015-03-29 has been removed from the list of OKAPI installations, because it is too outdated.
1069 2015-03-27 The new powertrail_only option allows to search for caches that are part of a powertrail (on some OC sites). This is a BETA feature, i.e. it may be changed or removed.
1065 2015-03-08 Updated the Introduction page, with additional advices on backward compatibility.
1062 2015-03-08 Interprete intervals of services/caches/search/bbox as greater-side-open instead of closed.
1061 2015-03-02 Fixed: Added missing oauth_token parameter to error redirect.
1059 2015-01-18 Added "stealth required" attribute (A74).
1056 2015-01-09 Fixed: Corrected the attribute assignments of OC.NL 'lost place' (A30 -> A29) and geodetic point (A2).
1053 2014-11-30 OKAPI has been deployed to Opencaching.RO.

This list shows only changes that are considered to be relevant for developers and site admins. Please consult the Git log for a complete history, including older changes.

OKAPI was started in August 2011 at the OCPL code branch, and it was deployed to the OCDE branch in April 2013.