OKAPI: Difference between revisions

From Opencaching.eu
Jump to navigation Jump to search
(added some more details)
No edit summary
 
Line 4: Line 4:
[[Category:Opencaching-DE]]
[[Category:Opencaching-DE]]
[[Category:Opencaching-PL]]
[[Category:Opencaching-PL]]
The description below is primarily for OC administrators ''AND'' people who want
The description below is primarily for OC administrators ''AND'' people who want to help implement OKAPI backend.
to help implement OKAPI backend.
__NOTOC__
__NOTOC__
== About OKAPI ==
== About OKAPI ==
Line 12: Line 11:
'''OKAPI is a publically available [http://en.wikipedia.org/wiki/Application_programming_interface API] for "National Opencaching" sites.'''
'''OKAPI is a publically available [http://en.wikipedia.org/wiki/Application_programming_interface API] for "National Opencaching" sites.'''


* It provides OC site with a set of useful well-documented API methods,
* It provides Opencaching site with a set of useful well-documented API methods,
* Allows external developers to easily read public Opencaching data,
* Allows external developers to easily read public Opencaching data,
* Allows read and write private (user-related) data with OAuth Authentication.
* Allows read and write private (user-related) data with OAuth Authentication.
The project has grown to become a standard and common API for all National Opencaching.xx sites.
The project has grown to become a standard and common API for all National Opencaching.xx sites.


OKAPI is an integral part of the [[Opencaching-PL]] code fork, i.e. an OCPL site will run properly only with OKAPI installed. For the [[Opencaching-DE]] code fork, OKAPI is an optional plugin - all other services of the site will run independently from OKAPI.
OKAPI is an integral part of the [[Opencaching-PL]] code fork, i.e. an Opencaching-PL site will run properly only with OKAPI installed. For the [[Opencaching-DE]] code fork, OKAPI is an optional plugin - all other services of the site will run independently from OKAPI.


== List of OKAPI installations ==
== List of OKAPI installations ==
Line 39: Line 38:


=== OKAPI specific data ===
=== OKAPI specific data ===
OKAPI uses an internal mapping file [https://github.com/opencaching/okapi/blob/master/okapi/services/attrs/attribute-definitions.xml attribute-definitions.xml] for attribute assignments and GC equivalence.
To represent cache attributes in a GC compatible way, OKAPI defines a an internal [[ACODE]] and also generates the [[OCGS]] XML tag in GPX exports.
To represent cache attributes in a GC compatible way, OKAPI defines a an internal [[ACODE]] and also generates the [[OCGS]] XML tag in GPX exports.


== References ==
== References ==
<references />
<references />

Latest revision as of 10:52, 5 June 2019

The description below is primarily for OC administrators AND people who want to help implement OKAPI backend.

About OKAPI

OKAPI

OKAPI is a publically available API for "National Opencaching" sites.

  • It provides Opencaching site with a set of useful well-documented API methods,
  • Allows external developers to easily read public Opencaching data,
  • Allows read and write private (user-related) data with OAuth Authentication.

The project has grown to become a standard and common API for all National Opencaching.xx sites.

OKAPI is an integral part of the Opencaching-PL code fork, i.e. an Opencaching-PL site will run properly only with OKAPI installed. For the Opencaching-DE code fork, OKAPI is an optional plugin - all other services of the site will run independently from OKAPI.

List of OKAPI installations

Each installation URL (as above) provides full online documentation of OKAPI.

Other links you might want to check out

Developer information

Third party application developers must sign up for an application key on each existing OKAPI instance (each Opencaching website). See Signup page on OKAPI online documentation.

OKAPI specific data

OKAPI uses an internal mapping file attribute-definitions.xml for attribute assignments and GC equivalence.

To represent cache attributes in a GC compatible way, OKAPI defines a an internal ACODE and also generates the OCGS XML tag in GPX exports.

References

  1. Opencaching.DE includes other sites - Opencaching.IT, OpencachingSpain.ES and Opencaching.FR - which are in fact the one site visible on multiple domains. All three share one database, so you can access all their data (only) through Opencaching.DE OKAPI installation.