Setting Up an API Ingest Datasource

Datasources are the heart of Twinnoverse, acting as the dedicated channels that stream your external data into the platform. This guide will walk you through creating a new “API Ingest” datasource, which allows you to push data directly to a secure endpoint.

---

Step 1: Navigate to the Datasources Tab #

From the main Twinnoverse Dashboard, select the “Datasources” tab from the primary navigation menu. This will take you to the datasource management screen, where you can view existing datasources and create new ones.

---

Step 2: Create the New Datasource #

1. Click the “Create New Datasource” button. This will open the creation panel.
2. In the “Name” input field, enter a clear and descriptive name for your data stream (e.g., “Factory Floor Sensors,” “Server Room Metrics”).
3. Click the “Confirm” button.

The system will create the new datasource and automatically generate the necessary credentials. The creation panel will close, and you will see your new datasource card appear in the list.

---

Step 3: Understanding the Datasource Card #

Your new datasource card contains all the essential information you need to start sending data.

1. Datasource Name: The name you provided.
2. API Key: A unique, secret key used to authorize your data submission. Treat this like a password.
3. Ingestion URL: The specific URL endpoint where you will send your data. This is a constant URL for all API Ingest datasources.
4. Example Schema: This is a powerful feature that shows you the exact JSON structure the system expects, based on the widgets you have linked to this datasource.

---

What Happens Next? #

Your datasource is now live and ready to accept data.

• To send data, you will make a POST request to the Ingestion URL with your data payload, including the API Key in the request header for authentication. For a detailed guide on this, see Developer & API > Ingest API Reference.
• To visualize the data, you need to link this datasource to a widget. Go to the Asset Editor, add a widget to one of your 3D assets, and select your newly created datasource from the configuration dropdown.