Skip to main content

Developer Portal

Management can be done through specific portals. These provide a variety of features that can assist users.

Features​

The CNH Developer Portal provides the following:

  • Documentation of the CNH Application Programming Interfaces (APIs)
  • Offline applications for managing CN1 files using the CN1 SDK
  • Converting CN1 content into the ADAPT Data Model (ADM) using the CN1 ADAPT Plugin
  • Converting ISOXML content into the ADAPT Data Model (ADM) using the ISOXML Plugin
  • Glossary
  • Frequently Asked Questions (FAQs)
  • Ticketing system for support tickets

User Access​

You begin by creating an account on the CNH Developer Portal. Your Developer Portal user account uses your company email domain, grouping users for easy management. The first user account created is the administrator account. If needed, reassigning the administrator account later is an option.

Users can create and manage the company profile as well as your applications. The Developer Portal login credentials work only within the Developer Portal. They are not used or shared with the CNH AFS or PLM CONNECT accounts.

Development​

As a developer on the Developer Portal, you are building a third-party application to gain access to the data in one or more CNH grower or construction equipment accounts. Logging into one of CNH's CONNECT accounts as an application user will allow you to consent on behalf of your application, and then use an Access Token to call each API endpoint. You will manage the usage of Refresh and Access Tokens following the OAuth 2.0 Authorization Code grant type. The system issues a Client ID and Client Secret to your application.

In addition, you will need to use the environment and API-specific subscription key. The Postman Collections contain other important URL information. Requesting to promote your application to the Production Application happens after you have configured and tested your application in the CNH Staging environment. Promoting your application issues new application credentials, allowing you to download new Postman Collections for Production.

Postman Collections​

To download your Postman Collections, define your application in the Developer Portal. One collection lists the available API endpoints. The other collection contains URLs and environment variables used by the API endpoints collection.

Testing Environments​

Both CNH's Staging and Production environments have application credentials made available. Both environments are separate and do not share user identities, access, or data.

Base URLs​

CNH APIs rely on two main base URLs:

  • Identity Base URL, which points to the identity provider.
  • API Base URL, which points to the API.
TypeEnvironmentURL
IdentityStaginghttps://stg.identity.cnhind.com
IdentityProductionhttps://identity.cnhind.com
APIStaginghttps://stg.api-data.cnh.com/v1
APIProductionhttps://api-data.cnh.com/v1