# Ring a klingl
To ring your klingl, you can simply call the following url:
https://klingl.me/now/<alias>
You can find your alias in the klingl.me app. You can copy the whole link for your klingl in your mobile app as well.
The person ringing will get a dialog to confirm the ring. This prevents accidental ringing when people try the link.
# Direct klingl
You can modify the url to avoid the confirmation dialog.
https://klingl.me/now/<alias>?how=direct
# Silent Klingl
You also can silently ring a klingl without getting back the UI. Useful when ringing via low powered devices.
https://klingl.me/now/<alias>?how=silent
# Add Payload
It is possible to add some payload to your klingl request. The payload should be a simple string. Of course you can also send json as payload when formatting to a string.
TIP
You can use a payload in all types of ring request!
Send payload via GET
GET https://klingl.me/now/<alias>?payload=<yourStringPayload>
Send a payload via POST
POST https://klingl.me/now/<alias>
Content-Type: application/json
Body: {"payload":"<yourStringPayload>"}
# Limits
To avoid 'Klinglstreich' we limit requests to a klingl. Be aware to that fact and don't spam the API, or your klingl will be deactivated.