Catalog API

With EASE, Apperian provides App Catalogs that you can distribute to your mobile end users. These catalogs enable users to see all the enterprise apps they are authorized to access. Users can search for and install apps, access screen shots and related media such as PDF files and videos, install app updates, and more. For more about the App Catalogs provided with EASE, see Managing App Catalogs.

Using the Catalogs API, you can build your own enterprise app catalog, or integrate the ability for users to access and install apps into another system, such as a corporate portal.

The Catalogs API lets you:

  • Authenticate and register an app catalog.
  • List applications available to the authenticated user.
  • List data for a specific application.
  • List apps ranked by popularity (number of downloads).
  • List featured applications.
  • List apps by category.
  • Search for apps.
  • Search application data for a query string.
  • List downloaded, updated, mandatory updates, and installed apps.
  • Post a list of installed apps.

Note

EASE assigns a unique ID to each application you add to EASE. With the Publishing API, this ID is returned as an appID. With other API resources, it is returned as either an app_psk or app_id (or both). When you send a request to any REST API resources where you need to specify an ID for an application, you can send the appID, app_id, or app_psk; EASE accepts the value of any of these parameters.

Resources

POST /v1/catalog/authenticate/

Authenticate User and Register App Catalog

Attention

There is a newer version of this resource available: GET /v2/catalog/authenticate/. This v1 version will be deprecated 2018; please modify your code to use the latest V2 version. If you have any questions, contact support@apperian.com.

Use this resource to authenticate an App Catalog user, and optionally register the App Catalog with EASE. This is the authenticate resource you need to call to authenticate users for requests to Catalog API, Downloads and Installs API, and Reviews API resources. For requests to other APIs, make a call to the POST /users/authenticate resource. Unlike the other authenticate resource, with this resource you provide not only the user ID and password for a valid EASE user, but also information about the user’s device. This enables EASE to respond with data appropriate for both the user and the device. For example, you can request a list of applications that can both run on the device (they are built for the correct operating system) and be accessed by the user (they are assigned to a group to which the user is a member).

To authenticate a user, you specify the user ID and password for a valid EASE user. EASE responds with a unique session token that you can then provide in the HTTPS header (as X-TOKEN: {token}) of one or more subsequent requests to the Catalog API, Downloads and Installs API, and Reviews API. The token authenticates a specific user, so you will need to provide different tokens based on who you need to authenticate during the transaction. Within an API session, if you need to connect as the same user for multiple requests, you can use the same token.

To register an App Catalog, you provide the bundle/package ID and version number of the App Catalog installed on the user’s device. EASE uses this information to create (if not already created) or identify a unique identifier for the device–the “device ID.” A device ID associates a user with a particular App Catalog version and device. Device ID is used with many functions in EASE.

Note

This resource authenticates users with the default EASE authentication method. Single Sign-On (SSO) authentication to EASE is not yet supported through the Apperian API.

URLs

Environment URL
North America https://na01ws.apperian.com/v1/catalog/authenticate
Europe https://eu01ws.apperian.eu/v1/catalog/authenticate

URL Parameters

None

Header Parameters

X-BUNDLE-ID
(Required only if register_catalog is set to true) App Catalog bundle ID (iOS) or package ID (Android, Windows 8, and Windows Phone). For example: --header "X-BUNDLE-ID: com.apperian.hub.ios"
X-VERSION-NUM
(Required only if register_catalog is set to true) App Catalog version number. For example: --header "X-VERSION-NUM: 1.2.3"
Content-Type
(Required with all requests) Specifies the content type of the body of data sent with the request. Set to:
application/json

Data Parameters

user_id
(Required) User ID of the authenticating user. The session token will be tied to this user.
password
(Required) User’s password.
remember_me
(Required)
  • true specifies that the session token will use the Remember Me expiration timeout for the organization.
  • false specifies that the session token will use the default session expiration defined for the organization. With the EASE App Catalog, this is set when the user selects a Remember Me option on the Login page.
register_catalog
(Required)
  • true registers the App Catalog and version number specified in the header of the request.
  • false does not register an App Catalog. Use this setting only if you are requesting data for a catalog that is not installed on a user’s device. For example, an enterprise portal.
device_info

(Required) Device information used to identify the device. Include the following parameters:

manufacturer
The device manufacturer.
operating system

A code for the operating system running on the device. Use one of these codes:

0 Unknown
1 iOS
102 Android 2
103 Android 3
104 Android 4
105 Android 5
106 Android 6
107 Android 7
108 Android 8
401 Windows Phone 8
operating_system_name
The name of the operating system running on the device.
operating_system_version
The version of the operating system running on the device.
name
The device name.
udid

(Required) A unique identifier for the device. When EASE receives this identifier, it looks to see if it already exists in the EASE database. If it does not, EASE creates a new entry for the device.

For this type of device... Provide this ID...
iOS The vendor ID for your custom App Catalog app.
Android The Wifi Mac address of the device.
Windows Phone A unique ID fetched using the Windows PhoneDeviceExtendedProperties.GetValue method.
Windows 8 The first network device’s mac address.
apns_token (iOS)

Push notification token received from Apple.

To get this token, you will need to register to receive push notifications via Apple Push Notification Service. For instructions, see the iOS Developer Library.

form_factor

The form factor of the device. Use one of these codes:

0 Unknown
1 Phone
2 Tablet
model
The device model.
total_ram
Total RAM on the device. DATA TYPE: integer
free_ram
Available RAM on the device. DATA TYPE: integer
total_storage
Total storage on the device. DATA TYPE: integer
free_storage
Available storage on the device. DATA TYPE: integer
camera
Whether or not the device has a camera. DATA TYPE: boolean
front_camera
Whether or not the device has a front camera. DATA TYPE: boolean
flash
Whether or not the device supports a flash. DATA TYPE: boolean

For example:

