Create an app

OAuth 2 flow

Present the auth webpage to the user: https://www.jinma.io/OAuth2Auth?ClientID=$APP_ID&RedirectURI=$REDIRECT_URI For mobile apps, use in-app browser tab, such as SFSafariViewController on iOS, and Custom Tabs on Android. Notice: You should not use in-app webview to present this /OAuth2Auth page. Read more on OAuth 2.0 for Native Apps.

The redirected URI will come with Code parameter. You should use https://www.jinma.io/OAuth2Token?ClientID=$APP_ID&Code=$CODE) to verify the code and finally get the user access token (AccessToken).

Publicity

All messages created on Jinma are publicly available.

However, we understand that accessing to all messages across the map for a specific user can be a serious privacy issue. So, APIs for getting messages of a specific user (ex./MsgsByGeo*User) would be only available with the user's access token, by default.

In other words, only after the user authorizes your app, so you are able to serve specifically his/her messages.

On the contrary, if your account aims to provide only public open data, not privacy-related, you can switch your account into Public account in user settings page, so APIs for getting messages of your account would be available without your access token! That is, for everyone's use! Yeah!