TETH-4378 - Add SIA consumer API

source/index.html.md

@@ -1898,3 +1898,29 @@ Note: if you'll not pass `return_url` in parameters we'll not display banner at
 | at | query | Timestamp of recording to search | Yes | String |
 | zone | query | Zone ID to find recording in | Yes | String |
 | return_url | query | URL for ability to return from results page | No | String |
+
+# Alarm
+
+## Receiving SIA string
+
+This endpoint receiving SIA requests.
+
+### HTTP Request
+`POST https://my.timeline.is/api/v3/alarms/sia_event`
+
+**Parameters**
+
+| Name      | Located in | Description          | Required | Type   |
+| ----      | ---------- | -----------          | -------- | ----   |
+| sia_event | query/body | string in SIA format | Yes      | String |
+
+```shell
+curl "https://my.timelline.is/api/v3/alarms/sia_event" \
+     --data '{"alarm":{"sia_event":"[#900001|Nti22:02/ri01/BA1001|ABurglary Alarm]"}}' \
+     --request POST \
+     -H "Authorization: Bearer YOUR_OAUTH_TOKEN" \
+     -H "Content-Type: application/json"
+```
+
+> The above command returns 200 status without body
+