How do I create my machine (direct)?

innius supports two mechanisms to upload a machine and its associated data such as parts, specifications, and other information. This article describes the creation of a machine via a direct integration, for more information on the file based creation of a machine click here

In order to load the data from one or more systems, you need to communicate with the relevant APIs of innius, and you need to provide the correct credentials. For the credentials you use the company API key. Go to the page "Company" in the web administration application to generate this key. Note: The key is displayed once only, so make sure you store it in a safe place.

Click here for more detail on what a machine is in innius.

In order to create a machine you will follow these steps:

  1. Create machine ID;
  2. Create machine specifications;
  3. Create part ID's;
  4. Create part specifications;
  5. Create hierarchical relations of the machine and parts;
  6. Associate machine with your company.

For each step the following API's are used:

ad 1 Create machine ID. The POST end-point is called to create or update the machine identification in relation to a specific back-end system. Click for more technical details

Use this API to create one or more identifications for your machine. Each machine is assigned with a unique internal ID by innius, but it is possible to define multiple external ID's for a machine.

ad 2 Create machine specifications. The POST end-point is called to create or update the machine specifications related to the machine ID which is created in step 1. Click for more technical details

Use this API to specify the specifications of a machine.

ad 3 Create part ID's. The POST end-point is called to create or update the parts identifications in relation to a specific back-end system. Click for more technical details.

Use this API to create one or more identifications for the parts of the machine. Each part is assigned with a unique internal ID by innius, but it is possible to define multiple external ID's for a part.

ad 4 Create parts specifications. The POST end-point is called to create or update the part specifications related to the part ID which is created in step 3. Click for more technical details

Use this API to specify the specifications of the parts.

ad 5 Create hierarchical relations of the machine and parts. The POST end-point is called to create the composition of the machine and its parts. Click for more technical details

Use this API to specify the composition of a machine and parts.

ad 6 Associate machine with your company. The POST end-point ("/companies/{companyid}/machines") is called to associate the complete machine with your company. Click for more technical details.

Use this API to associate the machine to your company.

Have more questions? Submit a request

Comments