├── LICENSE
└── README.md
/LICENSE:
--------------------------------------------------------------------------------
1 | MIT License
2 |
3 | Copyright (c) 2019 Cebeerre
4 |
5 | Permission is hereby granted, free of charge, to any person obtaining a copy
6 | of this software and associated documentation files (the "Software"), to deal
7 | in the Software without restriction, including without limitation the rights
8 | to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
9 | copies of the Software, and to permit persons to whom the Software is
10 | furnished to do so, subject to the following conditions:
11 |
12 | The above copyright notice and this permission notice shall be included in all
13 | copies or substantial portions of the Software.
14 |
15 | THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
16 | IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
17 | FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
18 | AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
19 | LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
20 | OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
21 | SOFTWARE.
22 |
--------------------------------------------------------------------------------
/README.md:
--------------------------------------------------------------------------------
1 | # General
2 |
3 | Placeholder to document the Securitas Direct API Endpoint used by the mobile apps below:
4 |
5 | - [Android App](https://play.google.com/store/apps/details?id=com.securitasdirect.android.mycontrol&hl=en&gl=US)
6 | - [IOS App](https://play.google.com/store/apps/details?id=com.securitasdirect.android.mycontrol&hl=en&gl=US)
7 |
8 | **_NOTE:_** THIS PROJECT IS NOT IN ANY WAY ASSOCIATED WITH OR RELATED TO THE SECURITAS DIRECT-VERISURE GROUP COMPANIES. The information here and online is for educational and resource purposes only and therefore the developers do not endorse or condone any inappropriate use of it, and take no legal responsibility for the functionality or security of your alarms and devices.
9 |
10 | Special thanks to the [mitmproxy](https://github.com/mitmproxy/mitmproxy) team as all the reverse engineering work required to document this API was done with this great opensource tool.
11 |
12 | Known projects:
13 |
14 | * [Command line client](https://github.com/Cebeerre/VerisureAPIClient)
15 | * [Home Assistant Component](https://github.com/segalion/securitasdirect)
16 | * [WEMO/Belkin Emulation](https://github.com/Cebeerre/VerisureEchoDevice)
17 | * [WIP Homebridge integration](https://github.com/ptz0n/node-verisure/pull/41)
18 | * [Jeedom Plugin](https://github.com/Xav-74/verisure)
19 | * [PHP Fork](https://github.com/kdesroches89/verisure-api-php)
20 |
21 | Securitas Direct does not really use a REST API, it's more a web application that expects variables in a url encoded format, and returns XML documents.
22 |
23 | You should maintain a session using a hash, control (some) queries using IDs, and control the execution in the server querying the log on the endpoint periodically for some calls.
24 |
25 | ```
26 | BASE URL = https://mob2217.securitasdirect.es:12010/WebService/ws.do
27 | ```
28 |
29 | Known supported countries:
30 | * Spain (Country="ES", lang="es")
31 | * Italy (Country="IT", lang="it")
32 | * France (Country="FR", lang="fr")
33 | * UK (Country="GB", lang="en") (only the alarm kit on the [left](https://www.verisure.co.uk/alarms/customer-area.html))
34 | * Portugal (Country="PT", lang="pt")
35 |
36 | Calls and Actions:
37 |
38 | * [Login](#login)
39 | * [Installation Details](#installation-details)
40 | * [SIM Number and INSTIBS](#sim-number-and-instibs)
41 | * [Get Panel Status](#get-panel-status)
42 | * [Arm Alarm System (inside, all sensors)](#arm-alarm-system--inside--all-sensors-)
43 | * [Arm Alarm System (outside, perimeter, all sensors)](#arm-alarm-system--outside--perimeter--all-sensors-)
44 | * [Arm Alarm Nigh/Partial Mode](#arm-alarm-nigh-partial-mode)
45 | * [Arm Alarm Day/Partial Mode](#arm-alarm-day-partial-mode)
46 | * [Disarm Alarm (everything)](#disarm-alarm--everything-)
47 | * [Photo Requests](#photo-requests)
48 | * [Logout](#logout)
49 |
50 | ## Login
51 |
52 | **Call**: `LOGIN`
53 |
54 | **Method**: `POST`
55 |
56 | **Data constraints**
57 |
58 | You should provide:
59 |
60 | ```
61 | {
62 | 'request': 'LOGIN',
63 | 'ID': '[Concatenated string with the device type, the username and a time token, should persist along all the session: AND_________________________vericlient20191029123621]',
64 | 'Country': '[Checked with `ES` for Spain]',
65 | 'lang': '[Checked with `es` for Spain]',
66 | 'user': '[The webpage/app login]',
67 | 'pwd': '[The webpage/app password]'
68 | }
69 | ```
70 |
71 | **Data example**
72 |
73 | ```
74 | https://mob2217.securitasdirect.es:12010/WebService/ws.do?request=LOGIN&ID=AND_________________________vericlient20191029123621&Country=ES&lang=es&user=vericlient&pwd=veripass
75 | ```
76 |
77 | **Success Response**
78 |
79 | Code: 200
80 | Example:
81 |
82 | ```
83 |
84 |
85 | OK
86 | Usuario validado correctamente
87 | ES
88 | 11111111111
89 |
90 | Estamos mejorando nuestros servicios. Por favor intentelo de nuevo mas tarde. Gracias por confiar en Securitas Direct
91 |
92 | ```
93 |
94 | The content of the HASH tag should be used for any further requests, as it's used as a token.
95 |
96 | ## Installation Details
97 |
98 | Usefull to get the sensor IDs and other info related to your installation.
99 |
100 | **Call**: `MYINSTALLATION`
101 |
102 | **Method**: `POST`
103 |
104 | **Data constraints**
105 |
106 | You should provide:
107 |
108 | ```
109 | {
110 | 'request': 'MYINSTALLATION',
111 | 'ID': '[Concatenated string with the device type, the username and a time token, should persist along all the session: AND_________________________vericlient20191029123621]',
112 | 'Country': '[Checked with `es` for Spain]',
113 | 'lang': '[Checked with `ES` for Spain]',
114 | 'user': '[The webpage/app login]',
115 | 'pwd': '[The webpage/app password]',
116 | 'numinst': '[Your installation ID, you can get this from the App/WebPage]'
117 | }
118 | ```
119 |
120 | **Data example**
121 |
122 | ```
123 | https://mob2217.securitasdirect.es:12010/WebService/ws.do?request=MYINSTALLATION&ID=AND_________________________vericlient20191029123621&Country=ES&lang=es&user=vericlient&pwd=veripass
124 | ```
125 |
126 | **Success Response**
127 |
128 | Code: 200
129 | Example:
130 |
131 | ```
132 |
133 |
134 | OK
135 | Petición procesada correctamente
136 |
137 |
138 |
139 |
140 |
141 |
142 |
143 |
144 |
145 |
146 |
147 |
148 |
149 |
150 |
151 |
152 |
153 |
154 |
155 |
156 |
157 |
158 |
159 |
160 |
161 |
162 |
163 |
164 |
165 | ```
166 | ## SIM Number and INSTIBS
167 |
168 | This is usefull in order to get the SIM number. You can straight call this number as long as you're doing it from the allowed numbers to make "silent calls" and listen from the alarm panel.
169 |
170 | You need this call to get the tag value `INSTIBS`. I haven't been able to understand the meaning of this tag, but is mandatory to do photo requests from the sensors.
171 |
172 | **Call**: `SVR`
173 |
174 | **Method**: `GET`
175 |
176 | **Data constraints**
177 |
178 | You should provide:
179 |
180 | ```
181 | {
182 | 'Country': '[Country]',
183 | 'user': '[The webpage/app login]',
184 | 'pwd': '[The webpage/app password]',
185 | 'lang': '[Language]',
186 | 'panel': '[This is your alarm panel, tipically SDVFAST]',
187 | 'numinst': '[Your installation ID, you can get this from the App/WebPage]',
188 | 'request': 'SVR',
189 | 'hash': '[The hash/token that you get back in the XML from doing the Login call]',
190 | 'ID': '[Concatenated string with the device type, the username and a time token, should persist along all the session: AND_________________________vericlient20191029123621]'
191 | }
192 | ```
193 | **Data example**
194 |
195 | ```
196 | https://mob2217.securitasdirect.es:12010/WebService/ws.do?request=SVR&ID=AND_________________________vericlient20191029123621&Country=ES&lang=es&user=vericlient&pwd=veripass&hash=11111111111&panel=SDVFAST&numinst=2423443
197 | ```
198 |
199 | **Success Response**
200 |
201 | Code: 200
202 | Example:
203 |
204 | I've removed the response here, as it generates a huge XML with a lot of garbage.
205 |
206 | Basically, parse the response to get the values from the tags `SIM` and `INSTIBS`
207 |
208 | ## Get Panel Status
209 |
210 | In order to get the panel status, you should first do an `EST1` call, and then loop on `EST2`, till the communication with the panel has finished and you get a `OK`
211 |
212 | **Call**: `EST1`
213 |
214 | **Method**: `GET`
215 |
216 | **Data constraints**
217 |
218 | You should provide:
219 |
220 | ```
221 | {
222 | 'Country': '[Country]',
223 | 'user': '[The webpage/app login]',
224 | 'pwd': '[The webpage/app password]',
225 | 'lang': '[Language]',
226 | 'panel': '[This is your alarm panel, tipically SDVFAST]',
227 | 'numinst': '[Your installation ID, you can get this from the App/WebPage]',
228 | 'request': 'EST1',
229 | 'hash': '[The hash/token that you get back in the XML from doing the Login call]',
230 | 'ID': '[Concatenated string with the device type, the username and a time token, should persist along all the session: AND_________________________vericlient20191029123621]',
231 | 'callby': '[same string used in the device type plus android version: AND_61]'
232 | }
233 | ```
234 |
235 | **Data example**
236 |
237 | ```
238 | https://mob2217.securitasdirect.es:12010/WebService/ws.do?request=EST1&ID=AND_________________________vericlient20191029123621&callby=AND_61&Country=ES&lang=es&user=vericlient&pwd=veripass&hash=11111111111&panel=SDVFAST&numinst=2423443
239 | ```
240 |
241 | **Success Response**
242 |
243 | Code: 200
244 | Example:
245 |
246 | ```
247 |
248 |
249 | OK
250 | Su solicitud ha sido enviada
251 | Estamos mejorando nuestros servicios. Por favor intentelo de nuevo mas tarde. Gracias por confiar en Securitas Direct
252 |
253 | ```
254 |
255 | **Call**: `EST2`
256 |
257 | **Method**: `GET`
258 |
259 | **Data constraints**
260 |
261 | You should provide:
262 |
263 | ```
264 | {
265 | 'Country': '[Country]',
266 | 'user': '[The webpage/app login]',
267 | 'pwd': '[The webpage/app password]',
268 | 'lang': '[Language]',
269 | 'panel': '[This is your alarm panel, tipically SDVFAST]',
270 | 'numinst': '[Your installation ID, you can get this from the App/WebPage]',
271 | 'request': 'EST1',
272 | 'hash': '[The hash/token that you get back in the XML from doing the Login call]',
273 | 'ID': '[Concatenated string with the device type, the username and a time token, should persist along all the session: AND_________________________vericlient20191029123621]',
274 | 'callby': '[same string used in the device type plus android version: AND_61]
275 | }
276 | ```
277 |
278 | **Data example**
279 |
280 | ```
281 | https://mob2217.securitasdirect.es:12010/WebService/ws.do?request=EST2&ID=AND_________________________vericlient20191029123621&callby=AND_61&Country=ES&lang=es&user=vericlient&pwd=veripass&hash=11111111111&panel=SDVFAST&numinst=2423443
282 | ```
283 |
284 | **Success Response**
285 |
286 | Code: 200
287 | Example:
288 |
289 | ```
290 |
291 |
292 | OK
293 | 0
294 | Tu Alarma está desconectada
295 | 2423443
296 | Estamos mejorando nuestros servicios. Por favor intentelo de nuevo mas tarde. Gracias por confiar en Securitas Direct
297 |
298 | ```
299 |
300 | ## Arm Alarm System (inside, all sensors)
301 |
302 | In order to get arm the panel, you should first do an `ARM1` call, and then loop on `ARM2`, till the communication with the panel has finished and you get a `OK`
303 |
304 | **Call**: `ARM1`
305 |
306 | **Method**: `GET`
307 |
308 | **Data constraints**
309 |
310 | You should provide:
311 |
312 | ```
313 | {
314 | 'Country': '[Country]',
315 | 'user': '[The webpage/app login]',
316 | 'pwd': '[The webpage/app password]',
317 | 'lang': '[Language]',
318 | 'panel': '[This is your alarm panel, tipically SDVFAST]',
319 | 'numinst': '[Your installation ID, you can get this from the App/WebPage]',
320 | 'request': 'ARM1',
321 | 'hash': '[The hash/token that you get back in the XML from doing the Login call]',
322 | 'ID': '[Concatenated string with the device type, the username and a time token, should persist along all the session: AND_________________________vericlient20191029123621]',
323 | 'callby': '[same string used in the device type plus android version: AND_61]
324 | }
325 | ```
326 |
327 | **Data example**
328 |
329 | ```
330 | https://mob2217.securitasdirect.es:12010/WebService/ws.do?request=ARM1&ID=AND_________________________vericlient20191029123621&callby=AND_61&Country=ES&lang=es&user=vericlient&pwd=veripass&hash=11111111111&panel=SDVFAST&numinst=2423443
331 | ```
332 |
333 | **Success Response**
334 |
335 | Code: 200
336 | Example:
337 |
338 | ```
339 |
340 |
341 | OK
342 | Su solicitud ha sido enviada
343 | Estamos mejorando nuestros servicios. Por favor intentelo de nuevo mas tarde. Gracias por confiar en Securitas Direct
344 |
345 | ```
346 |
347 | **Call**: `ARM2`
348 |
349 | **Method**: `GET`
350 |
351 | **Data constraints**
352 |
353 | You should provide:
354 |
355 | ```
356 | {
357 | 'Country': '[Country]',
358 | 'user': '[The webpage/app login]',
359 | 'pwd': '[The webpage/app password]',
360 | 'lang': '[Language]',
361 | 'panel': '[This is your alarm panel, tipically SDVFAST]',
362 | 'numinst': '[Your installation ID, you can get this from the App/WebPage]',
363 | 'request': 'ARM2',
364 | 'hash': '[The hash/token that you get back in the XML from doing the Login call]',
365 | 'ID': '[Concatenated string with the device type, the username and a time token, should persist along all the session: AND_________________________vericlient20191029123621]',
366 | 'callby': '[same string used in the device type plus android version: AND_61]
367 | }
368 | ```
369 |
370 | **Data example**
371 |
372 | ```
373 | https://mob2217.securitasdirect.es:12010/WebService/ws.do?request=ARM1&ID=AND_________________________vericlient20191029123621&callby=AND_61&Country=ES&lang=es&user=vericlient&pwd=veripass&hash=11111111111&panel=SDVFAST&numinst=2423443
374 | ```
375 |
376 | **Success Response**
377 |
378 | Code: 200
379 | Example:
380 |
381 | ```
382 |
383 |
384 | OK
385 | 4
386 | Tu Alarma está conectada en modo Total y en el exterior
387 | 2423443
388 | Estamos mejorando nuestros servicios. Por favor intentelo de nuevo mas tarde. Gracias por confiar en Securitas Direct
389 |
390 | ```
391 |
392 | ## Arm Alarm System (outside, perimeter, all sensors)
393 |
394 | In order to get arm the panel, you should first do an `PERI1` call, and then loop on `PERI2`, till the communication with the panel has finished and you get a `OK`
395 |
396 | **Call**: `PERI1`
397 |
398 | **Method**: `GET`
399 |
400 | **Data constraints**
401 |
402 | You should provide:
403 |
404 | ```
405 | {
406 | 'Country': '[Country]',
407 | 'user': '[The webpage/app login]',
408 | 'pwd': '[The webpage/app password]',
409 | 'lang': '[Language]',
410 | 'panel': '[This is your alarm panel, tipically SDVFAST]',
411 | 'numinst': '[Your installation ID, you can get this from the App/WebPage]',
412 | 'request': 'PERI1',
413 | 'hash': '[The hash/token that you get back in the XML from doing the Login call]',
414 | 'ID': '[Concatenated string with the device type, the username and a time token, should persist along all the session: AND_________________________vericlient20191029123621]',
415 | 'callby': '[same string used in the device type plus android version: AND_61]
416 | }
417 | ```
418 |
419 | **Data example**
420 |
421 | ```
422 | https://mob2217.securitasdirect.es:12010/WebService/ws.do?request=PERI1&ID=AND_________________________vericlient20191029123621&Country=ES&lang=es&user=vericlient&pwd=veripass&hash=11111111111&panel=SDVFAST&numinst=2423443
423 | ```
424 |
425 | **Success Response**
426 |
427 | Code: 200
428 | Example:
429 |
430 | ```
431 |
432 |
433 | OK
434 | Su solicitud ha sido enviada
435 | Estamos mejorando nuestros servicios. Por favor intentelo de nuevo mas tarde. Gracias por confiar en Securitas Direct
436 |
437 | ```
438 |
439 | **Call**: `PERI2`
440 |
441 | **Method**: `GET`
442 |
443 | **Data constraints**
444 |
445 | You should provide:
446 |
447 | ```
448 | {
449 | 'Country': '[Country]',
450 | 'user': '[The webpage/app login]',
451 | 'pwd': '[The webpage/app password]',
452 | 'lang': '[Language]',
453 | 'panel': '[This is your alarm panel, tipically SDVFAST]',
454 | 'numinst': '[Your installation ID, you can get this from the App/WebPage]',
455 | 'request': 'PERI2',
456 | 'hash': '[The hash/token that you get back in the XML from doing the Login call]',
457 | 'ID': '[Concatenated string with the device type, the username and a time token, should persist along all the session: AND_________________________vericlient20191029123621]',
458 | 'callby': '[same string used in the device type plus android version: AND_61]
459 | }
460 | ```
461 |
462 | **Data example**
463 |
464 | ```
465 | https://mob2217.securitasdirect.es:12010/WebService/ws.do?request=PERI2&ID=AND_________________________vericlient20191029123621&callby=AND_61&Country=ES&lang=es&user=vericlient&pwd=veripass&hash=11111111111&panel=SDVFAST&numinst=2423443
466 | ```
467 |
468 | **Success Response**
469 |
470 | Code: 200
471 | Example:
472 |
473 | ```
474 |
475 |
476 | OK
477 | 0
478 | Tu Alarma está conectada en modo Total y en el exterior
479 | 2423443
480 | Estamos mejorando nuestros servicios. Por favor intentelo de nuevo mas tarde. Gracias por confiar en Securitas Direct
481 |
482 | ```
483 |
484 | ## Arm Alarm Nigh/Partial Mode
485 |
486 | In order to get arm the panel, you should first do an `ARMNIGHT1` call, and then loop on `ARMNIGHT2`, till the communication with the panel has finished and you get a `OK`
487 |
488 | **Call**: `ARMNIGHT1`
489 |
490 | **Method**: `GET`
491 |
492 | **Data constraints**
493 |
494 | You should provide:
495 |
496 | ```
497 | {
498 | 'Country': '[Country]',
499 | 'user': '[The webpage/app login]',
500 | 'pwd': '[The webpage/app password]',
501 | 'lang': '[Language]',
502 | 'panel': '[This is your alarm panel, tipically SDVFAST]',
503 | 'numinst': '[Your installation ID, you can get this from the App/WebPage]',
504 | 'request': 'ARMNIGHT1',
505 | 'hash': '[The hash/token that you get back in the XML from doing the Login call]',
506 | 'ID': '[Concatenated string with the device type, the username and a time token, should persist along all the session: AND_________________________vericlient20191029123621]',
507 | 'callby': '[same string used in the device type plus android version: AND_61]
508 | }
509 | ```
510 |
511 | **Data example**
512 |
513 | ```
514 | https://mob2217.securitasdirect.es:12010/WebService/ws.do?request=ARMNIGHT1&ID=AND_________________________vericlient20191029123621&callby=AND_61&Country=ES&lang=es&user=vericlient&pwd=veripass&hash=11111111111&panel=SDVFAST&numinst=2423443
515 | ```
516 |
517 | **Success Response**
518 |
519 | Code: 200
520 | Example:
521 |
522 | ```
523 |
524 |
525 | OK
526 | Su solicitud ha sido enviada
527 | Estamos mejorando nuestros servicios. Por favor intentelo de nuevo mas tarde. Gracias por confiar en Securitas Direct
528 |
529 | ```
530 |
531 | **Call**: `ARMNIGHT2`
532 |
533 | **Method**: `GET`
534 |
535 | **Data constraints**
536 |
537 | You should provide:
538 |
539 | ```
540 | {
541 | 'Country': '[Country]',
542 | 'user': '[The webpage/app login]',
543 | 'pwd': '[The webpage/app password]',
544 | 'lang': '[Language]',
545 | 'panel': '[This is your alarm panel, tipically SDVFAST]',
546 | 'numinst': '[Your installation ID, you can get this from the App/WebPage]',
547 | 'request': 'ARMNIGHT2',
548 | 'hash': '[The hash/token that you get back in the XML from doing the Login call]',
549 | 'ID': '[Concatenated string with the device type, the username and a time token, should persist along all the session: AND_________________________vericlient20191029123621]',
550 | 'callby': '[same string used in the device type plus android version: AND_61]
551 | }
552 | ```
553 |
554 | **Data example**
555 |
556 | ```
557 | https://mob2217.securitasdirect.es:12010/WebService/ws.do?request=ARMNIGHT2&ID=AND_________________________vericlient20191029123621&callby=AND_61&Country=ES&lang=es&user=vericlient&pwd=veripass&hash=11111111111&panel=SDVFAST&numinst=2423443
558 | ```
559 |
560 | **Success Response**
561 |
562 | Code: 200
563 | Example:
564 |
565 | ```
566 |
567 |
568 | OK
569 | 0
570 | Tu Alarma está conectada en modo Noche
571 | 2423443
572 | Estamos mejorando nuestros servicios. Por favor intentelo de nuevo mas tarde. Gracias por confiar en Securitas Direct
573 |
574 | ```
575 |
576 | ## Arm Alarm Day/Partial Mode
577 |
578 | In order to get arm the panel, you should first do an `ARMDAY1` call, and then loop on `ARMDAY2`, till the communication with the panel has finished and you get a `OK`
579 |
580 | **Call**: `ARMDAY1`
581 |
582 | **Method**: `GET`
583 |
584 | **Data constraints**
585 |
586 | You should provide:
587 |
588 | ```
589 | {
590 | 'Country': '[Country]',
591 | 'user': '[The webpage/app login]',
592 | 'pwd': '[The webpage/app password]',
593 | 'lang': '[Language]',
594 | 'panel': '[This is your alarm panel, tipically SDVFAST]',
595 | 'numinst': '[Your installation ID, you can get this from the App/WebPage]',
596 | 'request': 'ARMDAY1',
597 | 'hash': '[The hash/token that you get back in the XML from doing the Login call]',
598 | 'ID': '[Concatenated string with the device type, the username and a time token, should persist along all the session: AND_________________________vericlient20191029123621]',
599 | 'callby': '[same string used in the device type plus android version: AND_61]
600 | }
601 | ```
602 |
603 | **Data example**
604 |
605 | ```
606 | https://mob2217.securitasdirect.es:12010/WebService/ws.do?request=ARMDAY1&ID=AND_________________________vericlient20191029123621&callby=AND_61&Country=ES&lang=es&user=vericlient&pwd=veripass&hash=11111111111&panel=SDVFAST&numinst=2423443
607 | ```
608 |
609 | **Success Response**
610 |
611 | Code: 200
612 | Example:
613 |
614 | ```
615 |
616 |
617 | OK
618 | Su solicitud ha sido enviada
619 | Estamos mejorando nuestros servicios. Por favor intentelo de nuevo mas tarde. Gracias por confiar en Securitas Direct
620 |
621 | ```
622 |
623 | **Call**: `ARMDAY2`
624 |
625 | **Method**: `GET`
626 |
627 | **Data constraints**
628 |
629 | You should provide:
630 |
631 | ```
632 | {
633 | 'Country': '[Country]',
634 | 'user': '[The webpage/app login]',
635 | 'pwd': '[The webpage/app password]',
636 | 'lang': '[Language]',
637 | 'panel': '[This is your alarm panel, tipically SDVFAST]',
638 | 'numinst': '[Your installation ID, you can get this from the App/WebPage]',
639 | 'request': 'ARMDAY2',
640 | 'hash': '[The hash/token that you get back in the XML from doing the Login call]',
641 | 'ID': '[Concatenated string with the device type, the username and a time token, should persist along all the session: AND_________________________vericlient20191029123621]',
642 | 'callby': '[same string used in the device type plus android version: AND_61]
643 | }
644 | ```
645 |
646 | **Data example**
647 |
648 | ```
649 | https://mob2217.securitasdirect.es:12010/WebService/ws.do?request=ARMDAY2&ID=AND_________________________vericlient20191029123621&callby=AND_61&Country=ES&lang=es&user=vericlient&pwd=veripass&hash=11111111111&panel=SDVFAST&numinst=2423443
650 | ```
651 |
652 | **Success Response**
653 |
654 | Code: 200
655 | Example:
656 |
657 | ```
658 |
659 |
660 | OK
661 | 0
662 | Tu Alarma está conectada en modo Noche
663 | 2423443
664 | Estamos mejorando nuestros servicios. Por favor intentelo de nuevo mas tarde. Gracias por confiar en Securitas Direct
665 |
666 | ```
667 |
668 | ## Disarm Alarm (everything)
669 |
670 | In order to get arm the panel, you should first do an `DARM1` call, and then loop on `DARM2`, till the communication with the panel has finished and you get a `OK`
671 |
672 | **Call**: `DARM1`
673 |
674 | **Method**: `GET`
675 |
676 | **Data constraints**
677 |
678 | You should provide:
679 |
680 | ```
681 | {
682 | 'Country': '[Country]',
683 | 'user': '[The webpage/app login]',
684 | 'pwd': '[The webpage/app password]',
685 | 'lang': '[Language]',
686 | 'panel': '[This is your alarm panel, tipically SDVFAST]',
687 | 'numinst': '[Your installation ID, you can get this from the App/WebPage]',
688 | 'request': 'DARM1',
689 | 'hash': '[The hash/token that you get back in the XML from doing the Login call]',
690 | 'ID': '[Concatenated string with the device type, the username and a time token, should persist along all the session: AND_________________________vericlient20191029123621]',
691 | 'callby': '[same string used in the device type plus android version: AND_61]
692 | }
693 | ```
694 |
695 | **Data example**
696 |
697 | ```
698 | https://mob2217.securitasdirect.es:12010/WebService/ws.do?request=DARM1&ID=AND_________________________vericlient20191029123621&callby=AND_61&Country=ES&lang=es&user=vericlient&pwd=veripass&hash=11111111111&panel=SDVFAST&numinst=2423443
699 | ```
700 |
701 | **Success Response**
702 |
703 | Code: 200
704 | Example:
705 |
706 | ```
707 |
708 |
709 | OK
710 | Su solicitud ha sido enviada
711 | Estamos mejorando nuestros servicios. Por favor intentelo de nuevo mas tarde. Gracias por confiar en Securitas Direct
712 |
713 | ```
714 |
715 | **Call**: `DARM2`
716 |
717 | **Method**: `GET`
718 |
719 | **Data constraints**
720 |
721 | You should provide:
722 |
723 | ```
724 | {
725 | 'Country': '[Country]',
726 | 'user': '[The webpage/app login]',
727 | 'pwd': '[The webpage/app password]',
728 | 'lang': '[Language]',
729 | 'panel': '[This is your alarm panel, tipically SDVFAST]',
730 | 'numinst': '[Your installation ID, you can get this from the App/WebPage]',
731 | 'request': 'DARM2',
732 | 'hash': '[The hash/token that you get back in the XML from doing the Login call]',
733 | 'ID': '[Concatenated string with the device type, the username and a time token, should persist along all the session: AND_________________________vericlient20191029123621]',
734 | 'callby': '[same string used in the device type plus android version: AND_61]
735 | }
736 | ```
737 |
738 | **Data example**
739 |
740 | ```
741 | https://mob2217.securitasdirect.es:12010/WebService/ws.do?request=DARM2&ID=AND_________________________vericlient20191029123621&callby=AND_61&Country=ES&lang=es&user=vericlient&pwd=veripass&hash=11111111111&panel=SDVFAST&numinst=2423443
742 | ```
743 |
744 | **Success Response**
745 |
746 | Code: 200
747 | Example:
748 |
749 | ```
750 |
751 |
752 | OK
753 | 0
754 | Tu Alarma ha sido desconectada
755 | 2423443
756 | Estamos mejorando nuestros servicios. Por favor intentelo de nuevo mas tarde. Gracias por confiar en Securitas Direct
757 |
758 | ```
759 |
760 | ## Photo Requests
761 |
762 | In order to make photo requests and download the pictures, you should first call `IMG1` and as the previous panel interactions, loop through `IMG2` till you get a successful response. Once confirmed, you can get the pictures calling `INF` which will return 3 pictures inside 3 XML tags encoded in BASE64.
763 |
764 | Before calling `INF`, you should call `ACT_V2` till you see an entry saying that the pictures are available. From this response, you should get the values in the tags `idsignal` and `signaltype` as you'll need them then to call `INF`.
765 |
766 | **Call**: `IMG1`
767 |
768 | **Method**: `GET`
769 |
770 | **Data constraints**
771 |
772 | You should provide:
773 |
774 | ```
775 | {
776 | 'Country': '[Country]',
777 | 'user': '[The webpage/app login]',
778 | 'pwd': '[The webpage/app password]',
779 | 'lang': '[Language]',
780 | 'panel': '[This is your alarm panel, tipically SDVFAST]',
781 | 'numinst': '[Your installation ID, you can get this from the App/WebPage]',
782 | 'request': 'IMG1',
783 | 'idservice': '[Seems a constant, in my case is '1' got from MYINSTALLATION],
784 | 'instibs': '[You get this from the SVR call as mentioned previously]',
785 | 'device': '[ID from the device (idDev), you get this calling MYINSTALLATION]',
786 | 'hash': '[The hash/token that you get back in the XML from doing the Login call]',
787 | 'ID': '[Concatenated string with the device type, the username and a time token, should persist along all the session: AND_________________________vericlient20191029123621]',
788 | 'callby': '[same string used in the device type plus android version: AND_61]
789 | }
790 | ```
791 |
792 | **Data example**
793 |
794 | ```
795 | https://mob2217.securitasdirect.es:12010/WebService/ws.do?request=IMG1&idservice=1&instibs=34342342&device=1&ID=AND_________________________vericlient20191029123621&callby=AND_61&Country=ES&lang=es&user=vericlient&pwd=veripass&hash=11111111111&panel=SDVFAST&numinst=2423443
796 | ```
797 |
798 | **Success Response**
799 |
800 | Code: 200
801 | Example:
802 |
803 | ```
804 | text
805 | text
806 | text OK
807 | text 0
808 | text La secuencia de imágenes ha sido tomada. En unos minutos podrás visualizarlas desde tu web de cliente, en tu correo electrónico o en la aplicación My Verisure.
809 | text Estamos mejorando nuestros servicios. Por favor intentelo de nuevo mas tarde. Gracias por confiar en Securitas Direct
810 | text
811 | ```
812 |
813 | **Call**: `IMG2`
814 |
815 | **Method**: `GET`
816 |
817 | **Data constraints**
818 |
819 | You should provide:
820 |
821 | ```
822 | {
823 | 'Country': '[Country]',
824 | 'user': '[The webpage/app login]',
825 | 'pwd': '[The webpage/app password]',
826 | 'lang': '[Language]',
827 | 'panel': '[This is your alarm panel, tipically SDVFAST]',
828 | 'numinst': '[Your installation ID, you can get this from the App/WebPage]',
829 | 'request': 'IMG2',
830 | 'idservice': '[Seems a constant, in my case is '1' got from MYINSTALLATION],
831 | 'instibs': '[You get this from the SVR call as mentioned previously]',
832 | 'device': '[ID from the device (idDev), you get this calling MYINSTALLATION]',
833 | 'hash': '[The hash/token that you get back in the XML from doing the Login call]',
834 | 'ID': '[Concatenated string with the device type, the username and a time token, should persist along all the session: AND_________________________vericlient20191029123621]',
835 | 'callby': '[same string used in the device type plus android version: AND_61]
836 | }
837 | ```
838 |
839 | **Data example**
840 |
841 | ```
842 | https://mob2217.securitasdirect.es:12010/WebService/ws.do?request=IMG2&idservice=1&instibs=34342342&device=1&ID=AND_________________________vericlient20191029123621&callby=AND_61&Country=ES&lang=es&user=vericlient&pwd=veripass&hash=11111111111&panel=SDVFAST&numinst=2423443
843 | ```
844 |
845 | **Success Response**
846 |
847 | Code: 200
848 | Example:
849 |
850 | ```
851 |
852 |
853 | OK
854 | 0
855 | La secuencia de imágenes ha sido tomada. En unos minutos podrás visualizarlas desde tu web de cliente, en tu correo electrónico o en la aplicación My Verisure.
856 | Estamos mejorando nuestros servicios. Por favor intentelo de nuevo mas tarde. Gracias por confiar en Securitas Direct
857 |
858 | ```
859 |
860 | **Call**: `INF`
861 |
862 | **Method**: `GET`
863 |
864 | **Data constraints**
865 |
866 | You should provide:
867 |
868 | ```
869 | {
870 | 'Country': '[Country]',
871 | 'user': '[The webpage/app login]',
872 | 'pwd': '[The webpage/app password]',
873 | 'lang': '[Language]',
874 | 'panel': '[This is your alarm panel, tipically SDVFAST]',
875 | 'numinst': '[Your installation ID, you can get this from the App/WebPage]',
876 | 'request': 'INF',
877 | 'idsignal': '[You can get this from ACT_V2 after a successful IMG2],
878 | 'signaltype': '[You can get this from ACT_V2 after a successful IMG2]',
879 | 'hash': '[The hash/token that you get back in the XML from doing the Login call]',
880 | 'ID': '[Concatenated string with the device type, the username and a time token, should persist along all the session: AND_________________________vericlient20191029123621]',
881 | 'callby': '[same string used in the device type plus android version: AND_61]
882 | }
883 | ```
884 | **Data example**
885 |
886 | ```
887 | https://mob2217.securitasdirect.es:12010/WebService/ws.do?request=INF&idsignal=1234&signaltype=1234&ID=AND_________________________vericlient20191029123621&callby=AND_61&Country=ES&lang=es&user=vericlient&pwd=veripass&hash=11111111111&panel=SDVFAST&numinst=2423443
888 | ```
889 |
890 | **Success Response**
891 |
892 | Code: 200
893 | Example:
894 |
895 | ```
896 |
897 |
898 | OK
899 |
900 |
901 |
BASE64
902 |
BASE64
903 |
BASE64
904 |
905 |
906 | Estamos mejorando nuestros servicios. Por favor intentelo de nuevo mas tarde. Gracias por confiar en Securitas Direct
907 |
908 | ```
909 |
910 | ## Logout
911 |
912 | **Call**: `CLS`
913 |
914 | **Method**: `GET`
915 |
916 | **Data constraints**
917 |
918 | You should provide:
919 |
920 | ```
921 | {
922 | 'Country': '[Country]',
923 | 'user': '[The webpage/app login]',
924 | 'pwd': '[The webpage/app password]',
925 | 'lang': '[Language]',
926 | 'numinst': '(null)',
927 | 'request': 'CLS',
928 | 'hash': '[The hash/token that you get back in the XML from doing the Login call]',
929 | 'ID': '[Concatenated string with the device type, the username and a time token, should persist along all the session: AND_________________________vericlient20191029123621]'
930 | }
931 | ```
932 |
933 | **Data example**
934 |
935 | ```
936 | https://mob2217.securitasdirect.es:12010/WebService/ws.do?request=CLS&ID=AND_________________________vericlient20191029123621&Country=ES&lang=es&user=vericlient&pwd=veripass&hash=11111111111&numinst=
937 | ```
938 |
939 | **Success Response**
940 |
941 | Code: 200
942 | Example:
943 |
944 | ```
945 |
946 |
947 | OK
948 | Mensaje de cierre de session
949 | Estamos mejorando nuestros servicios. Por favor intentelo de nuevo mas tarde. Gracias por confiar en Securitas Direct
950 |
951 | ```
952 |
--------------------------------------------------------------------------------