With the Maker Tools
I. Maker sensor
You can use HTTP requests to control your projects on Conrad Connect, the Maker Sensor allows you to trigger projects and react to numerical values sent. Use the sensor 'Maker Numerical' under the "Maker-Tools" category
to send numeric values and use the sensor 'Maker Event'
to trigger the project without numerical checks.
In both cases you must name your HTTP Request (POST) and the sensor with the same event name for them to be matched.
Additionally, with each request, you will need to send in your personal maker KEY: You will find this key at the end the page linked here: Login to Conrad Connect and get or generate your key here:
https://dashboard.conradconnect.de/devices/maker
Please be careful not to share this key with anyone else, otherwise your sensors and data may get compromised. For that reason, you can always generate a new maker key.
The two sensors can be reached through the following URLs:
- for Maker event: https://dashboard.conradconnect.de/api/webhook/maker?key=KEY&event=EVENTNAME
- for Maker numerical (EVENTVALUE is the numeric value that is checked in the sensor, KEY is a Maker-Key, that you get when connecting the Maker Sensor with Conrad Connect on Products & Apps page): https://dashboard.conradconnect.de/api/webhook/maker?key=KEY&event=EVENT&eventValue=EVENTVALUE
In addition, you can also send optional data via the body of your request and then reuse it within the project.
Method: POST / Content Type: application/json Body: {"yourdata ": "hello world"}
Note : If you don't send data with the body, an empty body needs to be sent: Body: {}
.
Example with cURL:
curl -d {} -H "Content-Type: application/json" -X POST "https://dashboard.conradconnect.de/api/webhook/maker?event=EVENT&key=KEY"
{{[MAKERSENSORNAME].parameter}}
e.g. {{[makerSensorEvent_1].yourdata}}
.Those placeholders are then swapped during the execution of the project. So you could for example write a temperature value in an SMS message, or you can define a different email address as a placeholder, which then will be used within the email actuator to send to different recipients.
II. Maker actuator
The other end of the Maker Tools is the Maker Actuator:
This allows you to send HTTP requests to a URL of your choice. Optionally, you can also define a body to be sent along with the request.
Please note that variables from the sensors can only be added to message and body fields and not to other fields.