Base URL
The base URL is the same regardless of the specific API request that you make. To determine
what your base URL should be, copy the URL that you use to log into Minitab Connect
and add /api/odata_v4/
. For example, if you use
https://connect.minitab.com to access Minitab Connect, then the base URL for all
your OData API requests is:
https://connect.minitab.com/api/odata_v4/
.
Authentication methods
Informs the system that the request should be processed with the same permissions as the
specified user. Authentication is represented by an API Key. An API Key is a unique
string of characters that gives access to a feature in the tool. To create an API
key, open User Menu in the top right and select
Account Settings. For more information, go to Generate an API token.
There are three different authentication methods.
- Query String API Key
- A GET or POST Parameter named 'apikey' that contains a token that the Connect Account Settings
page generates. For example,
https://connect.minitab.com/api/odata_v4/?apikey=[apikey]
,
where you replace 'apikey' with the actual API key.
- Header API Key
- A HTTP Header named ‘X-Api-Key’ that contains a token that the Connect Account Settings page
generates.
- Basic Web Authentication
- Your username is your Connect username or email address. The password is a token that the
Connect Account Settings page generates.
Endpoints
- Base endpoint -
https://connect.minitab.com/api/odata_v4/
- Returns a list of entity sets that are the tables and views that the user has access
to.
Note
Connect remotes all non A-Z, a-z, 0-9,
-(hyphen), and _(underscore) characters from entities (records), entity
sets (tables and views), and properties. Connect appends "_t" for tables
and "_v" for views plus an ID to entity and entitty set names to
guarantee a unique name. For example:
- TableName_t38
- ViewName_v2
- Metadata endpoint -
https://connect.minitab.com/api/odata_v4/$metadata
- Returns XML Data Definition of all entities, entity sets, and properties.
- Entity Set endpoint -
https://connect.minitab.com/api/odata_v4/[EntitySet]
- Returns records from the entity set (table or view). By default, the order matches the
order in Base or the order on the View. Replace the ’EntitySet’ with the
corresponding Minitab Connect table or view name. You can return the names
of all tables and views from the Base Endpoint.
- The entity set endpoint currently only supports three functions:
- $count -
https://connect.minitab.com/api/odata_v4/[EntitySet]/?$count
- Returns the number of records
- $top -
https://connect.minitab.com/api/odata_v4/[EntitySet]/?$top=[number]
- Returns 'number' records from the entity set. Both the default
and the maximum are 5,000 records. You can combine with $skip to
page through all the records.
- $skip -
https://connect.minitab.com/api/odata_v4/[EntitySet]/?$skip=[number]
- Skips 'number' records. You can combine with $top to page
through all the records.
Note
The entity set endpoint does not currently
support the $filter, $select, $orderby, or $expand functions. You can
create the same effect of $filter, $select, and $orderby using the
Prep Tool in Minitab Connect and creating a saved view of your
table.
- Entity endpoint -
https://connect.minitab.com/api/odata_v4/[EntitySet]([sys_id])/
-
Returns an entity (one record), identified by ‘sys_id’, from the
specified ‘EntitySet’.