├── 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 | --------------------------------------------------------------------------------