Glossary
 
Access Token
An access token is an object encapsulating the security identity of a process or thread. For example, in 3-Legged OAuth, you can get the access token after obtaining a request token and authorizing it by the user.
 
Alpha
Alpha status is assigned to API licenses that are being tested by select John Deere software partners. Documentation for resources within an alpha license is hidden from the public. If you are interested in alpha testing an API license, please contact us at APIAdmin@JohnDeere.com.
 
Beta
Beta status is assigned to API licenses that are being tested by select John Deere software partners. Documentation for resources within a beta license is visible to the public and marked with "Beta!" If you are interested in beta testing an API license, please contact us at APIAdmin@JohnDeere.com.
 
Boundaries
The term "boundaries" refer to the boundaries of a particular field.
 
Client (Agronomic Data)
The term "client" refers to the grower and/or Operations Center user associated with a specific farm.
 
Client (Software)
A software client refers to any application or software that a software partner (like you) may build.
 
Crop Season
A crop season refers to the year during which crops were planted and harvested.
 
Crop Type
Crop type refers to the type of crop planted in a certain field, such as corn, soybeans, cotton, etc.
 
Display/2630
The Greenstar™ 3 2630 Display is a model of the Command Arm display. Displays can be affixed to machines and communicate with the telematics gateway also attached to the machine. With the display, growers and machine operators can transfer prescriptions or other files to the machine, view the files, and carry out many different operations.
 
Equipment Interface Component (EIC)
EIC is essentially a “translator” that allows applications to decode data from John Deere Greenstar™ Displays. Becoming an EIC licensee will enable you to use the MyJohnDeere API fully by allowing your application to read all the data sent from displays.
 
Farm
A farm is a set of fields associated with a client.
 
Field
A field is an area of land within set boundaries assigned by a grower.
 
Files & File Sharing
Growers use many different types of files to help them with their operations, including Prescription, Setup, documentation, and more. MyJohnDeere API can enable your client to access their files on Operations Center and share these files with their trusted advisors, such as agronomists.
 
Files Transfers
With MyJohnDeere API, applications can allow users to transfer files automatically from Operations Center to their telematically enabled machines. Previously, Operations Center users had to transfer files to machines manually, via a flash drive.
 
JDLink is a system designed to optimize the machines in a grower’s operations. The system uses modular telematics gateways (MTGs) to transmit data collected on the machine to Deere’s platform. Growers can then view this data from the JDLink website. Data collected from JDLink includes machine locations, machine alerts, maintenance tracking, machine fuel usage, and other machine diagnostics. MTGs must have a JDLink license to record and transmit this data.
 
Jobs
The term "job" refers to a specific task within a field that a machine is set to complete. Jobs can involve seeding, application of products, harvesting, etc. to the specific crop type growing within the field.
 
JSON
JSON stands for JavaScript Object Notification. It is an open standard format that uses human-readable text to transmit data objects consisting of attribute-value pairs. It is used primarily to transmit data between a server and web application, as an alternative to XML. View more information about JSON.
 
Licenses (API)
API licenses refer to bundled resources within MyJohnDeere API. When you request access to the MyJohnDeere API for your application, you can also choose to request access to different bundles of resources. If an application has a specific license, it can make calls tied to that license. For example, if your application has the AgronomicBase license, it can make calls that pull Agronomic data from Operations Center.
 
Licenses (Terminals)
Licenses are assigned to MTGs and UTGs to allow them to gather data for the grower to use during operations. JDLink Ultimate and JDLink Select are examples of such licenses.
 
Operation Results
Operation results refers to the data gathered about a job once it has been completed by a machine. Operation results includes the type of job, the crop type, the crop season, and more.
 
Machine
The term “machine” in the context of this API refers to any machine connected with an MTG or UTG with a JDLink license, or a non-telematic machine that has been manually entered into Operations Center by a user. Machines can be tractors, combines, etc. that perform field work, or they can also refer to construction machines, such as excavators, loaders, and more.
 
MTG/UTG
Modular Telematics Gateways, or MTGs, are John Deere products that come factory-installed on many pieces of John Deere equipment. MTGs are also available as field kits that can attach to most vehicles. With JDLink subscriptions, MTGs collect and transmit data from the machine to John Deere’s platform, where it can then be viewed on the MyJohnDeere.com account of the machine’s owner/user. When an MTG or UTG is attached to a machine, that machine is said to be telematically enabled.
Universal Telematics Gateways, or UTGs, are devices that attach to machines and collect and transmit data from the machine. Unlike MTGs, UTGs are not a John Deere product.
 
John Deere Operations Center
Operations Center is an online farm management solution available through MyJohnDeere. Data from telematically enabled machines is transmitted and stored in Operations Center. It is used by growers and their trusted advisors, such as agronomists use Operations Center, to access and analyze this data. Operations Center also allows different organizations to partner and share files to expand their operations. MyJohnDeere API can link your application to John Deere Operations Center.
 
OAuth
OAuth is an open protocol for authorization on the web. It enables API providers to securely identify both the client and the user involved in a particular API call. For more information on the OAuth process as it pertains to MyJohnDeere API, read the OAuth documentation.
We also have an infographic to help you!
 
Organization
All Operations Center users belong to an organization. An organization can consist of one or more users. They can represent growers or their trusted advisors, such as agronomists, dealers, etc. Each organization can house data pertaining to their operations; for example, a grower organization can hold machine and agronomic data for a specific farm.
 
Partnership
Partnerships on Operations Center represent business relationships between organizations. Two partnered organizations can share files either individually or automatically with each other. Organizations can also specify the type of relationship they have with a partner and enable automatic file sharing for that purpose. For example, a grower Organization can automatically share all their agronomic data with an agronomist’s organization.
 
Product
Product refers to fertilizer or chemical products applied to a field.
 
REST-ful API
Representational State Transfer (REST) is a software architecture style consisting of guidelines and best practices for creating scalable web services. REST is a coordinated set of constraints applied to the design of components in a distributed hypermedia system that can lead to a more performant and maintainable architecture. View more information about REST.
 
Sandbox
The sandbox endpoint is available to anyone who registers on developer.deere.com for testing. To gain sandbox access to an API, you will have to create an app profile. Though sandbox calls return production data, only those who are registered on developer.deere.com can view it. You can also add other members to your app, who will all be able to test all the APIs connected to the app without having to use your account. Once you have tested sufficiently and move to using the MyJohnDeere API in production, anyone who uses your application may view data pulled using the API.
 
Subscription
Users can subscribe to certain John Deere services, such as JDLink. These subscriptions telematically enable machines and allow John Deere customers to store and view their data with their MyJohnDeere accounts on Operations Center, JDLink, etc.
 
Telematics Gateway
Telematics Gateway refers to the MTG or UTG on a machine. If a machine is connected to an MTG or UTG, it is considered to be telematically enabled.
 
Users
The term user refers to anyone who has an account on MyJohnDeere and stores data in Operations Center. A user may be a grower, a trusted adviser, a John Deere Dealer, etc.
 
Verifier
When going through OAuth security, Operations Center will pass a verifier along with the authorized request token to the client. The client can then call the oauthAccessToken and use the verifier and app ID as parameters to obtain the access token and secret.