"device_info": {  "manufacturer": "Apple, Inc.", "operating_system": "1", "operating_system_name": "iPhone OS", "operating_system_version": "7.1.1", "name": "Harry's iPhone", "udid": "[some guid]", "form_factor": 1, "model": iPhone5,1"}

Example Request

The following cURL command authenticates the rjames user.

curl -X POST  https://na01ws.apperian.com/v1/catalog/authenticate/ --header "Content-Type: application/json" --data '{"user_id": "rjames", "password": "123456", "remember_me": true, "register_catalog": true, "device_info": {"manufacturer": "Apple, Inc.", "operating_system": "1", "operating_system_name": "iPhone OS", "operating_system_version": "7.0.6", "name": "Kiosk iPad 1", "udid": "FFFFFFFFA8DF6FB4697A44C09DDFBB7D87B83269", "form_factor": "2", "model": "iPad2,2"}}' --header "X-BUNDLE-ID: com.apperian.appcatalog" --header "X-VERSION-NUM: 3.0.316"

Example Response

The response returns a unique session token. It also returns data about the user, the user’s organization, and the user’s device.

{
     "device": {
       "front_camera": false,
       "operating_system_name": "iPhone OS",
       "controllable_status": 0,
       "pairing_status": 0,
       "mdm_id": null,
       "form_factor": 2,
       "mdm_user_id": null,
       "until_date": "9999-12-31T23:59:59.999999",
       "total_ram": 0,
       "flash": false,
       "apns_token": null,
       "total_storage": 0,
       "camera": false,
       "psk": 75946,
       "operating_system_version": "7.0.6",
       "mdm_status": 0,
       "user": {
         "psk": 103031
       },
       "manufacturer": "Apple, Inc.",
       "operating_system": 1,
       "name": "Kiosk iPad 1",
       "jailbreak_status": -1,
       "created": "2015-07-29T01:58:11.426548+00:00",
       "udid": "FFFFFFFFA8DF6FB4697A44C09DDFBB7D87B83339",
       "free_storage": 0,
       "mdm_status_update_date": null,
       "free_ram": 0,
       "supervised": -1,
       "model": "iPad2,2",
       "disabled_reason": null,
       "single_app_mode_app_psk": null
     },
     "organization": {
       "psk": 1062,
       "app_installation_path": "Enterprise Apps",
       "name": "Example Company 8"
     },
     "token": "2vycuVpYR7O_imehLjU92A",
     "ttl_in_seconds": 604799,
     "user": {
       "psk": 103031,
       "first_name": "Robert",
       "last_name": "James",
       "modified_date": "2015-07-27T10:56:18+00:00",
       "email": "rjames@example.com",
       "mobile_phone": "122-890-7890",
       "role": 1,
       "created_date": "2013-07-23T18:46:36.487342+00:00",
       "until_date": "9999-12-31T23:59:59.999999",
       "id": "rjames",
       "last_login_from_catalog": "2015-07-29T01:58:11.377008"
     },
     "touch_id_auth": {
       "authentication_method": null,
       "authentication_url": null,
       "enable_touch_id": false,
       "event_login_button": "touchstart",
       "login_method": null,
       "login_url": null,
       "param_password": null,
       "param_user": null,
       "selector_login_button": "#login-button",
       "selector_password": "#login-password",
       "selector_user": "#login-username"
     }
}
GET /v1/catalog/applications/

Attention

There is a newer version of this resource available: GET /v2/catalog/applications/. This v1 version will be deprecated in Q3 of 2017; please modify your code to use the latest V2 version. If you have any questions, contact support@apperian.com.

List Applications for the Authenticated User’s Device

Requires user and device context. Use session token returned from POST /catalog/authenticate.

Returns a list of applications available to the authenticated user on the user’s specific device. In addition to listing only those applications that a user has permission to see based on organization and group, this resource also filters applications based on the user’s device (form factor, platform, operating system version). It does not return any applications that are disabled in EASE.

The resource response includes an ApplicationModel object for each application. Each ApplicationModel object includes:

  • A VersionModel object that defines the latest version of the application.
  • An InstallFileModel object that defines how to download the latest version.

All model objects are filtered so that the catalog user can see only the appropriate fields.

URLs

Environment URL
North America https://na01ws.apperian.com/v1/catalog/applications/
Europe https://eu01ws.apperian.eu/v1/catalog/applications/

URL Parameters

start
(Optional) Defines starting index of the page. Default: 0 (first element)
count
(Optional) Number of objects to display in a page. Default: 20
sort_field

(Optional) Which application field to use as the sorting key: Default: name

  • name
  • psk (unique ID assigned to the app by EASE)
  • short_description
  • long_description
  • bundle_id
  • platform
  • type
  • display_message
  • operating_system
  • form_factor
  • os_version
  • status
sort_direction

(Optional) Which direction to sort the sort field: Default: asc

  • asc: ascending order
  • desc: descending order

Header Parameter

X-UDID
(Required) Unique identifier assigned by EASE to the device.
X-TOKEN
(Required) Session token returned by POST /catalog/authenticate.

Data Parameters

None

Example Request

curl "https://na01ws.apperian.com/v1/catalog/applications/?start=0&count=5&sort_direction=desc" --header "X-UDID: FFFFFFFFA8DF6FB4697A44C09DDFBB7D87B83269" --header "X-TOKEN: MkeEs5xYRNyRiSIlrGi4QQ"

Example Response

{
  "applications": [
    {
      "has_update": true,
      "url_scheme": "",
      "num_likes": 0,
      "long_description": "asdf",
      "install_uri": "itms-services://?action=download-manifest&url=https?%3A%2F%2Fna01ws.apperian.com%2Fdownloads%2Finstall%2Fapplications%2F77%3Ftoken%3DQRNyq3ctRM-RsGaaUs22aQ%26udid%3DFFFFFFFF3A2569060A104EECA06F66DFBFE20A8D",
      "review_quote": "Be the first to review this app!",
      "tablet_screenshot_path3": null,
      "user_liked": null,
      "version": {
        "psk": 110,
        "release_date": "2016-03-24T13:02:55.921400+00:00",
        "description": "Manage your To Do list",
        "version": "1.0",
        "version_num": "1.0",
        "install_file": {
          "psk": 145
        }
      },
      "reviews_enabled": true,
      "short_description": "asdf",
      "screenshot_path3": null,
      "screenshot_path1": null,
      "type": 0,
      "screenshot_path4": null,
      "screenshot_path5": null,
      "psk": 77,
      "icon_path": "https://na01ws.apperian.com/catalog/assets/org_11/iphone_77/Actions_57.png",
      "custom_metadata": null,
      "add_to_start": false,
      "screenshot_path2": null,
      "num_dislikes": 0,
      "bundle_id": "com.apperian.Actions",
      "banner_image_url": null,
      "last_version_downloaded": {
        "psk": 110,
        "posted_date": "2016-03-24T13:02:55.921400+00:00",
        "description": "asdf",
        "version_num": "2.0",
        "verification_status": 0,
        "latest_install_file": 145,
        "release_date": "2016-03-24T13:02:55.921400+00:00",
        "required": false,
        "required_by": "9999-12-31T23:59:59.999999",
        "app_psk": 77,
        "wrap_status": 0,
        "signstatus": 0,
        "veracode_verification_status": 0,
        "kryptowire_verification_status": 0,
        "notify_users": false,
        "install_file": {
          "file_type_constant": "INSTALLEXE",
          "apperian_wrapper_version": null,
          "veracode_verification_id": null,
          "kryptowire_verification_id": null,
          "hash_type": "none",
          "hash_value": null,
          "description": null,
          "app_psk": 77,
          "size": 293807,
          "until": "2016-08-19T20:48:06+00:00",
          "psk": 145,
          "complete": true,
          "appthority_verification_id": null,
          "deleted": false,
          "expires": "2016-08-19T20:48:06+00:00",
          "mime": "application/itunes+zip",
          "path": "org_11/iphone_77/version_110/Actions.ipa",
          "name": null,
          "created": "2016-03-24T13:02:43.816387+00:00",
          "version_psk": 110,
          "checksum": "56916a0ee47c8bb21f6aeda815101f8a4198209b376a0e10d0c5b87cb4a23597",
          "sign_credentials_psk": null,
          "action": "upload"
        }
      },
      "categories": [
        {
          "psk": 244,
          "org_psk": 11,
          "constant": "COMPANY",
          "name": "Company Wide",
          "icon_path": "/icons/categories/company_wide.png",
          "description": ""
        }
      ],
      "num_downloads": 1,
      "tablet_screenshot_path4": null,
      "tablet_screenshot_path5": null,
      "tablet_screenshot_path2": null,
      "name": "Actions",
      "tablet_screenshot_path1": null,
      "required_by_group": true,
      "mdm_install": false
    }
  ],
  "paging": {
    "total": 1,
    "next": null,
    "previous": null
  }
}
GET /v1/catalog/applications/(app_psk)

Attention

There is a newer version of this resource available: GET /v2/catalog/applications/<app_id>/. This v1 version will be deprecated in Q3 of 2017; please modify your code to use the latest V2 version. If you have any questions, contact support@apperian.com.

List Data for a Specific Application

Requires user and device context. Use session token returned from POST /catalog/authenticate.

Returns details for the latest version of the specified application available to the authenticated user.

URLs

Environment URL
North America https://na01ws.apperian.com/v1/catalog/applications/<app_psk>
Europe https://eu01ws.apperian.eu/v1/catalog/applications/<app_psk>

URL Parameters

app_psk
(Required) Unique ID for the app. DATA TYPE: integer

Header Parameter

X-UDID
(Required) Unique identifier assigned by EASE to the device.
X-TOKEN
(Required) Session token returned by POST /catalog/authenticate.
Data Parameters
None

Example Request

curl -X GET https://na01ws.apperian.com/v1/catalog/applications/4333 --header "X-UDID: 90b0e24db7f650bbec684b60c6da855e4c98b28b" --header "X-TOKEN: eTg8ktZXRqKIBJTHunwP6A"

Example Response

Note that in this example, the application has custom metadata associated with it. Custom metadata can be specified for an app using PUT /applications/<app_psk>.

{
  "application": {
    "has_update": true,
    "url_scheme": "",
    "num_likes": 0,
    "long_description": "Manage your To Do list",
    "install_uri": "itms-services://?action=download-manifest&url=https?%3A%2F%2Fna01ws.apperian.com%2F
            downloads%2Finstall%2Fapplications%2F77%3Ftoken%3DQRNyq3ctRM-RsGaaUs22aQ%26udid%3
            DFFFFFFFF3A2569060A104EECA06F66DFBFE20A8D",
    "review_quote": "Be the first to review this app!",
    "tablet_screenshot_path3": null,
    "user_liked": null,
    "version": {
      "psk": 110,
      "release_date": "2016-03-24T13:02:55.921400+00:00",
      "description": "asdf",
      "version_num": "2.0",
      "install_file": {
        "psk": 145
      }
    },
    "reviews_enabled": true,
    "short_description": "Actions app",
    "screenshot_path3": null,
    "screenshot_path1": null,
    "type": 0,
    "screenshot_path4": null,
    "screenshot_path5": null,
    "psk": 77,
    "icon_path": "https://na01ws.apperian.com/catalog/assets/org_11/iphone_77/Actions_57.png",
    "custom_metadata": {
      "city": "Boston",
      "lastname": "Harrelson",
      "firstname": "Diane",
      "restaurants": "Cheers,Vips"
    },
    "add_to_start": false,
    "screenshot_path2": null,
    "num_dislikes": 0,
    "bundle_id": "com.apperian.Actions",
    "banner_image_url": null,
    "last_version_downloaded": {
      "psk": 110,
      "posted_date": "2016-03-24T13:02:55.921400+00:00",
      "description": "asdf",
      "version_num": "2.0",
      "verification_status": 0,
      "latest_install_file": 145,
      "release_date": "2016-03-24T13:02:55.921400+00:00",
      "required": false,
      "required_by": "9999-12-31T23:59:59.999999",
      "app_psk": 77,
      "wrap_status": 0,
      "signstatus": 0,
      "veracode_verification_status": 0,
      "kryptowire_verification_status": 0,
      "notify_users": false,
      "install_file": {
        "file_type_constant": "INSTALLEXE",
        "apperian_wrapper_version": null,
        "veracode_verification_id": null,
        "kryptowire_verification_id": null,
        "hash_type": "none",
        "hash_value": null,
        "description": null,
        "app_psk": 77,
        "size": 293807,
        "until": "2016-08-19T20:48:06+00:00",
        "psk": 145,
        "complete": true,
        "appthority_verification_id": null,
        "deleted": false,
        "expires": "2016-08-19T20:48:06+00:00",
        "mime": "application/itunes+zip",
        "path": "org_11/iphone_77/version_110/Actions.ipa",
        "name": null,
        "created": "2016-03-24T13:02:43.816387+00:00",
        "version_psk": 110,
        "checksum": "56916a0ee47c8bb21f6aeda815101f8a4198209b376a0e10d0c5b87cb4a23597",
        "sign_credentials_psk": null,
        "action": "upload"
      }
    },
    "categories": [
      {
        "psk": 244,
        "org_psk": 11,
        "constant": "COMPANY",
        "name": "Company Wide",
        "icon_path": "/icons/categories/company_wide.png",
        "description": ""
      }
    ],
    "num_downloads": 1,
    "tablet_screenshot_path4": null,
    "tablet_screenshot_path5": null,
    "tablet_screenshot_path2": null,
    "name": "Actions",
    "tablet_screenshot_path1": null,
    "required_by_group": true,
    "mdm_install": false
  }
}

Attention

There is a newer version of this resource available: GET /v2/catalog/applications/popular/. This v1 version will be deprecated in Q3 of 2017; please modify your code to use the latest V2 version. If you have any questions, contact support@apperian.com.

List Apps in Order of Popularity (# of Downloads)

Requires user and device context. Use session token returned from POST /catalog/authenticate.

Returns a list of downloaded native apps in descending order by number of downloads.

Download Count includes App Catalog downloads, but the initial download of an App Catalog is not counted until a user has logged in to the App Catalog on the device; subsequent downloads of App Catalog updates are counted without requiring the user to log in.

URLs

Environment URL
North America https://na01ws.apperian.com/v1/catalog/applications/popular/
Europe https://eu01ws.apperian.eu/v1/catalog/applications/popular/

URL Parameters

start
(Optional) Defines starting index of the page. If not set, it starts from the first element by default.
count
(Optional) Number of objects to display in a page.

Header Parameter

X-UDID
(Required) Unique identifier assigned by EASE to the device.
X-TOKEN
(Required) Session token returned by POST /catalog/authenticate.

Data Parameters

None

Example Request

curl https://na01ws.apperian.com/v1/catalog/applications/popular/?start=0&count=5"
     --header "X-UDID: 90b0e24db7f650bbec684b60c6da855e4c98b28b" --header "X-TOKEN: eTg8ktZXRqKIBJTHunwP6A"

Example Response

{
  "applications": [
    {
      "has_update": true,
      "url_scheme": "",
      "num_likes": 0,
      "long_description": "Manage your To Do list",
      "install_uri": "itms-services://?action=download-manifest&url=https?%3A%2F%2Fna01ws.apperian.com%2Fdownloads%2Finstall%2Fapplications%2F77%3Ftoken%3DQRNyq3ctRM-RsGaaUs22aQ%26udid%3DFFFFFFFF3A2569060A104EECA06F66DFBFE20A8D",
      "review_quote": "Be the first to review this app!",
      "tablet_screenshot_path3": null,
      "user_liked": null,
      "version": {
        "psk": 110,
        "release_date": "2016-03-24T13:02:55.921400+00:00",
        "description": "asdf",
        "version_num": "1.0",
        "install_file": {
          "psk": 145
        }
      },
      "reviews_enabled": true,
      "short_description": "Actions app",
      "screenshot_path3": null,
      "screenshot_path1": null,
      "type": 0,
      "screenshot_path4": null,
      "screenshot_path5": null,
      "psk": 77,
      "icon_path": "https://na01ws.apperian.com/catalog/assets/org_11/iphone_77/Actions_57.png",
      "custom_metadata": null,
      "add_to_start": false,
      "screenshot_path2": null,
      "num_dislikes": 0,
      "bundle_id": "com.apperian.Actions",
      "banner_image_url": null,
      "last_version_downloaded": {
        "psk": 110,
        "posted_date": "2016-03-24T13:02:55.921400+00:00",
        "description": "asdf",
        "version_num": "2.0",
        "verification_status": 0,
        "latest_install_file": 145,
        "release_date": "2016-03-24T13:02:55.921400+00:00",
        "required": false,
        "required_by": "9999-12-31T23:59:59.999999",
        "app_psk": 77,
        "wrap_status": 0,
        "signstatus": 0,
        "veracode_verification_status": 0,
        "kryptowire_verification_status": 0,
        "notify_users": false,
        "install_file": {
          "file_type_constant": "INSTALLEXE",
          "apperian_wrapper_version": null,
          "veracode_verification_id": null,
          "kryptowire_verification_id": null,
          "hash_type": "none",
          "hash_value": null,
          "description": null,
          "app_psk": 77,
          "size": 293807,
          "until": "2016-08-19T20:48:06+00:00",
          "psk": 145,
          "complete": true,
          "appthority_verification_id": null,
          "deleted": false,
          "expires": "2016-08-19T20:48:06+00:00",
          "mime": "application/itunes+zip",
          "path": "org_11/iphone_77/version_110/Actions.ipa",
          "name": null,
          "created": "2016-03-24T13:02:43.816387+00:00",
          "version_psk": 110,
          "checksum": "56916a0ee47c8bb21f6aeda815101f8a4198209b376a0e10d0c5b87cb4a23597",
          "sign_credentials_psk": null,
          "action": "upload"
        }
      },
      "categories": [
        {
          "psk": 244,
          "org_psk": 11,
          "constant": "COMPANY",
          "name": "Company Wide",
          "icon_path": "/icons/categories/company_wide.png",
          "description": ""
        }
      ],
      "num_downloads": 1,
      "tablet_screenshot_path4": null,
      "tablet_screenshot_path5": null,
      "tablet_screenshot_path2": null,
      "name": "Actions",
      "tablet_screenshot_path1": null,
      "required_by_group": true,
      "mdm_install": false
    }
  ],
  "paging": {
    "total": 1,
    "next": null,
    "previous": null
  }
}

Attention

There is a newer version of this resource available: GET /v2/catalog/applications/featured/. This v1 version will be deprecated in Q3 of 2017; please modify your code to use the latest V2 version. If you have any questions, contact support@apperian.com.

List Featured Apps

Requires user and device context. Use session token returned from POST /catalog/authenticate.

Returns a list of featured applications that are available to the authenticated user and applicable for the user’s device. An EASE administrator can select featured apps in the EASE Portal as a way to encourage App Catalog users to install them. In the Apperian App Catalog, featured apps display in the cover flow area at the top of the Popular page in the App Catalog. For more information on featured apps, see Select Featured Apps for the App Catalog.

This resource filters on the authenticated device rather than requiring the catalog app PSK to detect the platform. Rather than returning all the ApplicationFeaturedModel objects, it returns just the ApplicationModel objects inside the ApplicationFeaturedModel objects; the ApplicationFeaturedModel objects have information that the catalog does not need, but the EASE Administrator does.

URLs

Environment URL
North America https://na01ws.apperian.com/v1/catalog/applications/featured/
Europe https://eu01ws.apperian.eu/v1/catalog/applications/featured/

URL Parameters

None

Header Parameter

X-UDID
(Required) Unique identifier assigned by EASE to the device.
X-TOKEN
(Required) Session token returned by POST /catalog/authenticate.

Data Parameters

None

Example Request

curl -X GET https://na01ws.apperian.com/v1/catalog/applications/featured/
     --header "X-UDID: 90b0e24db7f650bbec684b60c6da855e4c98b28b" --header "X-TOKEN: eTg8ktZXRqKIBJTHunwP6A"

Example Response

{
  "applications": [
    {
      "display_message": "",
      "operating_system": 1,
      "update_compliance_period_in_days": null,
      "url_scheme": "",
      "num_likes": 0,
      "form_factor": 3,
      "tablet_screenshot_path3": null,
      "long_description": "Manage your To Do list",
      "review_quote": "Be the first to review this app!",
      "is_adhoc": false,
      "platform": null,
      "is_hybrid": false,
      "featured_quote": "This app will change your life!",
      "required_by": "3099-12-31T00:00:00+00:00",
      "os_version": null,
      "is_app_catalog": false,
      "version": {
        "psk": 110,
        "posted_date": "2016-03-24T13:02:55.921400+00:00",
        "description": "asdf",
        "version_num": "2.0",
        "verification_status": 0,
        "latest_install_file": 145,
        "release_date": "2016-03-24T13:02:55.921400+00:00",
        "required": false,
        "required_by": "9999-12-31T23:59:59.999999",
        "app_psk": 77,
        "wrap_status": 0,
        "signstatus": 0,
        "veracode_verification_status": 0,
        "kryptowire_verification_status": 0,
        "notify_users": false,
        "install_file": {
          "file_type_constant": "INSTALLEXE",
          "apperian_wrapper_version": null,
          "veracode_verification_id": null,
          "kryptowire_verification_id": null,
          "hash_type": "none",
          "hash_value": null,
          "description": null,
          "app_psk": 77,
          "size": 293807,
          "until": "2016-08-19T20:48:06+00:00",
          "psk": 145,
          "complete": true,
          "appthority_verification_id": null,
          "deleted": false,
          "expires": "2016-08-19T20:48:06+00:00",
          "mime": "application/itunes+zip",
          "path": "org_11/iphone_77/version_110/Actions.ipa",
          "name": null,
          "created": "2016-03-24T13:02:43.816387+00:00",
          "version_psk": 110,
          "checksum": "56916a0ee47c8bb21f6aeda815101f8a4198209b376a0e10d0c5b87cb4a23597",
          "sign_credentials_psk": null,
          "action": "upload"
        }
      },
      "reviews_enabled": true,
      "short_description": "Actions app",
      "screenshot_path3": null,
      "screenshot_path1": null,
      "type": 0,
      "screenshot_path4": null,
      "screenshot_path5": null,
      "status": 1,
      "psk": 77,
      "sort_weight": 1000,
      "no_auth_delivery_enabled": true,
      "deleted": null,
      "icon_path": "https://na01ws.apperian.com/catalog/assets/org_11/iphone_77/Actions_57.png",
      "is_email_config_profile": false,
      "custom_metadata": null,
      "add_to_start": false,
      "screenshot_path2": null,
      "tablet_screenshot_path5": null,
      "min_os_version": "7.1",
      "bundle_id": "com.apperian.Actions",
      "banner_image_url": null,
      "last_version_downloaded": {
        "psk": 110,
        "posted_date": "2016-03-24T13:02:55.921400+00:00",
        "description": "asdf",
        "version_num": "2.0",
        "verification_status": 0,
        "latest_install_file": 145,
        "release_date": "2016-03-24T13:02:55.921400+00:00",
        "required": false,
        "required_by": "9999-12-31T23:59:59.999999",
        "app_psk": 77,
        "wrap_status": 0,
        "signstatus": 0,
        "veracode_verification_status": 0,
        "kryptowire_verification_status": 0,
        "notify_users": false,
        "install_file": {
          "file_type_constant": "INSTALLEXE",
          "apperian_wrapper_version": null,
          "veracode_verification_id": null,
          "kryptowire_verification_id": null,
          "hash_type": "none",
          "hash_value": null,
          "description": null,
          "app_psk": 77,
          "size": 293807,
          "until": "2016-08-19T20:48:06+00:00",
          "psk": 145,
          "complete": true,
          "appthority_verification_id": null,
          "deleted": false,
          "expires": "2016-08-19T20:48:06+00:00",
          "mime": "application/itunes+zip",
          "path": "org_11/iphone_77/version_110/Actions.ipa",
          "name": null,
          "created": "2016-03-24T13:02:43.816387+00:00",
          "version_psk": 110,
          "checksum": "56916a0ee47c8bb21f6aeda815101f8a4198209b376a0e10d0c5b87cb4a23597",
          "sign_credentials_psk": null,
          "action": "upload"
        }
      },
      "install_uri": "itms-services://?action=download-manifest&url=https?%3A%2F%2Fna01ws.apperian.com%2Fdownloads%2Finstall%2Fapplications%2F77%3Ftoken%3DQRNyq3ctRM-RsGaaUs22aQ%26udid%3DFFFFFFFF3A2569060A104EECA06F66DFBFE20A8D",
      "categories": [
        {
          "psk": 244,
          "org_psk": 11,
          "constant": "COMPANY",
          "name": "Company Wide",
          "icon_path": "/icons/categories/company_wide.png",
          "description": ""
        }
      ],
      "num_downloads": 1,
      "tablet_screenshot_path4": null,
      "tablet_screenshot_path2": null,
      "name": "Actions",
      "tablet_screenshot_path1": null,
      "required": false,
      "push_enabled": false,
      "user_liked": null,
      "num_dislikes": 0,
      "mdm_install": false
    }
  ]
}
GET /v1/catalog/categories/

List Apps in Each Category

Requires user and device context. Use session token returned from POST /catalog/authenticate.

Returns a list of application categories that includes the number of applications, in each category, that can be viewed by the authenticated user on the specified device. Apps can be viewed by a user if they are enabled, of the correct form factor and app type for the device, and in the user’s assigned groups.

URLs

Environment URL
North America https://na01ws.apperian.com/v1/catalog/categories/
Europe https://eu01ws.apperian.eu/v1/catalog/categories/

URL Parameters

None

Header Parameter

X-UDID
(Required) Unique identifier assigned by EASE to the device.
X-TOKEN
(Required) Session token returned by POST /catalog/authenticate.

Data Parameters

None

Example Request

curl -X GET https://na01ws.apperian.com/v1/catalog/categories/ --header "X-UDID: 90b0e24db7f650bbec684b60c6da855e4c98b28b" --header "X-TOKEN: eTg8ktZXRqKIBJTHunwP6A"

Example Response

::for app in mandatory_apps:

{
“categories”: [
{
“psk”: 24166, “org_psk”: 1062, “constant”: “BOOKS”, “name”: “Books”, “icon_path”: “https://ws-ease.apperian.com/catalog/assets//icons/categories/books.png”, “num_applications”: 0, “description”: “”

}, {

“psk”: 24167, “org_psk”: 1062, “constant”: “BUSINESS”, “name”: “Business”, “icon_path”: “https://ws-ease.apperian.com/catalog/assets//icons/categories/business.png”, “num_applications”: 2, “description”: “”

}, {

“psk”: 24168, “org_psk”: 1062, “constant”: “COMPANY”, “name”: “Company Wide”, “icon_path”: “https://ws-ease.apperian.com/catalog/assets//icons/categories/company_wide.png”, “num_applications”: 9, “description”: “”

}, {

“psk”: 24189, “org_psk”: 1062, “constant”: “CONFIGPROF”, “name”: “Configuration Profile”, “icon_path”: “https://ws-ease.apperian.com/catalog/assets//icons/categories/configuration_profile.png”, “num_applications”: 0, “description”: “”

}, {

“psk”: 24169, “org_psk”: 1062, “constant”: “EDUCATION”, “name”: “Education”, “icon_path”: “https://ws-ease.apperian.com/catalog/assets//icons/categories/education.png”, “num_applications”: 0, “description”: “”

}, {

“psk”: 24171, “org_psk”: 1062, “constant”: “EXECUTIVE”, “name”: “Executive”, “icon_path”: “https://ws-ease.apperian.com/catalog/assets//icons/categories/executive.png”, “num_applications”: 1, “description”: “”

}, {

“psk”: 24172, “org_psk”: 1062, “constant”: “FINANCE”, “name”: “Finance”, “icon_path”: “https://ws-ease.apperian.com/catalog/assets//icons/categories/finance.png”, “num_applications”: 1, “description”: “”

}, {

“psk”: 37022, “org_psk”: 1062, “constant”: null, “name”: “Government”, “icon_path”: “https://ws-ease.apperian.com/catalog/assets/org_1062/category_icons/

category_37022_136663549909.png”,

“num_applications”: 0, “description”: “Apps related to government regulations, policies, and RFPs.”

}, {

“psk”: 24173, “org_psk”: 1062, “constant”: “HEALTHCARE”, “name”: “Healthcare”, “icon_path”: “https://ws-ease.apperian.com/catalog/assets//icons/categories/healthcare.png”, “num_applications”: 0, “description”: “”

}, {

“psk”: 24174, “org_psk”: 1062, “constant”: “HR”, “name”: “Human Resources”, “icon_path”: “https://ws-ease.apperian.com/catalog/assets//icons/categories/human_Resources.png”, “num_applications”: 0, “description”: “”

}, {

“psk”: 24176, “org_psk”: 1062, “constant”: “NAVIGATION”, “name”: “Navigation”, “icon_path”: “https://ws-ease.apperian.com/catalog/assets//icons/categories/navigation.png”, “num_applications”: 0, “description”: “”

}, {

“psk”: 24177, “org_psk”: 1062, “constant”: “NEWS”, “name”: “News”, “icon_path”: “https://ws-ease.apperian.com/catalog/assets//icons/categories/news.png”, “num_applications”: 0, “description”: “”

}, {

“psk”: 24178, “org_psk”: 1062, “constant”: “OPERATIONS”, “name”: “Operations”, “icon_path”: “https://ws-ease.apperian.com/catalog/assets//icons/categories/operations.png”, “num_applications”: 1, “description”: “”

}, {

“psk”: 24179, “org_psk”: 1062, “constant”: “PRODUCTIVITY”, “name”: “Productivity”, “icon_path”: “https://ws-ease.apperian.com/catalog/assets//icons/categories/productivity.png”, “num_applications”: 1, “description”: “”

}, {

“psk”: 24188, “org_psk”: 1062, “constant”: “REC3RDAPPS”, “name”: “Recommended 3rd Party Apps”, “icon_path”: “https://ws-ease.apperian.com/catalog/assets//icons/categories/3rd_party_apps.png”, “num_applications”: 0, “description”: “”

}, {

“psk”: 24180, “org_psk”: 1062, “constant”: “REFERENCE”, “name”: “Reference”, “icon_path”: “https://ws-ease.apperian.com/catalog/assets//icons/categories/reference.png”, “num_applications”: 0, “description”: “”

}, {

“psk”: 24186, “org_psk”: 1062, “constant”: “REQUIREDAPPS”, “name”: “Required Apps”, “icon_path”: “https://ws-ease.apperian.com/catalog/assets//icons/categories/required_Apps.png”, “num_applications”: 0, “description”: “”

}, {

“psk”: 24181, “org_psk”: 1062, “constant”: “SALESMKT”, “name”: “Sales & Marketing”, “icon_path”: “https://ws-ease.apperian.com/catalog/assets//icons/categories/s_m.png”, “num_applications”: 0, “description”: “”

}, {

“psk”: 24182, “org_psk”: 1062, “constant”: “SOCIAL”, “name”: “Social Networking”, “icon_path”: “https://ws-ease.apperian.com/catalog/assets//icons/categories/social_networking.png”, “num_applications”: 0, “description”: “”

}, {

“psk”: 24183, “org_psk”: 1062, “constant”: “TRAVEL”, “name”: “Travel”, “icon_path”: “https://ws-ease.apperian.com/catalog/assets//icons/categories/travel.png”, “num_applications”: 0, “description”: “”

}, {

“psk”: “uncategorized”, “org_psk”: 1062, “constant”: null, “name”: “Uncategorized”, “icon_path”: “https://ws-ease.apperian.com/catalog/assets//icons/categories/unassigned.png”, “num_applications”: 0, “description”: “”

}, {

“psk”: 24184, “org_psk”: 1062, “constant”: “UTILITIES”, “name”: “Utilities”, “icon_path”: “https://ws-ease.apperian.com/catalog/assets//icons/categories/utilities.png”, “num_applications”: 0, “description”: “”

}

]

}

GET /v1/catalog/categories/(string: category_psk)/applications/

Attention

There is a newer version of this resource available: GET /v2/catalog/<string:category_psk>/applications/. This v1 version will be deprecated in Q3 of 2017. If you currently interface with this v1 resource, please modify your code to point to the latest V2 version. If you have any questions, contact support@apperian.com.

List Apps in a Specific Category

Requires user and device context. Use session token returned from POST /catalog/authenticate.

Returns a list of all the applications in a particular category that can be viewed by the authenticated user on the specified device (correct form factor and in the user’s assigned groups).

URLs

Environment URL
North America https://na01ws.apperian.com/v1/catalog/categories/<category_psk>applications/
Europe https://eu01ws.apperian.eu/v1/catalog/categories/<category_psk>applications/

URL Parameters

category_psk
(Required) Unique ID for the category. DATA TYPE: integer
start
(Required) Defines starting index of the page. If not set, it starts from the first element by default. DATA TYPE: integer
count
(Required) Number of objects to display in a page. DATA TYPE: integer

Header Parameter

X-UDID
(Required) Unique identifier assigned by EASE to the device.
X-TOKEN
(Required) Session token returned by POST /catalog/authenticate.

Data Parameters

None

Example Request

curl -X GET "https://na01ws.apperian.com/v1/catalog/categories/123/applications/?start=0&count=5"
     --header "X-UDID: 90b0e24db7f650bbec684b60c6da855e4c98b28b" --header "X-TOKEN: eTg8ktZXRqKIBJTHunwP6A"

Example Response

{
  "paging": {
    "total": 1,
    "next": null,
    "previous": null
  },
  "category_applications": [
    {
      "has_update": true,
      "display_message": "",
      "operating_system": 1,
      "update_compliance_period_in_days": null,
      "url_scheme": "",
      "num_likes": 0,
      "form_factor": 3,
      "tablet_screenshot_path3": null,
      "long_description": "asdf",
      "review_quote": "Be the first to review this app!",
      "is_adhoc": false,
      "platform": null,
      "is_hybrid": false,
      "user_liked": null,
      "required_by": "3099-12-31T00:00:00+00:00",
      "os_version": null,
      "is_app_catalog": false,
      "version": {
        "psk": 110,
        "posted_date": "2016-03-24T13:02:55.921400+00:00",
        "description": "asdf",
        "version_num": "2.0",
        "verification_status": 0,
        "latest_install_file": 145,
        "release_date": "2016-03-24T13:02:55.921400+00:00",
        "required": false,
        "required_by": "9999-12-31T23:59:59.999999",
        "app_psk": 77,
        "wrap_status": 0,
        "signstatus": 0,
        "veracode_verification_status": 0,
        "kryptowire_verification_status": 0,
        "notify_users": false,
        "install_file": {
          "file_type_constant": "INSTALLEXE",
          "apperian_wrapper_version": null,
          "veracode_verification_id": null,
          "kryptowire_verification_id": null,
          "hash_type": "none",
          "hash_value": null,
          "description": null,
          "app_psk": 77,
          "size": 293807,
          "until": "2016-08-19T20:48:06+00:00",
          "psk": 145,
          "complete": true,
          "appthority_verification_id": null,
          "deleted": false,
          "expires": "2016-08-19T20:48:06+00:00",
          "mime": "application/itunes+zip",
          "path": "org_11/iphone_77/version_110/Actions.ipa",
          "name": null,
          "created": "2016-03-24T13:02:43.816387+00:00",
          "version_psk": 110,
          "checksum": "56916a0ee47c8bb21f6aeda815101f8a4198209b376a0e10d0c5b87cb4a23597",
          "sign_credentials_psk": null,
          "action": "upload"
        }
      },
      "reviews_enabled": true,
      "short_description": "asdf",
      "screenshot_path3": null,
      "screenshot_path1": null,
      "type": 0,
      "screenshot_path4": null,
      "screenshot_path5": null,
      "status": 1,
      "psk": 77,
      "sort_weight": 1000,
      "no_auth_delivery_enabled": true,
      "deleted": null,
      "icon_path": "https://na01ws.apperian.com/catalog/assets/org_11/iphone_77/Actions_57.png",
      "is_email_config_profile": false,
      "custom_metadata": null,
      "add_to_start": false,
      "screenshot_path2": null,
      "tablet_screenshot_path5": null,
      "min_os_version": "7.1",
      "bundle_id": "com.apperian.Actions",
      "banner_image_url": null,
      "last_version_downloaded": {
        "psk": 110,
        "posted_date": "2016-03-24T13:02:55.921400+00:00",
        "description": "asdf",
        "version_num": "2.0",
        "verification_status": 0,
        "latest_install_file": 145,
        "release_date": "2016-03-24T13:02:55.921400+00:00",
        "required": false,
        "required_by": "9999-12-31T23:59:59.999999",
        "app_psk": 77,
        "wrap_status": 0,
        "signstatus": 0,
        "veracode_verification_status": 0,
        "kryptowire_verification_status": 0,
        "notify_users": false,
        "install_file": {
          "file_type_constant": "INSTALLEXE",
          "apperian_wrapper_version": null,
          "veracode_verification_id": null,
          "kryptowire_verification_id": null,
          "hash_type": "none",
          "hash_value": null,
          "description": null,
          "app_psk": 77,
          "size": 293807,
          "until": "2016-08-19T20:48:06+00:00",
          "psk": 145,
          "complete": true,
          "appthority_verification_id": null,
          "deleted": false,
          "expires": "2016-08-19T20:48:06+00:00",
          "mime": "application/itunes+zip",
          "path": "org_11/iphone_77/version_110/Actions.ipa",
          "name": null,
          "created": "2016-03-24T13:02:43.816387+00:00",
          "version_psk": 110,
          "checksum": "56916a0ee47c8bb21f6aeda815101f8a4198209b376a0e10d0c5b87cb4a23597",
          "sign_credentials_psk": null,
          "action": "upload"
        }
      },
      "install_uri": "itms-services://?action=download-manifest&url=https%3A%2F%2Fna01ws.apperian.com%2
                      Fdownloads%2Finstall%2Fapplications%2F77%3Ftoken%3DQRNyq3ctRM-RsGaaUs22aQ%26udid%3
                      DFFFFFFFF3A2569060A104EECA06F66DFBFE20A8D",
      "categories": [
        {
          "psk": 244,
          "org_psk": 11,
          "constant": "COMPANY",
          "name": "Company Wide",
          "icon_path": "/icons/categories/company_wide.png",
          "description": ""
        }
      ],
      "num_downloads": 1,
      "tablet_screenshot_path4": null,
      "tablet_screenshot_path2": null,
      "name": "Actions",
      "tablet_screenshot_path1": null,
      "required": false,
      "push_enabled": false,
      "num_dislikes": 0,
      "mdm_install": false
    }
  ]
}
GET /v1/catalog/search/

Attention

There is a newer version of this resource available: GET /v2/catalog/search/. This v1 version will be deprecated in Q3 of 2017. If you currently interface with this v1 resource, please modify your code to point to the latest V2 version. If you have any questions, contact support@apperian.com.

Search Application Data

Requires user and device context. Use session token returned from POST /catalog/authenticate.

Searches for the specified query string in the list of applications available to the authenticated user. The query searches the Name, Version, Short Description, and Long Description fields for a text match.

URLs

Environment URL
North America https://na01ws.apperian.com/v1/catalog/search/
Europe https://eu01ws.apperian.eu/v1/catalog/search/

URL Parameters

query
(Required) Text string that will be used for the query. DATA TYPE: string

Header Parameter

X-UDID
(Required) Unique identifier assigned by EASE to the device.
X-TOKEN
(Required) Session token returned by POST /catalog/authenticate.

Data Parameters

None

Example Request

curl -X GET "https://na01ws.apperian.com/v1/catalog/search/?query=training"
     --header "X-UDID: FFFFFFFFA8DF6FB4697A44C09DDFBB7D87B83269" --header "X-TOKEN: yuMYpRFxR--hBA5v3qP2Dw"

Example Response

The request above queries for the string “training” and returns data about one application.

{
  "applications": [
    {
      "display_message": "",
      "operating_system": 1,
      "update_compliance_period_in_days": null,
      "url_scheme": "",
      "num_likes": 0,
      "form_factor": 3,
      "tablet_screenshot_path3": null,
      "long_description": "asdf",
      "review_quote": "Be the first to review this app!",
      "is_adhoc": false,
      "platform": null,
      "is_hybrid": false,
      "has_update": true,
      "user_liked": null,
      "required_by": "3099-12-31T00:00:00+00:00",
      "os_version": null,
      "is_app_catalog": false,
      "version": {
        "psk": 110,
        "posted_date": "2016-03-24T13:02:55.921400+00:00",
        "description": "asdf",
        "version_num": "2.0",
        "verification_status": 0,
        "latest_install_file": 145,
        "release_date": "2016-03-24T13:02:55.921400+00:00",
        "required": false,
        "required_by": "9999-12-31T23:59:59.999999",
        "app_psk": 77,
        "wrap_status": 0,
        "signstatus": 0,
        "veracode_verification_status": 0,
        "kryptowire_verification_status": 0,
        "notify_users": false,
        "install_file": {
          "file_type_constant": "INSTALLEXE",
          "apperian_wrapper_version": null,
          "veracode_verification_id": null,
          "kryptowire_verification_id": null,
          "hash_type": "none",
          "hash_value": null,
          "description": null,
          "app_psk": 77,
          "size": 293807,
          "until": "2016-08-19T20:48:06+00:00",
          "psk": 145,
          "complete": true,
          "appthority_verification_id": null,
          "deleted": false,
          "expires": "2016-08-19T20:48:06+00:00",
          "mime": "application/itunes+zip",
          "path": "org_11/iphone_77/version_110/Actions.ipa",
          "name": null,
          "created": "2016-03-24T13:02:43.816387+00:00",
          "version_psk": 110,
          "checksum": "56916a0ee47c8bb21f6aeda815101f8a4198209b376a0e10d0c5b87cb4a23597",
          "sign_credentials_psk": null,
          "action": "upload"
        }
      },
      "reviews_enabled": true,
      "short_description": "asdf",
      "screenshot_path3": null,
      "screenshot_path1": null,
      "type": 0,
      "screenshot_path4": null,
      "screenshot_path5": null,
      "status": 1,
      "psk": 77,
      "sort_weight": 1000,
      "no_auth_delivery_enabled": true,
      "deleted": null,
      "icon_path": "https://na01ws.apperian.com/catalog/assets/org_11/iphone_77/Actions_57.png",
      "is_email_config_profile": false,
      "custom_metadata": null,
      "add_to_start": false,
      "screenshot_path2": null,
      "tablet_screenshot_path5": null,
      "min_os_version": "7.1",
      "bundle_id": "com.apperian.Actions",
      "banner_image_url": null,
      "last_version_downloaded": {
        "psk": 110,
        "posted_date": "2016-03-24T13:02:55.921400+00:00",
        "description": "asdf",
        "version_num": "2.0",
        "verification_status": 0,
        "latest_install_file": 145,
        "release_date": "2016-03-24T13:02:55.921400+00:00",
        "required": false,
        "required_by": "9999-12-31T23:59:59.999999",
        "app_psk": 77,
        "wrap_status": 0,
        "signstatus": 0,
        "veracode_verification_status": 0,
        "kryptowire_verification_status": 0,
        "notify_users": false,
        "install_file": {
          "file_type_constant": "INSTALLEXE",
          "apperian_wrapper_version": null,
          "veracode_verification_id": null,
          "kryptowire_verification_id": null,
          "hash_type": "none",
          "hash_value": null,
          "description": null,
          "app_psk": 77,
          "size": 293807,
          "until": "2016-08-19T20:48:06+00:00",
          "psk": 145,
          "complete": true,
          "appthority_verification_id": null,
          "deleted": false,
          "expires": "2016-08-19T20:48:06+00:00",
          "mime": "application/itunes+zip",
          "path": "org_11/iphone_77/version_110/Actions.ipa",
          "name": null,
          "created": "2016-03-24T13:02:43.816387+00:00",
          "version_psk": 110,
          "checksum": "56916a0ee47c8bb21f6aeda815101f8a4198209b376a0e10d0c5b87cb4a23597",
          "sign_credentials_psk": null,
          "action": "upload"
        }
      },
      "install_uri": "itms-services://?action=download-manifest&url=https?%3A%2F%2Fna01ws.apperian.com%2Fdownloads%2Finstall%2Fapplications%2F77%3Ftoken%3DQRNyq3ctRM-RsGaaUs22aQ%26udid%3DFFFFFFFF3A2569060A104EECA06F66DFBFE20A8D",
      "categories": [
        {
          "psk": 244,
          "org_psk": 11,
          "constant": "COMPANY",
          "name": "Company Wide",
          "icon_path": "/icons/categories/company_wide.png",
          "description": ""
        }
      ],
      "num_downloads": 1,
      "tablet_screenshot_path4": null,
      "tablet_screenshot_path2": null,
      "name": "Actions",
      "tablet_screenshot_path1": null,
      "required": false,
      "push_enabled": false,
      "num_dislikes": 0,
      "mdm_install": false
    }
  ]
}
GET /v1/catalog/applications/downloaded/

Attention

There is a newer version of this resource available: GET /v2/catalog/applications/downloaded/. This v1 version will be deprecated in Q3 of 2017. If you currently interface with this v1 resource, please modify your code to point to the latest V2 version. If you have any questions, contact support@apperian.com.

List Downloaded Applications

Requires user and device context. Use session token returned from POST /catalog/authenticate.

Returns a list of applications that the authenticated user has downloaded onto the specified device.

URLs

Environment URL
North America https://na01ws.apperian.com/v1/catalog/applications/downloaded/
Europe https://eu01ws.apperian.eu/v1/catalog/applications/downloaded/

URL Parameters

None

Header Parameter

X-UDID
(Required) Unique identifier assigned by EASE to the device.
X-TOKEN
(Required) Session token returned by POST /catalog/authenticate.

Data Parameters

None

Example Request

curl -X GET https://na01ws.apperian.com/v1/catalog/applications/downloaded/
     --header "X-TOKEN: eTg8ktZXRqKIBJTHunwP6A" --header "X-UDID: 90b0e24db7f650bbec684b60c6da855e4c98b28b"

Example Response

{
  "applications": [
    {
      "display_message": "",
      "operating_system": 1,
      "update_compliance_period_in_days": null,
      "url_scheme": "",
      "form_factor": 3,
      "long_description": "asdf",
      "is_adhoc": false,
      "platform": null,
      "is_hybrid": false,
      "required_by": "3099-12-31T00:00:00+00:00",
      "os_version": null,
      "is_app_catalog": false,
      "version": {
        "psk": 110,
        "posted_date": "2016-03-24T13:02:55.921400+00:00",
        "description": "Manage your To Do list",
        "version_num": "2.0",
        "verification_status": 0,
        "latest_install_file": 145,
        "release_date": "2016-03-24T13:02:55.921400+00:00",
        "required": false,
        "required_by": "9999-12-31T23:59:59.999999",
        "app_psk": 77,
        "wrap_status": 0,
        "signstatus": 0,
        "veracode_verification_status": 0,
        "kryptowire_verification_status": 0,
        "notify_users": false,
        "install_file": {
          "file_type_constant": "INSTALLEXE",
          "apperian_wrapper_version": null,
          "veracode_verification_id": null,
          "kryptowire_verification_id": null,
          "hash_type": "none",
          "hash_value": null,
          "description": null,
          "app_psk": 77,
          "size": 293807,
          "until": "2016-08-19T20:48:06+00:00",
          "psk": 145,
          "complete": true,
          "appthority_verification_id": null,
          "deleted": false,
          "expires": "2016-08-19T20:48:06+00:00",
          "mime": "application/itunes+zip",
          "path": "org_11/iphone_77/version_110/Actions.ipa",
          "name": null,
          "created": "2016-03-24T13:02:43.816387+00:00",
          "version_psk": 110,
          "checksum": "56916a0ee47c8bb21f6aeda815101f8a4198209b376a0e10d0c5b87cb4a23597",
          "sign_credentials_psk": null,
          "action": "upload"
        }
      },
      "reviews_enabled": true,
      "short_description": "Actions app",
      "screenshot_path3": "",
      "screenshot_path1": "",
      "type": 0,
      "screenshot_path4": "",
      "screenshot_path5": "",
      "status": 1,
      "psk": 77,
      "sort_weight": 1000,
      "no_auth_delivery_enabled": true,
      "deleted": null,
      "icon_path": "org_11/iphone_77/Actions_57.png",
      "is_email_config_profile": false,
      "custom_metadata": null,
      "add_to_start": false,
      "screenshot_path2": "",
      "tablet_screenshot_path5": "",
      "min_os_version": "7.1",
      "bundle_id": "com.apperian.Actions",
      "banner_image_url": null,
      "last_version_downloaded": {
        "psk": 110,
        "posted_date": "2016-03-24T13:02:55.921400+00:00",
        "description": "asdf",
        "version_num": "2.0",
        "verification_status": 0,
        "latest_install_file": 145,
        "release_date": "2016-03-24T13:02:55.921400+00:00",
        "required": false,
        "required_by": "9999-12-31T23:59:59.999999",
        "app_psk": 77,
        "wrap_status": 0,
        "signstatus": 0,
        "veracode_verification_status": 0,
        "kryptowire_verification_status": 0,
        "notify_users": false,
        "install_file": {
          "file_type_constant": "INSTALLEXE",
          "apperian_wrapper_version": null,
          "veracode_verification_id": null,
          "kryptowire_verification_id": null,
          "hash_type": "none",
          "hash_value": null,
          "description": null,
          "app_psk": 77,
          "size": 293807,
          "until": "2016-08-19T20:48:06+00:00",
          "psk": 145,
          "complete": true,
          "appthority_verification_id": null,
          "deleted": false,
          "expires": "2016-08-19T20:48:06+00:00",
          "mime": "application/itunes+zip",
          "path": "org_11/iphone_77/version_110/Actions.ipa",
          "name": null,
          "created": "2016-03-24T13:02:43.816387+00:00",
          "version_psk": 110,
          "checksum": "56916a0ee47c8bb21f6aeda815101f8a4198209b376a0e10d0c5b87cb4a23597",
          "sign_credentials_psk": null,
          "action": "upload"
        }
      },
      "tablet_screenshot_path3": "",
      "tablet_screenshot_path4": "",
      "tablet_screenshot_path2": "",
      "name": "Actions",
      "tablet_screenshot_path1": "",
      "required": false,
      "push_enabled": false
    }
  ]
}
GET /v1/catalog/applications/updates/

Attention

There is a newer version of this resource available: GET /v2/catalog/applications/updates/. This v1 version will be deprecated in Q3 of 2017. If you currently interface with this v1 resource, please modify your code to point to the latest V2 version. If you have any questions, contact support@apperian.com.

List Applications with Updates

Requires user and device context. Use session token returned from POST /catalog/authenticate.

Returns a list of applications that are installed on the users device and have an update available.

URLs

Environment URL
North America https://na01ws.apperian.com/v1/catalog/applications/updates/
Europe https://eu01ws.apperian.eu/v1/catalog/applications/updates/

URL Parameters

None

Header Parameter

X-UDID
(Required) Unique identifier assigned by EASE to the device.
X-TOKEN
(Required) Session token returned by POST /catalog/authenticate.

Data Parameters

None

Example Request

curl -X GET https://na01ws.apperian.com/v1/catalog/applications/updates/
--header "X-UDID: 90b0e24db7f650bbec684b60c6da855e4c98b28b" --header "X-TOKEN: eTg8ktZXRqKIBJTHunwP6A"

Example Response

In the following example, there are two updates available.

{
  "updateable_apps": [
    {
      "display_message": "",
      "operating_system": 1,
      "update_compliance_period_in_days": null,
      "url_scheme": "",
      "num_likes": 0,
      "form_factor": 3,
      "tablet_screenshot_path3": null,
      "long_description": "Manage your To Do list",
      "review_quote": "Be the first to review this app!",
      "is_adhoc": false,
      "platform": null,
      "is_hybrid": false,
      "has_update": true,
      "user_liked": null,
      "required_by": "9999-12-31T23:59:59.999999",
      "os_version": null,
      "is_app_catalog": false,
      "version": {
        "psk": 112,
        "posted_date": "2016-03-25T16:35:09.204520+00:00",
        "description": "asdf",
        "version_num": "2.0",
        "verification_status": 0,
        "latest_install_file": 147,
        "release_date": "2016-03-25T16:35:09.204520+00:00",
        "required": false,
        "required_by": "9999-12-31T23:59:59.999999",
        "app_psk": 77,
        "wrap_status": 0,
        "signstatus": 0,
        "veracode_verification_status": 0,
        "kryptowire_verification_status": 0,
        "notify_users": true,
        "install_file": {
          "file_type_constant": "INSTALLEXE",
          "apperian_wrapper_version": null,
          "veracode_verification_id": null,
          "kryptowire_verification_id": null,
          "hash_type": "none",
          "hash_value": null,
          "description": null,
          "app_psk": 77,
          "size": 293807,
          "until": "2016-08-19T20:48:06+00:00",
          "psk": 147,
          "complete": true,
          "appthority_verification_id": null,
          "deleted": false,
          "expires": "2016-08-19T20:48:06+00:00",
          "mime": "application/itunes+zip",
          "path": "org_11/iphone_77/version_112/Actions.ipa",
          "name": null,
          "created": "2016-03-25T16:35:04.029514+00:00",
          "version_psk": 112,
          "checksum": "56916a0ee47c8bb21f6aeda815101f8a4198209b376a0e10d0c5b87cb4a23597",
          "sign_credentials_psk": null,
          "action": "upload"
        }
      },
      "reviews_enabled": true,
      "short_description": "Actions app",
      "screenshot_path3": null,
      "screenshot_path1": null,
      "type": 0,
      "screenshot_path4": null,
      "screenshot_path5": null,
      "status": 1,
      "psk": 77,
      "sort_weight": 1000,
      "no_auth_delivery_enabled": true,
      "deleted": null,
      "icon_path": "https://na01ws.apperian.com/catalog/assets/org_11/iphone_77/Actions_57.png",
      "is_email_config_profile": false,
      "custom_metadata": null,
      "add_to_start": false,
      "screenshot_path2": null,
      "tablet_screenshot_path5": null,
      "min_os_version": "7.1",
      "bundle_id": "com.apperian.Actions",
      "banner_image_url": null,
      "last_version_downloaded": {
        "psk": 110,
        "posted_date": "2016-03-24T13:02:55.921400+00:00",
        "description": "asdf",
        "version_num": "2.0",
        "verification_status": 0,
        "latest_install_file": 145,
        "release_date": "2016-03-24T13:02:55.921400+00:00",
        "required": false,
        "required_by": "9999-12-31T23:59:59.999999",
        "app_psk": 77,
        "wrap_status": 0,
        "signstatus": 0,
        "veracode_verification_status": 0,
        "kryptowire_verification_status": 0,
        "notify_users": false,
        "install_file": {
          "file_type_constant": "INSTALLEXE",
          "apperian_wrapper_version": null,
          "veracode_verification_id": null,
          "kryptowire_verification_id": null,
          "hash_type": "none",
          "hash_value": null,
          "description": null,
          "app_psk": 77,
          "size": 293807,
          "until": "2016-08-19T20:48:06+00:00",
          "psk": 145,
          "complete": true,
          "appthority_verification_id": null,
          "deleted": false,
          "expires": "2016-08-19T20:48:06+00:00",
          "mime": "application/itunes+zip",
          "path": "org_11/iphone_77/version_110/Actions.ipa",
          "name": null,
          "created": "2016-03-24T13:02:43.816387+00:00",
          "version_psk": 110,
          "checksum": "56916a0ee47c8bb21f6aeda815101f8a4198209b376a0e10d0c5b87cb4a23597",
          "sign_credentials_psk": null,
          "action": "upload"
        }
      },
      "install_uri": "itms-services://?action=download-manifest&url=https?%3A%2F%2Fna01ws.apperian.com%2Fdownloads%2Finstall%2Fapplications%2F77%3Ftoken%3DQRNyq3ctRM-RsGaaUs22aQ%26udid%3DFFFFFFFF3A2569060A104EECA06F66DFBFE20A8D",
      "categories": [
        {
          "psk": 244,
          "org_psk": 11,
          "constant": "COMPANY",
          "name": "Company Wide",
          "icon_path": "/icons/categories/company_wide.png",
          "description": ""
        }
      ],
      "num_downloads": 1,
      "tablet_screenshot_path4": null,
      "tablet_screenshot_path2": null,
      "name": "Actions",
      "tablet_screenshot_path1": null,
      "required": false,
      "push_enabled": false,
      "num_dislikes": 0,
      "mdm_install": false
    }
  ]
}

In the following example, there are no updates available.

{
     "updateable_apps": []
}
GET /v1/catalog/applications/mandatory/

Attention

There is a newer version of this resource available: GET /v2/catalog/applications/mandatory/. This v1 version will be deprecated in Q3 of 2017. If you currently interface with this v1 resource, please modify your code to point to the latest V2 version. If you have any questions, contact support@apperian.com.

List Applications with Mandatory Updates

Requires user and device context. Use session token returned from POST /catalog/authenticate.

Called by catalogs to retrieve a list of both mandatory apps and apps that have a mandatory update pending. When you add an iOS or Android app to EASE, you can specify that the app is mandatory; users are prompted to install the application when they log in to the App Catalog and cannot continue to use the catalog until the app is installed. For more information on mandatory apps, see Add an Application. When you update an iOS or Android app, you can make the update mandatory to specify that users are required to update to the new version by a particular date. Like with a mandatory app, users are prompted to install mandatory updates when they log in to the App Catalog, and cannot continue to use the App Catalog until all mandatory updates are installed. For more information on mandatory updates, see Mandatory Versus Optional Updates.

URLs

Environment URL
North America https://na01ws.apperian.com/v1/catalog/applications/mandatory/
Europe https://eu01ws.apperian.eu/v1/catalog/applications/mandatory/

URL Parameters

None

Header Parameter

X-UDID
(Required) Unique identifier assigned by EASE to the device.
X-TOKEN
(Required) Session token returned by POST /catalog/authenticate.

Data Parameters

None

Example Request

curl https://na01ws.apperian.com/v1/catalog/applications/mandatory/ --header "X-UDID: 90b0e24db7f650bbec684b60c6da855e4c98b28b" --header "X-TOKEN: eTg8ktZXRqKIBJTHunwP6A"

Example Response

The following response returns two applications: one is a mandatory app that the user has not yet installed; the other is a mandatory update for an app that the user has already installed.

{
         "mandatory_apps": [
            {
              "display_message": "",
              "operating_system": 1,
              "update_compliance_period_in_days": 7,
              "url_scheme": "",
              "form_factor": 3,
              "long_description": "Everything you need to know about training at Example Company.",
              "is_adhoc": false,
              "platform": null,
              "is_hybrid": false,
              "required_by": "2016-05-31T00:00:00+00:00",
              "os_version": null,
              "is_app_catalog": false,
              "version": {
                 "psk": 69869,
                 "posted_date": "2016-05-31T16:10:48.409010+00:00",
                 "description": "Usability enhancements",
                 "version_num": "3.0",
                 "verification_status": 0,
                 "latest_install_file": 88587,
                 "release_date": "2016-05-31T16:10:48.409010+00:00",
                 "required": false,
                 "required_by": "9999-12-31T23:59:59.999999",
                 "files_pruned": false,
                 "app_psk": 21779,
                 "wrap_status": 0,
                 "signstatus": 0,
                 "veracode_verification_status": 0,
                 "kryptowire_verification_status": 0,
                 "notify_users": true,
                 "install_file": {
                   "file_type_constant": "INSTALLEXE",
                   "apperian_wrapper_version": null,
                   "veracode_verification_id": null,
                   "kryptowire_verification_id": null,
                   "hash_type": "none",
                   "hash_value": null,
                   "description": null,
                   "app_psk": 21779,
                   "size": 336012,
                   "until": "2016-08-19T20:48:06+00:00",
                   "psk": 88587,
                   "complete": true,
                   "appthority_verification_id": null,
                   "deleted": false,
                   "expires": "2016-08-19T20:48:06+00:00",
                   "mime": "application/itunes+zip",
                   "path": "org_1062/iphone_21779/version_69869/Training.ipa",
                   "name": null,
                   "created": "2016-05-31T16:10:15.115773+00:00",
                   "version_psk": 69869,
                   "checksum": "3141d6efc8a0da06edc31ee285c59ec9263d1bff7d65d326e3f9ea1e9b6b4191",
                   "sign_credentials_psk": null,
                   "action": "upload"
                 }
               },
               "reviews_enabled": true,
               "short_description": "la",
               "screenshot_path3": "",
               "screenshot_path1": "",
               "type": 0,
               "screenshot_path4": "",
               "screenshot_path5": "",
               "status": 1,
               "psk": 21779,
               "sort_weight": 1000,
               "no_auth_delivery_enabled": false,
               "deleted": null,
               "icon_path": "org_1062/iphone_21779/Training_57.png",
               "is_email_config_profile": false,
               "custom_metadata": {
                  "school": "default value",
                  "major": "default value",
                  "year": "Sophomore"
                },
               "add_to_start": false,
               "screenshot_path2": "",
               "tablet_screenshot_path5": "",
               "min_os_version": "3.1",
               "bundle_id": "com.apperian.Training",
               "banner_image_url": null,
               "last_version_downloaded": {
                  "psk": 69864,
                  "posted_date": "2016-05-31T12:48:15.003784+00:00",
                  "description": "Usability enhancements",
                  "version_num": "2.0",
                  "verification_status": 0,
                  "latest_install_file": 88576,
                  "release_date": "2016-05-31T12:48:15.003784+00:00",
                  "required": false,
                  "required_by": "9999-12-31T23:59:59.999999",
                  "files_pruned": false,
                  "app_psk": 21779,
                  "wrap_status": 0,
                  "signstatus": 0,
                  "veracode_verification_status": 0,
                  "notify_users": true,
                  "install_file": {
                    "file_type_constant": "INSTALLEXE",
                    "apperian_wrapper_version": null,
                    "veracode_verification_id": null,
                    "hash_type": "none",
                    "hash_value": null,
                    "description": null,
                    "app_psk": 21779,
                    "size": 336012,
                    "until": "2016-08-19T20:48:06+00:00",
                    "psk": 88576,
                    "complete": true,
                    "appthority_verification_id": null,
                    "deleted": false,
                    "expires": "2016-08-19T20:48:06+00:00",
                    "mime": "application/itunes+zip",
                    "path": "org_1062/iphone_21779/version_69864/Training.ipa",
                    "name": null,
                    "created": "2016-05-31T12:47:58.766808+00:00",
                    "version_psk": 69864,
                    "checksum": "3141d6efc8a0da06edc31ee285c59ec9263d1bff7d65d326e3f9ea1e9b6b4191",
                    "sign_credentials_psk": null,
                    "action": "upload"
                  }
                },
                "install_uri": "itms-services://?action=download-manifest&url=https%3A%2F%2Fws-qaease.qa.apperian.com%2Fdownloads%2Finstall%2Fversions%2F69869%3Ftoken%3DlkMj_Q6OQcSZMjO1N2jK6w%26udid%3DFFFFFFFFB9FB2CB76F944C7795E0ADED5859DEA6",
                "tablet_screenshot_path3": "",
                "tablet_screenshot_path4": "",
                "tablet_screenshot_path2": "",
                "name": "Training",
                "tablet_screenshot_path1": "",
                "required": false,
                "push_enabled": false,
                "required_by_group": false,
                "mdm_install": false
              },
              {
                "display_message": "",
                "operating_system": 1,
                "update_compliance_period_in_days": null,
                "url_scheme": "eas24962",
                "form_factor": 3,
                "long_description": "Come on. Get organized today with the Actions app. Keep track of your TO DO list while also monitoring team status, project deadlines, and resource allocation. Organization is the key to success!",
                "is_adhoc": false,
                "platform": null,
                "is_hybrid": false,
                "required_by": "9999-12-31T23:59:59.999999",
                "os_version": null,
                "is_app_catalog": false,
                "version": {
                   "psk": 69735,
                   "posted_date": "2016-05-31T13:23:06+00:00",
                   "description": "Beta release",
                   "version_num": "2.0",
                   "verification_status": 0,
                   "latest_install_file": 88580,
                   "release_date": "2016-05-31T13:23:06+00:00",
                   "required": false,
                   "required_by": "9999-12-31T23:59:59.999999",
                   "files_pruned": false,
                   "app_psk": 24962,
                   "wrap_status": 0,
                   "signstatus": 1,
                   "veracode_verification_status": 0,
                   "notify_users": true,
                   "install_file": {
                      "file_type_constant": "INSTALLEXE",
                      "apperian_wrapper_version": null,
                      "veracode_verification_id": null,
                      "hash_type": "none",
                      "hash_value": null,
                      "description": null,
                      "app_psk": 24962,
                      "size": 293981,
                      "until": "9999-12-31T23:59:59.999999",
                      "psk": 88580,
                      "complete": true,
                      "appthority_verification_id": null,
                      "deleted": false,
                      "expires": "2016-08-19T20:48:06+00:00",
                      "mime": "application/itunes+zip",
                      "path": "org_1062/iphone_24962/version_69735/signed/Actions.ipa",
                      "name": null,
                      "created": "2016-05-31T13:23:06+00:00",
                      "version_psk": 69735,
                      "checksum": "708623d21d3b5c637b5873f94adffe3cee877a2a3c288b3d41b44116f6bd3f71",
                      "sign_credentials_psk": 641,
                      "action": "sign"
                    }
                  },
                  "reviews_enabled": true,
                  "short_description": "Manage your TO DO list",
                  "screenshot_path3": "",
                  "screenshot_path1": "",
                  "type": 0,
                  "screenshot_path4": "",
                  "screenshot_path5": "",
                  "status": 1,
                  "psk": 24962,
                  "sort_weight": 1000,
                  "no_auth_delivery_enabled": true,
                  "deleted": null,
                  "icon_path": "org_1062/iphone_24962/Actions_57.png",
                  "is_email_config_profile": false,
                  "custom_metadata": {
                     "school": "Harrison School of Business",
                     "major": "Marketing",
                     "year": "Senior"
                  },
                  "add_to_start": false,
                  "screenshot_path2": "",
                  "tablet_screenshot_path5": "",
                  "min_os_version": "7.1",
                  "bundle_id": "com.apperian.Actions",
                  "banner_image_url": null,
                  "last_version_downloaded": null,
                  "install_uri": "itms-services://?action=download-manifest&url=https%3A%2F%2Fws-qaease.qa.apperian.com%2Fdownloads%2Finstall%2Fversions%2F69735%3Ftoken%3DlkMj_Q6OQcSZMjO1N2jK6w%26udid%3DFFFFFFFFB9FB2CB76F944C7795E0ADED5859DEA6",
                  "tablet_screenshot_path3": "",
                  "tablet_screenshot_path4": "",
                  "tablet_screenshot_path2": "",
                  "name": "Actions",
                  "tablet_screenshot_path1": "",
                  "required": true,
                  "push_enabled": false,
                  "required_by_group": true,
                  "mdm_install": false
    }
  ]
}

In this example, there are no mandatory apps or updates available for the authenticated user.

{
     "mandatory_apps": []
}
POST /v1/catalog/applications/installed/

Post List of Installed Applications

Requires user and device context. Use session token returned from POST /catalog/authenticate.

Use this resource to send EASE a list of the applications installed on the authenticated user’s device so that EASE has an up-to-date inventory. When EASE does not have an accurate inventory of what is installed on a user’s device, certain features will not work properly; for example, EASE will not send a push notification to the user’s device when there is an update available for an app it does not know is installed. You can send a request to this resource after Downloads and Installs API requests for apps, and also whenever an application is installed on a device outside of the App Catalog (for example, though a Direct Install link or an MDM system).

Note

To determine whether an iOS app is already installed on a device, compare the URL scheme of the app with the URL schemes registered on the device. To determine whether an Android or Windows app is already installed on a device, compare the package name of the app with the package names registered on the device.

URLs

Environment URL
North America https://na01ws.apperian.com/v1/catalog/applications/installed/
Europe https://eu01ws.apperian.eu/v1/catalog/applications/installed/

URL Parameters

None

Header Parameter

X-UDID
(Required) Unique identifier assigned by EASE to the device.
X-TOKEN
(Required) Session token returned by POST /catalog/authenticate.
Content-Type
(Required) Specifies the content type of the body of data sent with the request. Set to: application/json

Data Parameters

applications

(Required) Comma-separated list of application PSKs or appIDs, with “1” to indicate that an app is installed on the device and “0” to indicate that it is not. For example: '{"applications": {"123": "1", "124": "1", "125": "0"} }'

To retrieve the application PSKs, you can first send a request to the GET /catalog/applications resource. It returns information, including psk, for each application available to the authenticated user.

Example Request

curl -X  POST https://na01ws.apperian.com/v1/catalog/applications/installed/
     --header "Content-Type: application/json" --header "X-UDID: FFFFFFFFA8DF6FB4697A44C09DDFBB7D87B83289"
     --header "X-TOKEN: DsF1AAy6TCGNd2WE_un-0g"
     --data '{"applications": {"7150": "1", "2377": "1", "11377": "0"}}'

Example Response

{
  "updated": true
}
GET /v1/catalog/applications/installed/

List Installed Applications

Requires user and device context. Use session token returned from POST /catalog/authenticate.

Returns a list of applications that the authenticated user has installed on to the specified device through the App Catalog.

In order for EASE to have an accurate record of what is installed on the device, the catalog should send a request to POST /catalog/applications/installed after any apps are installed on the device.

URLs

Environment URL
North America https://na01ws.apperian.com/v1/catalog/applications/installed/
Europe https://eu01ws.apperian.eu/v1/catalog/applications/installed/

URL Parameters

None

Header Parameter

X-UDID
(Required) Unique identifier assigned by EASE to the device.
X-TOKEN
(Required) Session token returned by POST /catalog/authenticate.

Data Parameters

None

Example Request

curl -X GET https://na01ws.apperian.com/v1/catalog/applications/installed/
     --header "X-TOKEN: eTg8ktZXRqKIBJTHunwP6A" --header "X-UDID: 90b0e24db7f650bbec684b60c6da855e4c98b28b"

Example Response

{
  "installed_apps": [
    {
      "updated_date": "2014-02-10T19:09:12.855823",
      "psk": 194,
      "version_psk": 15208,
      "device_psk": 856,
      "user_psk": 24,
      "source": 2,
      "created_date": "2014-02-05T11:50:39.038194",
      "app_psk": 1910
    },
    {
      "updated_date": "2014-02-04T21:46:05.449752",
      "psk": 180,
      "version_psk": 15146,
      "device_psk": 856,
      "user_psk": 24,
      "source": 2,
      "created_date": "2014-02-04T21:39:41.062779",
      "app_psk": 7398
    },
    {
      "updated_date": "2014-02-10T19:13:12.762927",
      "psk": 179,
      "version_psk": 15148,
      "device_psk": 856,
      "user_psk": 24,
      "source": 0,
      "created_date": "2014-02-04T21:39:28.306171",
      "app_psk": 2377
    },
    {
      "updated_date": "2014-02-10T19:13:12.757301",
      "psk": 74,
      "version_psk": 14967,
      "device_psk": 856,
      "user_psk": 24,
      "source": 0,
      "created_date": "2014-01-29T14:08:42.141502",
      "app_psk": 7354
    }
  ]
}
GET /v2/catalog/categories/(string: category_id)/applications/

List Apps in a Specific Category

Requires user and device context. Use session token returned from POST /catalog/authenticate.

Returns a list of all the applications in a particular category that can be viewed by the authenticated user on the specified device (correct form factor and in the user’s assigned groups).

URLs

Environment URL
North America https://na01ws.apperian.com/v2/catalog/categories/<category_psk>applications/
Europe https://eu01ws.apperian.eu/v2/catalog/categories/<category_psk>applications/

URL Parameters

category_psk
(Required) Unique ID for the category. DATA TYPE: integer
start
(Required) Defines starting index of the page. If not set, it starts from the first element by default. DATA TYPE: integer
count
(Required) Number of objects to display in a page. DATA TYPE: integer

Header Parameter

X-UDID
(Required) Unique identifier assigned by EASE to the device.
X-TOKEN
(Required) Session token returned by POST /catalog/authenticate.

Data Parameters

None

Example Request

curl -X GET "https://na01ws.apperian.com/v2/catalog/categories/28/applications/?start=0&count=1"
     --header "X-UDID: 90b0e24db7f650bbec684b60c6da855e4c98b28b" --header "X-TOKEN: eTg8ktZXRqKIBJTHunwP6A"

Example Response

{
  "paging": {
    "total": 1,
    "next": null,
    "previous": null
  },
  "category_applications": [
    {
      "url_scheme": "",
      "id": "4LFYXMxwSPWJo46m6-sNzA",
      "catalog_info": {
        "install_uri": "itms-services://?action=download-manifest&url=https%3A%2F%2Fna01ws.apperian.com%2F%2Fdownloads%2Finstall%2Fversions%2F112%3Ftoken%3DDYfOqYIlRKSWq92y27GA4w%26udid%3Dffffffff0d57b5660a684e16aa6bb701739567fb",
        "user_liked": null,
        "review_quote": "Be the first to review this app!",
        "num_likes": 0,
        "last_install_file_downloaded_id": null,
        "last_version_downloaded_id": null,
        "has_update": false,
        "num_dislikes": 0,
        "num_downloads": 0
      },
      "version": {
        "app_name": "Actions",
        "version_num": "2.0",
        "version_note": "Includes bug fixes",
        "binary_version": "2.0",
        "custom_metadata": null,
        "long_description": "Get organized today with the Actions app.",
        "release_date": "2017-02-17T22:01:48+00:00",
        "id": "duUg3f151oxu0Uye7L0pVQ",
        "short_description": "Manage your TO DO list.",
        "icon_path": "https://na01ws.apperian.com//catalog/assets/org_2/iphone_79/Actions_57.png",
        "install_file": {
          "id": "1WOqHgpdhTBt0zjBN9eOWw",
          "sign_credentials_id": "N4OnKts9anclqJjcQz02Zg",
          "expires": "2019-02-03T14:16:08.000000+00:00",
          "created": "2017-02-13T21:25:08.663884+00:00",
          "path": "org_2/iphone_62/Actions.ipa",
          "size": 130877
        }
      },
      "reviews_enabled": true,
      "type": 0,
      "add_to_start": false,
      "bundle_id": "com.apperian.standard",
      "banner_image_url": "",
      "categories": [
        {
          "org_psk": 2,
          "constant": "COMPANY",
          "name": "Company Wide",
          "icon_path": "/icons/categories/company_wide.png",
          "org_id": "Ynm4meEuG4HOIOu7zwtC3A",
          "i18n_token": "application_category_company_wide",
          "id": "XTBEV_SGPlI0oI8ozGTh0A",
          "description": ""
        }
      ],
      "required_by_group": false
    }
  ]
}
GET /v2/catalog/search/

Search Application Data

Requires user and device context. Use session token returned from POST /catalog/authenticate.

Searches for the specified query string in the list of applications available to the authenticated user. The query searches the Name, Version, Short Description, and Long Description fields for a text match.

URLs

Environment URL
North America https://na01ws.apperian.com/v2/catalog/search/
Europe https://eu01ws.apperian.eu/v2/catalog/search/

URL Parameters

query
(Required) Text string that will be used for the query. DATA TYPE: string

Header Parameter

X-UDID
(Required) Unique identifier assigned by EASE to the device.
X-TOKEN
(Required) Session token returned by POST /catalog/authenticate.

Data Parameters

None

Example Request

curl -X GET "https://na01ws.apperian.com/v2/catalog/search/?query=training"
     --header "X-UDID: FFFFFFFFA8DF6FB4697A44C09DDFBB7D87B83269" --header "X-TOKEN: yuMYpRFxR--hBA5v3qP2Dw"

Example Response

The request above queries for the string “training” and returns data about one application.

{
  "applications": [
    {
      "url_scheme": "",
      "id": "Skhyo45wxzMEiZVlgBkaZw",
      "catalog_info": {
        "install_uri": "itms-services://?action=download-manifest&url=https%3A%2F%2Fna01ws.apperian.com%2F%2Fdownloads%2Finstall%2Fversions%2F90%3Ftoken%3DDYfOqYIlRKSWq92y27GA4w%26udid%3Dffffffff0d57b5660a684e16aa6bb701739567fb",
        "user_liked": null,
        "review_quote": "Be the first to review this app!",
        "num_likes": 0,
        "last_install_file_downloaded_id": null,
        "last_version_downloaded_id": null,
        "has_update": false,
        "num_dislikes": 0,
        "num_downloads": 0
      },
      "version": {
        "app_name": "Training",
        "version_num": "2.0",
        "version_note": "Includes bug fixes",
        "binary_version": "2.0",
        "custom_metadata": null,
        "long_description": "Your one stop shop for all training needs.",
        "release_date": "2014-01-09T16:05:01.042354+00:00",
        "id": "g-zL5G6YkxZOrbJHd0j9zA",
        "short_description": "Training Portal",
        "icon_path": "https://na01ws.apperian.com//catalog/assets/org_2/iphone_43/icon_b60696442d404d39478d841623b503e6.png",
        "install_file": {
          "id": "1WOqHgpdhTBt0zjBN9eOWw",
          "sign_credentials_id": "N4OnKts9anclqJjcQz02Zg",
          "expires": "2019-02-03T14:16:08.000000+00:00",
          "created": "2017-02-13T21:25:08.663884+00:00",
          "path": "org_2/iphone_62/Training.ipa",
          "size": 130877
        }
      },
      "reviews_enabled": true,
      "type": 0,
      "add_to_start": false,
      "bundle_id": "com.apperian.Training",
      "banner_image_url": "",
      "categories": [
        {
          "constant": "COMPANY",
          "name": "Company Wide",
          "icon_path": "/icons/categories/company_wide.png",
          "org_id": "Ynm4meEuG4HOIOu7zwtC3A",
          "i18n_token": "application_category_company_wide",
          "id": "XTBEV_SGPlI0oI8ozGTh0A",
          "description": ""
        }
      ],
      "required_by_group": false
    }
  ]
}
GET /v2/catalog/applications/updates/

List Applications with Updates

Requires user and device context. Use session token returned from POST /catalog/authenticate.

Returns a list of applications that are installed on the users device and have an update available.

URLs

Environment URL
North America https://na01ws.apperian.com/v2/catalog/applications/updates/
Europe https://eu01ws.apperian.eu/V2/catalog/applications/updates/

URL Parameters

None

Header Parameter

X-UDID
(Required) Unique identifier assigned by EASE to the device.
X-TOKEN
(Required) Session token returned by POST /catalog/authenticate.

Data Parameters

None

Example Request

curl -X GET https://na01ws.apperian.com/v2/catalog/applications/updates/
--header "X-UDID: 90b0e24db7f650bbec684b60c6da855e4c98b28b" --header "X-TOKEN: eTg8ktZXRqKIBJTHunwP6A"

Example Response

In the following example, there is one update available.

{
  "updateable_apps": [
    {
      "url_scheme": "",
      "id": "4LFYXMxwSPWJo46m6-sNzA",
      "catalog_info": {
        "install_uri": "itms-services://?action=download-manifest&url=https%3A%2F%2Fna01ws.apperian.com%2F%2Fdownloads%2Finstall%2Fversions%2F112%3Ftoken%3DDYfOqYIlRKSWq92y27GA4w%26udid%3Dffffffff0d57b5660a684e16aa6bb701739567fb",
        "user_liked": 1,
        "review_quote": "It's great!",
        "num_likes": 70,
        "last_install_file_downloaded_id": "VB7NEuLsft_vVovjky0Baw",
        "last_version_downloaded_id": "duUg3f151oxu0Uye7L0pVQ",
        "has_update": true,
        "num_dislikes": 8,
        "num_downloads": 953
      },
      "version": {
        "app_name": "Actions",
        "version_num": "2.0",
        "version_note": "a",
        "binary_version": "2.0",
        "custom_metadata": null,
        "long_description": "a",
        "release_date": "2017-02-18T00:10:46+00:00",
        "id": "duUg3f151oxu0Uye7L0pVQ",
        "short_description": "a",
        "icon_path": "https://na01ws.apperian.com//catalog/assets/org_2/iphone_79/Actions_57.png",
        "install_file": {
          "id": "1WOqHgpdhTBt0zjBN9eOWw",
          "sign_credentials_id": "N4OnKts9anclqJjcQz02Zg",
          "expires": "2019-02-03T14:16:08.000000+00:00",
          "created": "2017-02-13T21:25:08.663884+00:00",
          "path": "org_2/iphone_62/Actions.ipa",
          "size": 130877
        }
      },
      "reviews_enabled": true,
      "type": 0,
      "add_to_start": false,
      "bundle_id": "com.apperian.standard",
      "banner_image_url": "",
      "custom_metadata": null,
      "long_description": "An application for testing a variety of functionality on the device.",
      "release_date": "2017-02-18T00:10:46+00:00",
      "id": "duUg3f151oxu0Uye7L0pVQ",
      "short_description": "Test out your phone!",
      "icon_path": "https://na01ws.apperian.com//catalog/assets/org_2/iphone_79/Actions_57.png"
      },
      "categories": [
        {
          "constant": "COMPANY",
          "name": "Company Wide",
          "icon_path": "/icons/categories/company_wide.png",
          "org_id": "Ynm4meEuG4HOIOu7zwtC3A",
          "i18n_token": "application_category_company_wide",
          "id": "XTBEV_SGPlI0oI8ozGTh0A",
          "description": ""
        }
      ],
      "required_by_group": false
    }
  ]
}

In the following example, there are no updates available.

{
     "updateable_apps": []
}
GET /v2/catalog/applications/mandatory/

List Applications with Mandatory Updates

Requires user and device context. Use session token returned from POST /catalog/authenticate.

Called by catalogs to retrieve a list of both mandatory apps and apps that have a mandatory update pending. When you add an iOS or Android app to EASE, you can specify that the app is mandatory; users are prompted to install the application when they log in to the App Catalog and cannot continue to use the catalog until the app is installed. For more information on mandatory apps, see Add an Application. When you update an iOS or Android app, you can make the update mandatory to specify that users are required to update to the new version by a particular date. Like with a mandatory app, users are prompted to install mandatory updates when they log in to the App Catalog, and cannot continue to use the App Catalog until all mandatory updates are installed. For more information on mandatory updates, see Mandatory Versus Optional Updates.

URLs

Environment URL
North America https://na01ws.apperian.com/v2/catalog/applications/mandatory/
Europe https://eu01ws.apperian.eu/v2/catalog/applications/mandatory/

URL Parameters

None

Header Parameter

X-UDID
(Required) Unique identifier assigned by EASE to the device.
X-TOKEN
(Required) Session token returned by POST /catalog/authenticate.

Data Parameters

None

Example Request

curl https://na01ws.apperian.com/v2/catalog/applications/mandatory/ --header "X-UDID: 90b0e24db7f650bbec684b60c6da855e4c98b28b" --header "X-TOKEN: eTg8ktZXRqKIBJTHunwP6A"

Example Response

The following response returns two applications: one is a mandatory app that the user has not yet installed; the other is a mandatory update for an app that the user has already installed.

{
  "mandatory_apps": [
     {
        "url_scheme": "",
        "id": "49DYCelYigYMkYfE6QNw6g",
        "catalog_info": {
          "install_uri": "itms-services://?action=download-manifest&url=https%3A%2F%2Fna01ws.apperian.com%2F%2Fdownloads%2Finstall%2Fversions%2F7%3Ftoken%3DDYfOqYIlRKSWq92y27GA4w%26udid%3Dffffffff0d57b5660a684e16aa6bb701739567fb",
          "last_install_file_downloaded_id": null,
          "last_version_downloaded_id": null,
        },
        "version": {
          "app_name": "Benefits",
          "version_num": "2.0",
          "version_note": "Latest Version",
          "binary_version": "2.0",
          "custom_metadata": null,
          "long_description": "Everything related to Example Company benefits.",
          "release_date": "2012-01-20T19:52:50.112592+00:00",
          "id": "49DYCelYigYMkYfE6QNw6g",
          "short_description": "Benefits handbook",
          "icon_path": "org_2/iphone_7/Benefits_57.png",
          "install_file": {
            "id": "1WOqHgpdhTBt0zjBN9eOWw",
            "sign_credentials_id": "N4OnKts9anclqJjcQz02Zg",
            "expires": "2019-02-03T14:16:08.000000+00:00",
            "created": "2017-02-13T21:25:08.663884+00:00",
            "path": "org_2/iphone_62/Benefits.ipa",
            "size": 130877
          }
        },
        "reviews_enabled": null,
        "type": 0,
        "add_to_start": false,
        "bundle_id": "com.apperian.Benefits",
        "banner_image_url": null,
        "required_by_group": true
    },
    {
        "url_scheme": "",
        "id": "rJde8feBigUWrQcE6Qitc9",
        "catalog_info": {
          "install_uri": "itms-services://?action=download-manifest&url=https%3A%2F%2Fna01ws.apperian.com%2F%2Fdownloads%2Finstall%2Fversions%2F7%3Ftoken%3DDYfOqYIlRKSWq92y27GA4w%26udid%3Dffffffff0d57b5660a684e16aa6bb701739567fb",
          "last_install_file_downloaded_id": null,
          "last_version_downloaded_id": null,
        },
        "version": {
          "app_name": "Actions",
          "version_num": "3.0",
          "version_note": "Beta release",
          "binary_version": "2.0",
          "custom_metadata": null,
          "long_description": "Come on and get organized today!",
          "release_date": "2012-01-20T19:52:50.112592+00:00",
          "id": "rJde8feBigUWrQcE6Qitc9",
          "short_description": "Manage your TO DO list",
          "icon_path": "org_2/iphone_7/Actions.png",
          "install_file": {
            "id": "1WOqHgpdhTBt0zjBN9eOWw",
            "sign_credentials_id": "N4OnKts9anclqJjcQz02Zg",
            "expires": "2019-02-03T14:16:08.000000+00:00",
            "created": "2017-02-13T21:25:08.663884+00:00",
            "path": "org_2/iphone_62/Actions.ipa",
            "size": 130877
          }
        },
        "reviews_enabled": null,
        "type": 0,
        "add_to_start": false,
        "bundle_id": "com.apperian.Actions",
        "banner_image_url": null,
        "required_by_group": true
    }
  ]
}

In this example, there are no mandatory apps or updates available for the authenticated user.

{
     "mandatory_apps": []
}
GET /v2/catalog/applications/

List Applications for the Authenticated User’s Device

Requires user and device context. Use session token returned from POST /catalog/authenticate.

Returns a list of applications available to the authenticated user on the user’s specific device. In addition to listing only those applications that a user has permission to see based on organization and group, this resource also filters applications based on the user’s device (form factor). It does not return any applications that are disabled in EASE.

The resource response includes an ApplicationModel object for each application. Each ApplicationModel object includes:

  • A VersionModel object that defines the latest version of the application.
  • An InstallFileModel object that defines how to download the latest version.

All model objects are filtered so that the catalog user can see only the appropriate fields.

URLs

Environment URL
North America https://na01ws.apperian.com/v2/catalog/applications/
Europe https://eu01ws.apperian.eu/v2/catalog/applications/

URL Parameters

start
(Optional) Defines starting index of the page. Default: 0 (first element)
count
(Optional) Number of objects to display in a page. Default: 20
sort_field

(Optional) Which application field to use as the sorting key: Default: name

  • name
  • psk (unique ID assigned to the app by EASE)
  • short_description
  • long_description
  • bundle_id
  • type
  • display_message
  • operating_system
  • form_factor
  • status
sort_direction

(Optional) Which direction to sort the sort field: Default: asc

  • asc: ascending order
  • desc: descending order

Header Parameter

X-UDID
(Required) Unique identifier assigned by EASE to the device.
X-TOKEN
(Required) Session token returned by POST /catalog/authenticate.

Data Parameters

None

Example Request

This example returns one application.

curl "https://na01ws.apperian.com/v2/catalog/applications/?start=0&count=1&sort_direction=desc" --header "X-UDID: FFFFFFFFA8DF6FB4697A44C09DDFBB7D87B83269" --header "X-TOKEN: MkeEs5xYRNyRiSIlrGi4QQ"

Example Response

{
  "applications": [
    {
      "url_scheme": "",
      "id": "4LFYXMxwSPWJo46m6-sNzA",
      "catalog_info": {
        "install_uri": "itms-services://?action=download-manifest&url=https%3A%2F%2Fna01ws.apperian.com%2F%2Fdownloads%2Finstall%2Fversions%2F112%3Ftoken%3DDYfOqYIlRKSWq92y27GA4w%26udid%3Dffffffff0d57b5660a684e16aa6bb701739567fb",
        "user_liked": null,
        "review_quote": "Be the first to review this app!",
        "num_likes": 0,
        "last_install_file_downloaded_id": null,
        "last_version_downloaded_id": null,
        "has_update": false,
        "num_dislikes": 0,
        "num_downloads": 0
      },
      "version": {
        "app_name": "Actions",
        "version_num": "2.0",
        "version_note": "a",
        "binary_version": "2.0",
        "custom_metadata": null,
        "long_description": "Come on. Get organized today with the Actions app.",
        "release_date": "2017-02-17T22:01:48+00:00",
        "id": "duUg3f151oxu0Uye7L0pVQ",
        "short_description": "Manage Your TO DO List",
        "icon_path": "https://na01ws.apperian.com//catalog/assets/org_2/iphone_79/Actions_57.png",
        "install_file": {
          "id": "1WOqHgpdhTBt0zjBN9eOWw",
          "sign_credentials_id": "N4OnKts9anclqJjcQz02Zg",
          "expires": "2019-02-03T14:16:08.000000+00:00",
          "created": "2017-02-13T21:25:08.663884+00:00",
          "path": "org_2/iphone_62/Actions.ipa",
          "size": 130877
        }
      },
      "reviews_enabled": true,
      "type": 0,
      "add_to_start": false,
      "bundle_id": "com.apperian.standard",
      "banner_image_url": "",
      "categories": [
        {
          "constant": "COMPANY",
          "name": "Company Wide",
          "icon_path": "/icons/categories/company_wide.png",
          "org_id": "Ynm4meEuG4HOIOu7zwtC3A",
          "i18n_token": "application_category_company_wide",
          "id": "XTBEV_SGPlI0oI8ozGTh0A",
          "description": ""
        }
      ],
      "required_by_group": false
    }
  ],
    "paging": {
      "total": 1,
      "next": null,
      "previous": null
    }
}

List Apps in Order of Popularity (# of Downloads)

Requires user and device context. Use session token returned from POST /catalog/authenticate.

Returns a list of downloaded native apps in descending order by number of downloads.

Download Count includes App Catalog downloads, but the initial download of an App Catalog is not counted until a user has logged in to the App Catalog on the device; subsequent downloads of App Catalog updates are counted without requiring the user to log in.

URLs

Environment URL
North America https://na01ws.apperian.com/v2/catalog/applications/popular/
Europe https://eu01ws.apperian.eu/v2/catalog/applications/popular/

URL Parameters

start
(Optional) Defines starting index of the page. If not set, it starts from the first element by default.
count
(Optional) Number of objects to display in a page.

Header Parameter

X-UDID
(Required) Unique identifier assigned by EASE to the device.
X-TOKEN
(Required) Session token returned by POST /catalog/authenticate.

Data Parameters

None

Example Request

curl https://na01ws.apperian.com/v2/catalog/applications/popular/?start=0&count=1"
     --header "X-UDID: 90b0e24db7f650bbec684b60c6da855e4c98b28b" --header "X-TOKEN: eTg8ktZXRqKIBJTHunwP6A"

Example Response

{
  "applications": [
    {
      "url_scheme": "",
      "id": "49DYCelYigYMkYfE6QNw6g",
      "catalog_info": {
        "install_uri": "itms-services://?action=download-manifest&url=https%3A%2F%2Fna01ws.apperian.com%2F%2Fdownloads%2Finstall%2Fversions%2F7%3Ftoken%3DDYfOqYIlRKSWq92y27GA4w%26udid%3Dffffffff0d57b5660a684e16aa6bb701739567fb",
        "user_liked": 0,
        "review_quote": "Be the first to review this app!",
        "num_likes": 3,
        "last_install_file_downloaded_id": null,
        "last_version_downloaded_id": null,
        "has_update": false,
        "num_dislikes": 1,
        "num_downloads": 9
      },
      "version": {
        "app_name": "Benefits",
        "version_num": "2.0",
        "version_note": "Benefits Version Notes",
        "binary_version": "2.0",
        "custom_metadata": null,
        "long_description": "Everything you need to know about benefits at Example Company.",
        "release_date": "2012-01-20T19:52:50.112592+00:00",
        "id": "49DYCelYigYMkYfE6QNw6g",
        "short_description": "Benefits handbook",
        "icon_path": "https://na01ws.apperian.com//catalog/assets/org_2/iphone_7/Benefits_57.png",
        "install_file": {
          "id": "1WOqHgpdhTBt0zjBN9eOWw",
          "sign_credentials_id": "N4OnKts9anclqJjcQz02Zg",
          "expires": "2019-02-03T14:16:08.000000+00:00",
          "created": "2017-02-13T21:25:08.663884+00:00",
          "path": "org_2/iphone_62/Benefits.ipa",
          "size": 130877
        }
      },
      "reviews_enabled": null,
      "type": 0,
      "add_to_start": false,
      "bundle_id": "com.apperian.Benefits",
      "banner_image_url": null,
      "categories": [
        {
          "org_psk": 2,
          "constant": "COMPANY",
          "name": "Company Wide",
          "icon_path": "/icons/categories/company_wide.png",
          "org_id": "Ynm4meEuG4HOIOu7zwtC3A",
          "i18n_token": "application_category_company_wide",
          "id": "XTBEV_SGPlI0oI8ozGTh0A",
          "description": ""
        }
      ],
      "required_by_group": false
    }
  ],
  "paging": {
    "total": 1,
    "next": null,
    "previous": null
  }
}

List Featured Apps

Requires user and device context. Use session token returned from POST /catalog/authenticate.

Returns a list of featured applications that are available to the authenticated user and applicable for the user’s device. An EASE administrator can select featured apps in the EASE Portal as a way to encourage App Catalog users to install them. In the Apperian App Catalog, featured apps display in the cover flow area at the top of the Popular page in the App Catalog. For more information on featured apps, see Select Featured Apps for the App Catalog.

This resource filters on the authenticated device rather than requiring the catalog app PSK to detect the platform. Rather than returning all the ApplicationFeaturedModel objects, it returns just the ApplicationModel objects inside the ApplicationFeaturedModel objects; the ApplicationFeaturedModel objects have information that the catalog does not need, but the EASE Administrator does.

URLs

Environment URL
North America https://na01ws.apperian.com/v2/catalog/applications/featured/
Europe https://eu01ws.apperian.eu/v2/catalog/applications/featured/

URL Parameters

None

Header Parameter

X-UDID
(Required) Unique identifier assigned by EASE to the device.
X-TOKEN
(Required) Session token returned by POST /catalog/authenticate.

Data Parameters

None

Example Request

curl -X GET https://na01ws.apperian.com/v2/catalog/applications/featured/
     --header "X-UDID: 90b0e24db7f650bbec684b60c6da855e4c98b28b" --header "X-TOKEN: eTg8ktZXRqKIBJTHunwP6A"

Example Response

{
  "applications": [
    {
        "url_scheme": "",
        "id": "uuF6Togc2wcUkGiMPc90SQ",
        "catalog_info": {
          "install_uri": "itms-services://?action=download-manifest&url=https%3A%2F%2Fna01ws.apperian.com%2F%2Fdownloads%2Finstall%2Fversions%2F114%3Ftoken%3DDYfOqYIlRKSWq92y27GA4w%26udid%3Dffffffff0d57b5660a684e16aa6bb701739567fb",
          "user_liked": null,
          "featured_quote": "This is a great app!",
          "review_quote": "Be the first to review this app!",
          "num_likes": 27,
          "last_install_file_downloaded_id": "9SOuUnIotyIQ4VU6H9obCw",
          "last_version_downloaded_id": "2lzJidYE5RVxPHgelHHO3g",
          "has_update": false,
          "num_dislikes": 2,
          "num_downloads": 253
        },
        "version": {
          "app_name": "Directory",
          "version_num": "3.0",
          "version_note": "We've updated this version with more bells and whistlesl!",
          "binary_version": "3.0",
          "custom_metadata": null,
          "long_description": "If it isn't in this directory, it doesn't exist.",
          "release_date": "2017-02-17T22:57:04+00:00",
          "id": "2lzJidYE5RVxPHgelHHO3g",
          "short_description": "Example Company Directory",
          "icon_path": "https://na01ws.apperian.com//catalog/assets/org_2/iphone_6/Training_57.png",
          "install_file": {
              "id": "1WOqHgpdhTBt0zjBN9eOWw",
              "sign_credentials_id": "N4OnKts9anclqJjcQz02Zg",
              "expires": "2019-02-03T14:16:08.000000+00:00",
              "created": "2017-02-13T21:25:08.663884+00:00",
              "path": "org_2/iphone_62/Directory.ipa",
              "size": 130877
          }
        },
        "reviews_enabled": true,
        "type": 0,
        "add_to_start": false,
        "bundle_id": "com.apperian.standard",
        "banner_image_url": "",
        "categories": [
          {
            "org_psk": 2,
            "constant": "COMPANY",
            "name": "Company Wide",
            "icon_path": "/icons/categories/company_wide.png",
            "org_id": "Ynm4meEuG4HOIOu7zwtC3A",
            "i18n_token": "application_category_company_wide",
            "id": "XTBEV_SGPlI0oI8ozGTh0A",
            "description": ""
          }
        ],
        "required_by_group": false,
    }
  ]
}
GET /v2/catalog/applications/(app_id)

List Data for a Specific Application

Requires user and device context. Use session token returned from POST /catalog/authenticate.

Returns details for the latest version of the specified application available to the authenticated user.

URLs

Environment URL
North America https://na01ws.apperian.com/v2/catalog/applications/<app_id>
Europe https://eu01ws.apperian.eu/v2/catalog/applications/<app_id>

URL Parameters

app_id
(Required) Unique ID for the app. DATA TYPE: integer

Header Parameter

X-UDID
(Required) Unique identifier assigned by EASE to the device.
X-TOKEN
(Required) Session token returned by POST /catalog/authenticate.
Data Parameters
None

Example Request

curl -X GET https://na01ws.apperian.com/v2/catalog/applications/HzzlFUtgmqucv4mUAHPxlw --header "X-UDID: 90b0e24db7f650bbec684b60c6da855e4c98b28b" --header "X-TOKEN: eTg8ktZXRqKIBJTHunwP6A"

Example Response

 {
    "application": {
        "add_to_start": false,
        "banner_image_url": "",
        "bundle_id": "com.apperian.Training",
        "catalog_info": {
            "has_update": false,
            "install_uri": "itms-services://?action=download-manifest&url=https%3A%2F%2Fna01ws.apperian.com%2Fdownloads%2Finstall%2Fversions%2F16860%3Ftoken%3Drq2S3j-2T5arNPtWfYYgMA%26udid%3Dffffffffd1a5e893e86d40978a279c4a4f3a7d47",
            "last_install_file_downloaded_id": null,
            "last_version_downloaded_id": null,
            "num_dislikes": 0,
            "num_downloads": 6,
            "num_likes": 1,
            "review_quote": "Great UI changes",
            "user_liked": 1
        },
        "categories": [
            {
                "constant": "COMPANY",
                "description": "",
                "i18n_token": "application_category_company_wide",
                "icon_path": "/icons/categories/company_wide.png",
                "id": "LIq_C_LfObdwYSlNHbR9Fw",
                "name": "Company Wide",
                "org_id": "qAD5Cq41K38PzlQUQwOj3g",
            }
        ],
        "id": "HzzlFUtgmqucv4mUAHPxlw",
        "required_by_group": false,
        "reviews_enabled": false,
        "type": 0,
        "url_scheme": "eas5347,eas5347,eas5347",
        "version": {
            "app_name": "Training",
            "binary_version": "2.0",
            "icon_path": "https://na01ws.apperian.com/catalog/assets/org_45/iphone_5347/Training_57.png",
            "id": "PVDjBJvpdqO_dCp1damUwg",
            "long_description": "This app is one-stop shopping for all your Example Company training needs! Sign up for onsite classes, access CBTs and other training materials, complete self assessments, and much more. If you are determined to learn, NO ONE can stop you!",
            "psk": 16860,
            "release_date": "2016-11-23T01:05:42+00:00",
            "short_description": "Corporate Training",
            "version_note": "latest version that is so awesome",
            "version_num": "2.0",
            "custom_metadata": {
                "Location": "Boston",
                "description": "Corporate Training",
                "title": "Division 1"
            },
            "install_file": {
                "id": "1WOqHgpdhTBt0zjBN9eOWw",
                "sign_credentials_id": "N4OnKts9anclqJjcQz02Zg",
                "expires": "2019-02-03T14:16:08.000000+00:00",
                "created": "2017-02-13T21:25:08.663884+00:00",
                "path": "org_2/iphone_62/Training.ipa",
                "size": 130877
            }
        }
    }
}
GET /v2/catalog/applications/versions/(version_id)

List Data for a Specific Version of Application

Requires user and device context. Use session token returned from POST /catalog/authenticate.

Returns application details for a specific version of application, including latest version and install file information.

URLs

Environment URL
North America https://na01ws.apperian.com/v2/catalog/applications/versions/<version_id>
Europe https://eu01ws.apperian.eu/v2/catalog/applications/versions/<version_id>

URL Parameters

version_id
(Required) Unique ID for a specific version of an application. DATA TYPE: integer

Header Parameter

X-UDID
(Required) Unique identifier assigned by EASE to the device.
X-TOKEN
(Required) Session token returned by POST /catalog/authenticate.

Data Parameters

None

Example Request

curl -X GET https://na01ws.apperian.com/v2/catalog/applications/versions/2lzJidYE5RVxPHgelHHO3g --header "X-UDID: 90b0e24db7f650bbec684b60c6da855e4c98b28b" --header "X-TOKEN: eTg8ktZXRqKIBJTHunwP6A"

Example Response

{
  "application": {
    "url_scheme": "",
    "id": "uuF6Togc2wcUkGiMPc90SQ",
    "catalog_info": {
      "install_uri": "itms-services://?action=download-manifest&url=https%3A%2F%2Fna01ws.apperian.com%2F%2Fdownloads%2Finstall%2Fversions%2F114%3Ftoken%3DDYfOqYIlRKSWq92y27GA4w%26udid%3Dffffffff0d57b5660a684e16aa6bb701739567fb",
      "user_liked": null,
      "review_quote": "Be the first to review this app!",
      "num_likes": 0,
      "last_install_file_downloaded_id": "9SOuUnIotyIQ4VU6H9obCw",
      "last_version_downloaded_id": "2lzJidYE5RVxPHgelHHO3g",
      "has_update": false,
      "num_dislikes": 0,
      "num_downloads": 3
    },
    "version": {
      "app_name": "Directory New!",
      "version_num": "3.0",
      "version_note": "We've updated this version with some new bells and whistles!",
      "binary_version": "3.0",
      "custom_metadata": null,
      "long_description": "If you can't find the information here, it doesn't exist!",
      "release_date": "2017-02-17T22:57:04+00:00",
      "id": "2lzJidYE5RVxPHgelHHO3g",
      "short_description": Example Company Directory",
      "icon_path": "https://na01ws.apperian.com//catalog/assets/org_2/iphone_6/Training_57.png",
      "install_file": {
          "id": "1WOqHgpdhTBt0zjBN9eOWw",
          "sign_credentials_id": "N4OnKts9anclqJjcQz02Zg",
          "expires": "2019-02-03T14:16:08.000000+00:00",
          "created": "2017-02-13T21:25:08.663884+00:00",
          "path": "org_2/iphone_62/Directory.ipa",
          "size": 130877
        }
    },
    "reviews_enabled": true,
    "type": 0,
    "add_to_start": false,
    "bundle_id": "com.apperian.standard",
    "banner_image_url": "",
    "categories": [
      {
        "constant": "COMPANY",
        "name": "Company Wide",
        "icon_path": "/icons/categories/company_wide.png",
        "org_id": "Ynm4meEuG4HOIOu7zwtC3A",
        "i18n_token": "application_category_company_wide",
        "id": "XTBEV_SGPlI0oI8ozGTh0A",
        "description": ""
      }
    ],
    "required_by_group": false
  }
}
GET /v2/catalog/applications/downloaded/

List Downloaded Applications

Requires user and device context. Use session token returned from POST /catalog/authenticate.

Returns a list of applications that the authenticated user has downloaded onto the specified device.

URLs

Environment URL
North America https://na01ws.apperian.com/v2/catalog/applications/downloaded/
Europe https://eu01ws.apperian.eu/v2/catalog/applications/downloaded/

URL Parameters

None

Header Parameter

X-UDID
(Required) Unique identifier assigned by EASE to the device.
X-TOKEN
(Required) Session token returned by POST /catalog/authenticate.

Data Parameters

None

Example Request

curl -X GET https://na01ws.apperian.com/v2/catalog/applications/downloaded/
     --header "X-TOKEN: eTg8ktZXRqKIBJTHunwP6A" --header "X-UDID: 90b0e24db7f650bbec684b60c6da855e4c98b28b"

Example Response

{
  "applications": [
    {
      "url_scheme": "appcatalog",
      "id": "wElzMR1ZsqhaK3ZM1H2ktg",
      "catalog_info": {
        "last_install_file_downloaded_id": "uqfkQIUB4Y4kM2nlTKIgVw",
        "last_version_downloaded_id": "DGkBu2v_mJLnX8jkdbxTXQ",
      },
      "version": {
        "app_name": "App Catalog",
        "version_num": "3",
        "version_note": "Various bug fixes.",
        "binary_version": "3",
        "custom_metadata": null,
        "long_description": "The Apperian App Catalog delivers your applications straight to your device.",
        "release_date": "2017-02-17T22:36:14.475790+00:00",
        "id": "DGkBu2v_mJLnX8jkdbxTXQ",
        "short_description": "Delivers applications.",
        "icon_path": "org_2/iphone_80/AppIcon76x76@2x~ipad.png",
        "install_file": {
          "id": "1WOqHgpdhTBt0zjBN9eOWw",
          "sign_credentials_id": "N4OnKts9anclqJjcQz02Zg",
          "expires": "2019-02-03T14:16:08.000000+00:00",
          "created": "2017-02-13T21:25:08.663884+00:00",
          "path": "org_2/iphone_62/App_Catalog.ipa",
          "size": 130877
        }
      },
      "reviews_enabled": true,
      "type": 0,
      "add_to_start": false,
      "bundle_id": "com.apperian.appcatalog",
      "banner_image_url": "",
      "required_by_group": false
    },
    {
      "url_scheme": "",
      "id": "uuF6Togc2wcUkGiMPc90SQ",
      "catalog_info": {
        "last_install_file_downloaded_id": "9SOuUnIotyIQ4VU6H9obCw",
        "last_version_downloaded_id": "2lzJidYE5RVxPHgelHHO3g",
      },
      "version": {
        "app_name": "Directory",
        "version_num": "3.0",
        "version_note": "We've updated this version with lots of bells and whistles!",
        "binary_version": "3.0",
        "custom_metadata": null,
        "long_description": "If you can't find it in this directory, it doesn't exist.",
        "release_date": "2017-02-17T22:57:04+00:00",
        "id": "2lzJidYE5RVxPHgelHHO3g",
        "short_description": "Example Company Directory",
        "icon_path": "org_2/iphone_6/Training_57.png",
        "install_file": {
          "id": "1WOqHgpdhTBt0zjBN9eOWw",
          "sign_credentials_id": "N4OnKts9anclqJjcQz02Zg",
          "expires": "2019-02-03T14:16:08.000000+00:00",
          "created": "2017-02-13T21:25:08.663884+00:00",
          "path": "org_2/iphone_62/Directory.ipa",
          "size": 130877
        }
      },
      "reviews_enabled": true,
      "type": 0,
      "add_to_start": false,
      "bundle_id": "com.apperian.standard",
      "banner_image_url": "",
      "required_by_group": false
    }
  ]
}
GET /v2/catalog/applications/updates/

List Applications with Updates

Requires user and device context. Use session token returned from POST /catalog/authenticate.

Returns a list of applications that are installed on the users device and have an update available.

URLs

Environment URL
North America https://na01ws.apperian.com/v2/catalog/applications/updates/
Europe https://eu01ws.apperian.eu/V2/catalog/applications/updates/

URL Parameters

None

Header Parameter

X-UDID
(Required) Unique identifier assigned by EASE to the device.
X-TOKEN
(Required) Session token returned by POST /catalog/authenticate.

Data Parameters

None

Example Request

curl -X GET https://na01ws.apperian.com/v2/catalog/applications/updates/
--header "X-UDID: 90b0e24db7f650bbec684b60c6da855e4c98b28b" --header "X-TOKEN: eTg8ktZXRqKIBJTHunwP6A"

Example Response

In the following example, there is one update available.

{
  "updateable_apps": [
    {
      "url_scheme": "",
      "id": "4LFYXMxwSPWJo46m6-sNzA",
      "catalog_info": {
        "install_uri": "itms-services://?action=download-manifest&url=https%3A%2F%2Fna01ws.apperian.com%2F%2Fdownloads%2Finstall%2Fversions%2F112%3Ftoken%3DDYfOqYIlRKSWq92y27GA4w%26udid%3Dffffffff0d57b5660a684e16aa6bb701739567fb",
        "user_liked": 1,
        "review_quote": "It's great!",
        "num_likes": 70,
        "last_install_file_downloaded_id": "VB7NEuLsft_vVovjky0Baw",
        "last_version_downloaded_id": "duUg3f151oxu0Uye7L0pVQ",
        "has_update": true,
        "num_dislikes": 8,
        "num_downloads": 953
      },
      "version": {
        "app_name": "Actions",
        "version_num": "2.0",
        "version_note": "a",
        "binary_version": "2.0",
        "custom_metadata": null,
        "long_description": "a",
        "release_date": "2017-02-18T00:10:46+00:00",
        "id": "duUg3f151oxu0Uye7L0pVQ",
        "short_description": "a",
        "icon_path": "https://na01ws.apperian.com//catalog/assets/org_2/iphone_79/Actions_57.png",
        "install_file": {
          "id": "1WOqHgpdhTBt0zjBN9eOWw",
          "sign_credentials_id": "N4OnKts9anclqJjcQz02Zg",
          "expires": "2019-02-03T14:16:08.000000+00:00",
          "created": "2017-02-13T21:25:08.663884+00:00",
          "path": "org_2/iphone_62/Actions.ipa",
          "size": 130877
        }
      },
      "reviews_enabled": true,
      "type": 0,
      "add_to_start": false,
      "bundle_id": "com.apperian.standard",
      "banner_image_url": "",
      "custom_metadata": null,
      "long_description": "An application for testing a variety of functionality on the device.",
      "release_date": "2017-02-18T00:10:46+00:00",
      "id": "duUg3f151oxu0Uye7L0pVQ",
      "short_description": "Test out your phone!",
      "icon_path": "https://na01ws.apperian.com//catalog/assets/org_2/iphone_79/Actions_57.png"
      },
      "categories": [
        {
          "constant": "COMPANY",
          "name": "Company Wide",
          "icon_path": "/icons/categories/company_wide.png",
          "org_id": "Ynm4meEuG4HOIOu7zwtC3A",
          "i18n_token": "application_category_company_wide",
          "id": "XTBEV_SGPlI0oI8ozGTh0A",
          "description": ""
        }
      ],
      "required_by_group": false
    }
  ]
}

In the following example, there are no updates available.

{
     "updateable_apps": []
}
POST /v2/catalog/authenticate/

Authenticate User and Register App Catalog

Use this resource to authenticate an App Catalog user, and optionally register the App Catalog with EASE. This is the authenticate resource you need to call to authenticate users for requests to Catalog API, Downloads and Installs API, and Reviews API resources. For requests to other APIs, make a call to the POST /users/authenticate resource. Unlike the other authenticate resource, with this resource you provide not only the user ID and password for a valid EASE user, but also information about the user’s device. This enables EASE to respond with data appropriate for both the user and the device. For example, you can request a list of applications that can both run on the device (they are built for the correct operating system) and be accessed by the user (they are assigned to a group to which the user is a member).

To authenticate a user, you specify the user ID and password for a valid EASE user. EASE responds with a unique session token that you can then provide in the HTTPS header (as X-TOKEN: {token}) of one or more subsequent requests to the Catalog API, Downloads and Installs API, and Reviews API. The token authenticates a specific user, so you will need to provide different tokens based on who you need to authenticate during the transaction. Within an API session, if you need to connect as the same user for multiple requests, you can use the same token.

To register an App Catalog, you provide the bundle/package ID and version number of the App Catalog installed on the user’s device. EASE uses this information to create (if not already created) or identify a unique identifier for the device–the “device ID.” A device ID associates a user with a particular App Catalog version and device. Device ID is used with many functions in EASE.

Note

This resource authenticates users with the default EASE authentication method. Single Sign-On (SSO) authentication to EASE is not yet supported through the Apperian API.

URLs

Environment URL
North America https://na01ws.apperian.com/v2/catalog/authenticate
Europe https://eu01ws.apperian.eu/v2/catalog/authenticate

URL Parameters

None

Header Parameters

X-BUNDLE-ID
(Required only if register_catalog is set to true) App Catalog bundle ID (iOS) or package ID (Android, Windows 8, and Windows Phone). For example: --header "X-BUNDLE-ID: com.apperian.hub.ios"
X-VERSION-NUM
(Required only if register_catalog is set to true) App Catalog version number. For example: --header "X-VERSION-NUM: 1.2.3"
Content-Type
(Required with all requests) Specifies the content type of the body of data sent with the request. Set to:
application/json

Data Parameters

user_id
(Required) User ID of the authenticating user. The session token will be tied to this user.
password
(Required) User’s password.
remember_me
(Required)
  • true specifies that the session token will use the Remember Me expiration timeout for the organization.
  • false specifies that the session token will use the default session expiration defined for the organization. With the EASE App Catalog, this is set when the user selects a Remember Me option on the Login page.
register_catalog
(Required)
  • true registers the App Catalog and version number specified in the header of the request.
  • false does not register an App Catalog. Use this setting only if you are requesting data for a catalog that is not installed on a user’s device. For example, an enterprise portal.
device_info

(Required) Device information used to identify the device. Include the following parameters:

manufacturer
The device manufacturer.
operating system

A code for the operating system running on the device. Use one of these codes:

0 Unknown
1 iOS
102 Android 2
103 Android 3
104 Android 4
105 Android 5
106 Android 6
107 Android 7
108 Android 8
401 Windows Phone 8
operating_system_name
The name of the operating system running on the device.
operating_system_version
The version of the operating system running on the device.
name
The device name.
udid

(Required) A unique identifier for the device. When EASE receives this identifier, it looks to see if it already exists in the EASE database. If it does not, EASE creates a new entry for the device.

For this type of device... Provide this ID...
iOS The vendor ID for your custom App Catalog app.
Android The Wifi Mac address of the device.
Windows Phone A unique ID fetched using the Windows PhoneDeviceExtendedProperties.GetValue method.
Windows 8 The first network device’s mac address.
apns_token (iOS)

Push notification token received from Apple.

To get this token, you will need to register to receive push notifications via Apple Push Notification Service. For instructions, see the iOS Developer Library.

form_factor

The form factor of the device. Use one of these codes:

0 Unknown
1 Phone
2 Tablet
model
The device model.
total_ram
Total RAM on the device. DATA TYPE: integer
free_ram
Available RAM on the device. DATA TYPE: integer
total_storage
Total storage on the device. DATA TYPE: integer
free_storage
Available storage on the device. DATA TYPE: integer
camera
Whether or not the device has a camera. DATA TYPE: boolean
front_camera
Whether or not the device has a front camera. DATA TYPE: boolean
flash
Whether or not the device supports a flash. DATA TYPE: boolean

For example:

"device_info": {  "manufacturer": "Apple, Inc.", "operating_system": "1", "operating_system_name": "iPhone OS", "operating_system_version": "7.1.1", "name": "Harry's iPhone", "udid": "[some guid]", "form_factor": 1, "model": iPhone5,1"}

Example Request

The following cURL command authenticates the rjames user.

curl -X POST  https://na01ws.apperian.com/v2/catalog/authenticate/ --header "Content-Type: application/json" --data '{"user_id": "rjames", "password": "123456", "remember_me": true, "register_catalog": true, "device_info": {"manufacturer": "Apple, Inc.", "operating_system": "1", "operating_system_name": "iPhone OS", "operating_system_version": "7.0.6", "name": "Kiosk iPad 1", "udid": "FFFFFFFFA8DF6FB4697A44C09DDFBB7D87B83269", "form_factor": "2", "model": "iPad2,2"}}' --header "X-BUNDLE-ID: com.apperian.appcatalog" --header "X-VERSION-NUM: 3.0.316"

Example Response

The response returns a unique session token. It also returns data about the user, the user’s organization, and the user’s device.

{
     "device": {
       "front_camera": false,
       "operating_system_name": "iPhone OS",
       "controllable_status": 0,
       "pairing_status": 0,
       "mdm_id": null,
       "form_factor": 2,
       "mdm_user_id": null,
       "until_date": "9999-12-31T23:59:59.999999",
       "total_ram": 0,
       "flash": false,
       "apns_token": null,
       "total_storage": 0,
       "camera": false,
       "id": "BTCPAPFAxDe4cbMgPXOrow",
       "operating_system_version": "7.0.6",
       "mdm_status": 0,
       "manufacturer": "Apple, Inc.",
       "operating_system": 1,
       "name": "Kiosk iPad 1",
       "jailbreak_status": -1,
       "created": "2015-07-29T01:58:11.426548+00:00",
       "udid": "FFFFFFFFA8DF6FB4697A44C09DDFBB7D87B83339",
       "free_storage": 0,
       "mdm_status_update_date": null,
       "free_ram": 0,
       "supervised": -1,
       "model": "iPad2,2",
       "disabled_reason": null,
       "single_app_mode_app_psk": null
     },
     "organization": {
       "id": "zDSrz_B5N_FjYAHlHBosnQ",
       "app_installation_path": "Enterprise Apps",
       "name": "Example Company 8"
     },
     "token": "2vycuVpYR7O_imehLjU92A",
     "ttl_in_seconds": 604799,
     "user": {
       "id": "zDSrz_B5N_FjYAHlHBosnQ",
       "first_name": "Robert",
       "last_name": "James",
       "modified_date": "2015-07-27T10:56:18+00:00",
       "email": "rjames@example.com",
       "mobile_phone": "122-890-7890",
       "role": 1,
       "created_date": "2013-07-23T18:46:36.487342+00:00",
       "until_date": "9999-12-31T23:59:59.999999",
       "user_id": "rjames",
       "last_login_from_catalog": "2015-07-29T01:58:11.377008"
     },
     "touch_id_auth": {
       "authentication_method": null,
       "authentication_url": null,
       "enable_touch_id": false,
       "event_login_button": "touchstart",
       "login_method": null,
       "login_url": null,
       "param_password": null,
       "param_user": null,
       "selector_login_button": "#login-button",
       "selector_password": "#login-password",
       "selector_user": "#login-username"
     }
}