Custom App Marketplace

Customizing Your Own App Marketplace

Our Enterprise customers may also design and create a custom implementation of your own Validic App Marketplace. To deploy the marketplace, you will need your Organization’s ID, your Organization’s Access Token, and the User Access Token created when you provisioned the user.

The Validic App Marketplace is specific to each user, with a listing of all apps and its appropriate sync, refresh, and unsync URLs. To sync an application, simply use the sync
URL for the app which will bring the user to the app’s authorization page. Similarly, to unsync the app, simply pass on the unsync url for the app. The refresh URL on the other hand acts as a trigger to fetch on demand that user’s app data from the source.

The unsync and refresh URLs are only available once the app has been synced.

GET https://api.validic.com/v1/organizations/5176906c6deddac02c000001/apps.json?authentication_token=d18397e3845e8b66f7453dc55ea3fc445d1b879a6f96ebe7b243badabce08c98&access_token=e61467e3845e8a66f7453dc55ea3fc445d1b879a6f96ebe7b243badbeae04f63

200
{
  "summary": {
    ...
  },
  "apps": [
    {
      "name": "Fitbit",
      "sync_url": "https://app.validic.com/organizations/5176906c6deddac02c000001/auth/fitbit?user_token=d18397e3845e8b66f7453dc55ea3fc445d1b879a6f96ebe7b243badabce08c98&format_redirect=json",
      "unsync_url": "https://app.validic.com/organizations/5176906c6deddac02c000001/unsync/fitbit?user_token=d18397e3845e8b66f7453dc55ea3fc445d1b879a6f96ebe7b243badabce08c98&format_redirect=json",
      "refresh_url": "https://app.validic.com/organizations/5176906c6deddac02c000001/refresh/fitbit?user_token=d18397e3845e8b66f7453dc55ea3fc445d1b879a6f96ebe7b243badabce08c98&format_redirect=json",
      "download_link": "https://www.fitbit.com/product/mobile/iphone",
      "excerpt": "Fitbit will help you lead a healthier, more active life. The Fitbit family motivates you to stay active, live better and reach your goals. ",
      "extra_excerpt": "Let's make fitness a fun, achievable part of everyday life. Our products track your health and fitness, then sync wirelessly to offer insight and encouragement whether you're online or on the go. So get ready to go farther.",
      "subname": "fitbit",
      "kind": [
        "fitness",
        "nutrition",
        "walking",
        "running",
        "jogging",
        "swimming",
        "hiking",
        "elliptical",
        "ballet",
        "bowling",
        "bicycling",
        "horseback_riding",
        "gardening",
        "yoga",
        "calorie_tracking",
        "meal_tracking"
      ],
      "logo_url": "/assets/appicons/fitbit-icon.jpg",
      "platform_types": [
        "Web",
        "iOS",
        "Android",
        "BlackBerry"
      ],
      "synced": true,
      "last_sync": "2013-03-10T00:00:00+00:00"
    },
    ...
  ]
}

Params

#
Controlling Sync, Refresh and Unsync redirect behavior

For custom marketplace implementations, additional control over the behavior of a sync, unsync, or refresh call may be added through a redirect_uri parameter

GET https://app.validic.com/organizations/5176906c6deddac02c000001/auth/fitbit?user_token=d18397e3845e8b66f7453dc55ea3fc445d1b879a6f96ebe7b243badabce08c98&format_redirect=json&redirect_uri=https://google.co

This will redirect the user the specified resource after a successful request.

#
Additional Display of Supported Devices

You may additionally display supported devices for each app by adding an expanded filter and setting it to 1.

GET https://api.validic.com/v1/organizations/5176906c6deddac02c000001/apps.json?authentication_token=d18397e3845e8b66f7453dc55ea3fc445d1b879a6f96ebe7b243badabce08c98&access_token=e61467e3845e8a66f7453dc55ea3fc445d1b879a6f96ebe7b243badbeae04f63&expanded=1

200
{
  summary": {
    ...
  },
  "apps": [
    {
      "name": "Fitbit",
      "sync_url": "https://app.validic.com/organizations/5176906c6deddac02c000001/auth/fitbit?user_token=d18397e3845e8b66f7453dc55ea3fc445d1b879a6f96ebe7b243badabce08c98&format_redirect=json",
      "unsync_url": "https://app.validic.com/organizations/5176906c6deddac02c000001/unsync/fitbit?user_token=d18397e3845e8b66f7453dc55ea3fc445d1b879a6f96ebe7b243badabce08c98&format_redirect=json",
      "refresh_url": "https://app.validic.com/organizations/5176906c6deddac02c000001/refresh/fitbit?user_token=d18397e3845e8b66f7453dc55ea3fc445d1b879a6f96ebe7b243badabce08c98&format_redirect=json",
      "download_link": "https://www.fitbit.com/product/mobile/iphone",
      "excerpt": "Fitbit will help you lead a healthier, more active life. The Fitbit family motivates you to stay active, live better and reach your goals. ",
      "extra_excerpt": "Let's make fitness a fun, achievable part of everyday life. Our products track your health and fitness, then sync wirelessly to offer insight and encouragement whether you're online or on the go. So get ready to go farther.",
      "subname": "fitbit",
      "kind": [
        "fitness",
        "nutrition",
        "walking",
        "running",
        "jogging",
        "swimming",
        "hiking",
        "elliptical",
        "ballet",
        "bowling",
        "bicycling",
        "horseback_riding",
        "gardening",
        "yoga",
        "calorie_tracking",
        "meal_tracking"
      ],
      "logo_url": "/assets/appicons/fitbit-icon.jpg",
      "platform_types": [
        "Web",
        "iOS",
        "Android",
        "BlackBerry"
      ],
      "synced": true,
      "last_sync": "2013-03-10T00:00:00+00:00",
      "items_supported": [
        {
          "name": "Fitbit Aria Scale",
          "type": "In-home Device",
          "description": "Aria™ tracks your weight, body fat percentage, and BMI, painting a picture of your long-term progress. It wirelessly syncs your stats with online graph and mobile tools that help you stay motivated and on track. When you're in
control, stepping on the scale feels good.",
          "excerpt": "Wi-fi Smart Scale",
          "resource_url": "https://www.fitbit.com/aria",
          "data_objects": [
            "weight",
            "biometrics"
          ],
          "kind": [
            "weight",
            "biometrics"
          ],
          "image_url": "https://static6.fitbit.com/simple.b-dis-png.h9e38e9e1e5f4be5c341edc1ef6dd77ac.pack?items=%2Fcontent%2Fassets%2Fonezip%2Fimages%2Fproducts%2Faria%2FAria_side_angle_white_large.png",
          "discontinued": false
        },
        ...
      ]
    },
    ...
  ]
}

Params

For more information regarding data filters, please visit the Filters section of our documentation.

View More >