You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
@@ -86,14 +87,38 @@ A local repository folder will be created inside the tm-catalog directory
86
87
87
88
### Send TD feature
88
89
89
-
To use the **_Send TD_** feature, it is necessary to define in the Settings pop-up the Southbound URL and Northbound URL. The Send TD feature allows you to send your Thing Description to any service following [the WoT TD Directory specification](https://www.w3.org/TR/wot-discovery/#exploration-directory-api-things).
90
+
#### Northbound and Southbound URLs
91
+
92
+
When using the **Send TD** feature, ediTDor communicates with a proxy that exposes
93
+
an HTTP interface for interacting with a Thing.
94
+
95
+
-**Southbound URL**
96
+
- Base _Things API collection endpoint_ of the proxy where ediTDor sends the original Thing Description
97
+
- ediTDor performs a `POST` to this endpoint; the proxy assigns the Thing/TD identifier
98
+
- Used internally by the proxy to reach the underlying Thing using protocol-specific bindings (e.g., Modbus)
99
+
100
+
-**Northbound URL**
101
+
- Base _Things API collection endpoint_ exposed by the proxy after the Thing Description is registered
102
+
- ediTDor appends the encoded Thing/TD identifier to this base URL to fetch or interact with the proxied Thing Description
103
+
- The proxied TD contains HTTP `href`s that ediTDor can invoke
104
+
105
+
In practice, ediTDor always interacts with the Thing **through the proxy via the Northbound URL**, while the Southbound URL is used internally by the proxy to communicate with the actual Thing.
106
+
To use the **_Send TD_** feature, it is necessary to define in the Settings pop-up the Southbound URL and Northbound URL. The Send TD feature allows you to send your Thing Description to any service following the WoT Discovery _Things API_ specification
Afterwards, if the service proxies the TD, ediTDor can fetch the proxied TD containing HTTP `href`s to interact with the original Thing.
91
109
92
110
#### Configuration
93
111
94
112
1. Open the Settings pop-up from the main toolbar
95
-
2. Enter your Southbound URL in the designated field (e.g., `http://localhost:8080`)
96
-
3. Click Save to store the URL
113
+
2. Enter the **Southbound URL** (Things API collection endpoint, e.g. `http://localhost:8080/things/`)
114
+
3. Enter the **Northbound URL** (Things API collection endpoint exposed by the proxy)
115
+
4. Click Save to store the URLs
116
+
117
+
> ⚠️ Important
118
+
> Do **not** paste a full Thing or TD resource URL (e.g. `/things/{id}`).
119
+
> Both Northbound and Southbound URLs must point to the **Things API collection endpoint**
120
+
> (typically ending with `/things/`).
121
+
> ediTDor automatically appends the Thing/TD identifier when sending or fetching data.
97
122
98
123
The proxy uses the TD sent to its southbound API endpoint to communicate with a Thing. This way, you can interact with a non-HTTP Thing from your ediTDor.
0 commit comments