FAQs

This page aims at answering the most frequently asked questions. If your question is not listed, need support or have a suggestion you'd like to share, please send your query to IOTICS Support. We're always happy to help.

How do I access my IOTICSpace?

The user interface can be accessed at https://{your-space-name}.iotics.space. If you need a new account or have issues logging in please contact IOTICS Support.

For the API please go to our API Reference.

How do I get started with the IOTICS API?

You could have a look at our Getting Started Guide, and if you need help with anything don't hesitate to contact us.

Where do you host IOTICSpace?

Each IOTICSpace comes fully deployed and set up on the IOTICS Cloud infrastructure. The ecosystem is built on a decentralized infrastructure, so each IOTICSpace is deployed on its own and data separation is guaranteed.

The connectors and agents are external to IOTICS and can be deployed anywhere in your estate, depending on your requirements. The same applies to your own ontology, however, we recommend that you make it public within the ecosystem so that others can interoperate with your data.

How can I share data through my Digital Twins?

Ingesting data into an IOTICSpace and sharing it through its Digital Twins requires the creation of a software application called "Connector", specifically a Publisher Connector. It acts as a bridge between your existing assets and data stores and the Digital Twins. You can see an example code here.

How can I export data from IOTICS?

Exporting data from Digital Twins into any other external application (e.g. a visualisation tool, alerting mechanism) is possible through a Follower Connector. If you're specifically looking to export data into a database or a CSV file, have a look at our step-by-step guide here.

How do I selectively share my Metadata and Data?

You can decide to make your twins visible (or not) and to share (or not) data with all, none, or a select number of other IOTICSpaces. Read more about it here.

I'm new to semantics. Can you help me?

Yes absolutely. IOTICS Support can help you with your question, and if you need more general support we can also organise a semantics workshop for you.

I have my own ontology. Can I use it with IOTICSpace?

Yes, you can. If you haven't already, we strongly recommend that you make it (or parts of it) public so that others can understand your data when you share it with them.

If you'd like to use and view your ontology through the user interface as well please contact us and we can make it available.

What is the difference between Create, Update and Upsert Twins?

Calling the Create Twin function equals building the outline of a Digital Twin.
Update Twin is used to add and update existing Digital Twin's metadata properties.
Upsert Twin combines both Create Twin and Update Twin, in order to streamline the process and reduce the number of API calls.

What's the difference between Connectors and Agents?

A connector is just the application while an agent has an IOTICS Decentralised Identity.
You may choose to use a single agent identity for a connector that manages multiple twins or choose to use different agent credentials, up to one per twin.
In other words, an agent is a connector with an identity and a connector is one or more agents.
IOTICS sees connectors as agents and the word connector generally refers to an application.