Skip to content


Repository files navigation

This is a simple Android app demonstrating basic usage of the ShopTheRoe API.

Important stuff

Remember that this is proof of concept code. You should not carry over any of the following patterns to your app:

  • Not handling paging.

  • Not handling errors.

Getting the token

Since this is a mobile app you'll need to use the token response type when requesting authorization. The URL looks like this:<client_id>&state=random_state_string&redirect_uri=str-api-demo://cb

Take a look at the redirect_uri. That's a custom scheme that we register with Android by adding the following to our AndroidManifest.xml:

    <action android:name="android.intent.action.VIEW" />
    <category android:name="android.intent.category.DEFAULT" />
    <category android:name="android.intent.category.BROWSABLE" />
    <data android:scheme="str-api-demo" android:host="cb" />

Then, when the system tries to visit a link with that scheme (which is what happens when the authorization request completes successfully) your app will be invoked. You can tell that it was invoked through the custom scheme by looking at the intent action. We do that in onCreate:

Intent intent = getIntent();
if (intent.getAction() == Intent.ACTION_VIEW) {

Using the token

Once you have an access token you can make HTTP requests to the STR API. Volley is a good library for doing this. Just make sure you add the Authorization header. You do that in volley by overriding the getHeaders method of JsonObjectRequest:

public Map<String, String> getHeaders() throws AuthFailureError {
    Map<String, String> params = new HashMap<String, String>();
    params.put("Authorization", "Bearer " + mAccessToken);
    return params;

Custom URI scheme limitations

Currently the only custom URI scheme that the STR backend supports is str-api-demo. You can request your own scheme to be registered by contacting Directangular support.


Demo of the STR API on Android






No releases published


No packages published