OAuth
While developers may access the PublicEarth API using traditional HTTP Basic authentication, the preferred
method is to use OAuth authentication. In order to access the API using OAuth, please register your
application below.
We support three types of authentication. Read-only actions, such as finding and displaying place information,
supports two-legged OAuth, whereby only your application key and secret are required to make the
request. To update information on PublicEarth, a three-legged request is required, such that the
user has visited the PublicEarth web site and approved your application’s access to his or her account.
To support desktop and mobile applications that don’t have the required OAuth callback URL, we also support
a pin-based authentication. This is similar to three-legged OAuth, in that the user must be forwarded
to the PublicEarth web site for authentication. But instead of returning to your application, the user is
presented with a 5-digit pin code. The user types that pin code into your application, and your application
may request the OAuth access token information via the pin code.
We support hmac-sha1.