API Guide: Activity Data

An overview of accessing the R1 Discover activity data via our API.

Introduction

This guide provides detailed instructions for integration partners on how to effectively access user activity data via our API endpoints. By following this guide, partners can ensure a seamless and efficient integration process, enabling them to create a comprehensive picture of user activity within the R1 Discover platform.

Prerequisites

Before beginning the integration process, ensure an R1 Discover Tech Partner account has been created, and you are able to generate your bearer token for authentication.

Detailed instructions on prerequisites can be found here: R1 API: Getting Started

Workflow Overview

Understanding the workflow of accessing the user activity data API endpoints is crucial for efficient integration. This section outlines the order in which the endpoints should be accessed to successfully gather user activity data.

Workflow Diagram:

1. Generate Bearer Token

2. Retrieve Core Company Data

   • Company List

   • Company User List

   • Company Topic List

   • Company Activity List

3. Access Activity Data

   • View Company Taken Activity List

   • View Company Taken Activity Cards

   • View Company Taken Questions & Answers

Step-by-Step Instructions

Generate Bearer Token

Instructions:

1. Log into R1 Discover Tech Partner Account.

2. Select the My Companies tab.

3. Click the Key icon to generate a token.

4. Copy the token to a secure location. Note that the token will no longer be visible once you leave the page.

Link to Documentation: Generate Bearer Token

Retrieve Company List

Instructions:

1. Use the Company List Endpoint to retrieve the list of companies and their IDs.

2. Make a GET request to https://api.r1learning.com/api/v1/company-list/{page}/{limit}.

3. Include the Bearer token in the request headers.

Link to Documentation: Company List Endpoint

Retrieve Company Topic List

Instructions:

1. Use the Company Topic List Endpoint to retrieve the list of all topics available to a company.

2. Make a GET request to https://api.r1learning.com/api/v1/company-topic-list.

3. Include the Bearer token in the request headers.

Link to Documentation: Company Topic List Endpoint

Retrieve Company Activity List

Instructions:

1. Use the Company Activity List Endpoint to retrieve the list of all activities available to a company.

2. Make a GET request to https://api.r1learning.com/api/v1/company-activity-list.

3. Include the Bearer token in the request headers.

Link to Documentation: Company Activity List Endpoint

View Company Taken Activity List

Instructions:

1. Use the View Company Taken Activity List Endpoint to retrieve the list of all activities taken by users within a company.

2. Make a GET request to https://api.r1learning.com/api/v1/view-company-taken-activity-details/{companyId}/{page}/{limit}/{maxDays?}.

3. Include the Bearer token in the request headers.

Link to Documentation: View Company Taken Activity List Endpoint

View Company Taken Activity Cards

Instructions:

1. Use the View Company Taken Activity Cards Endpoint to retrieve card results for all activities.

2. Make a GET request to https://api.r1learning.com/api/v1/view-company-taken-activity-cards/{companyId}/{page}/{limit}/{maxDays?}.

3. Include the Bearer token in the request headers.

Link to Documentation: View Company Taken Activity Cards Endpoint

View Company Taken Questions & Answers

Instructions:

1. Use the View Company Taken Questions & Answers Endpoint to retrieve questions and answers results for all activities.

2. Make a GET request to https://api.r1learning.com/api/v1/view-company-taken-activity-questions-answers/{companyId}/{page}/{limit}/{maxDays?}.

3. Include the Bearer token in the request headers.

Link to Documentation: View Company Taken Questions & Answers Endpoint