Getting Started.

To get started using the ValeLearning API, please review the following sections:

Before you start

You will need:

• A client ID.
• A client Access Token.
• A browser to run your query.
• A command-line tool such as Terminal or an app like Postman that can perform cURL requests (For advanced requests only).

Register with L&D

Before your Client ID and Access Tokens are issued, we need to verify the legitimacy of your application. Please fill out the following form to request a developer account. Developer accounts contain your unique Client ID and Access Tokens.

Verifying your account credentials

Before you can query the API, you need to verify your account. Start by constructing an authorization window URL below, replacing {CLIENT_ID} with your Client ID and {ACCESS_TOKEN} with your Client Access Token.

If the credentials inputted above are valid, you will recieve the following JSONP response. Once recieved, you can start to perform basic queries with the API.

Supported API Queries.

To begin requesting contractor training data, please review the following sections:

Requesting Datasheets

You can query the API to recieve ValeLeaning datasheets. Datasheets contain a variety of information ranging from the module library to valid Vale Operations. Available datasheets types are as follows:

• modules (ValeLearning Module Library)
• locations (Available Vale Operations)
• occupations (Supported Occupation Types).
• vendors_ontario (Vale Certified Ontario Vendor List).
• vendors_manitoba (Vale Certified Manitoba Vendor List).
• vendors_newfoundland (Vale Certified Newfoundland Vendor List).
• vendors_unitedkingdom (Vale Certified United Kingdom Vendor List).
  
  
  

Start by constructing an authorization window URL below. In addition to your account credentials, you will need to replace {TYPE} with the preferred datasheet.

Since responses are formatted in JSONP, all queries require a unique callback. Replace {CALL} with your unique numerical callback.

Requesting All Contractor Information

You can query the API to recieve a full or ranged export of all contractor information. This is the only query that supports {START} and {END} parameters that target when the profile was last updated or created. Start by constructing an authorization window URL below. In addition to your account credentials, you will need to replace {START} and {END} with a date string (YYYY-MM-DD). If you wish to export all contractors, then you will set both {START} and {END} parameters to "all".

Since responses are formatted in JSONP, all queries require a unique callback. Replace {CALL} with your unique numerical callback.

If contractor accounts where updated or created within your parameters, the profiles will be exported in a JSONP response with your unique callback superseding the object. Please review the example response below:

Requesting a Single Contractor Profile

You can query the API to recieve a contractors full profile in a JSONP response. Start by constructing an authorization window URL below. In addition to your account credentials, you will need to replace {ID} with the contractors Vale Identification. Vale ID's come in many shapes and sizes such as:

• Vale Contractor Pass Number.
• Series C1000 number.
• NORCAT Number.
• Long Harbour 66LCH Number.
• Manitoba MB-C-0 Number.
  
  
  

Since responses are formatted in JSONP, all queries require a unique callback. Replace {CALL} with your unique numerical callback.

If the contractor exists, the profile will be exported in a JSONP response with your unique callback superseding the object. Please review the example response below:

In addition to the contractor information above, each contractor profile includes a full list of training records. Each training module has a unique ID and has five (5) data points. In the example below, the data pertains to Module ID 32 - Tier 1: General Orientation. For a full list of Module ID's, please view the Module ID Reference List.

The list below highlights the values of the JSON response above.

• "ID32": - Module status
• "ID32-CompletedDate": - Module completion date (YYYY-MM-DD)
• "ID32-ExpiryDate": - Module expiry date (YYYY-MM-DD)
• "ID32-Attempts": - Module exam re-attempts
• "ID32-Progression": - Module checkpoint (Only available if the module is in progress)
  
  
  

Requesting Module Completions

You can query the API to recieve module completions in a JSONP response. Start by constructing an authorization window URL below. In addition to your account credentials, you will need to replace {ID} with your desired course ID. You can find the full Module ID Reference List below in this tutorial.

Since responses are formatted in JSONP, all queries require a unique callback. Replace {CALL} with your unique numerical callback.

If the Module ID is valid, contractor profiles will be exported in a JSONP response with your unique callback superseding the object. Please review the example response below:

The list below highlights the values of the JSON response above:

• "CourseID": - The specified module
• "CourseStatus": - Module status
• "CourseCompleted": - Module completion date (YYYY-MM-DD)
• "CourseExpiry": - Module expiry date (YYYY-MM-DD)

Data Request Types

The ValeLearning API delivers data in two (2) formats. JSONP is the default data delivery type. If your application does not support JSONP, you can request the data in a downloadable CSV format for use in Microsoft Excel or simular applications. To request the CSV data type, simply change the {TYPE} object to equal "csv".

Queries that support CSV format:

• Requesting All Contractor Information (get_profiles)
• Requesting a Single Contractor Profile (user_profile)
• Requesting Module Completions (course_export)

Data Request Limits

The ValeLearning API has the following query limits in place:

• 2500 results per query (For basic developer accounts).
• 1 URL request every 5 seconds.
  
  
  

If you need these limits increased, please contact the system administrator.

Training Index.

The ValeLearning training index is outlined below:

Module Status

Our module library contains all current and depreciated training modules. Since contractor training is always changing, ValeLearning keeps records even if those records are no longer considered valid or have been replaced with an updated module.

Modules may be placed under the following status:

• Active - The module is considered valid training.
• Paused - The module is considered valid training but new contractor registrations have been suspended.
• Depreciated - The module has been removed from ValeLearning's course offerings. This is usually due to the module being replaced or the site/operation being closed.

Module ID Reference List ( items)

Below are the full course offerings from ValeLearning.ca. A more detailed overview can be accessed through the Data Sheets panel in your ValeLearning Management account.

Contact Us

If you have any questions or comments about this API documentation, please contact us at:

Gavin Toole, Interim Superintendent
Learning and Development, NA Operations

VALE
KMK Place, 2nd Level
18 Hebron Way
St. John's, NL, A1A 0L9
C: 1.709.728.6124

Matthew Urso, Senior Developer and ValeLearning Project Lead
OvertheAtlantic Interactive Limited (OTA)

OTA™ Creative. Candid. Insightful.
C: 1.705.521.2231
ota.studio

Last Updated: September 5th, 2023 at 1:00 PM