2 * Copyright (c) 2010-2022 Contributors to the openHAB project
4 * See the NOTICE file(s) distributed with this work for additional
7 * This program and the accompanying materials are made available under the
8 * terms of the Eclipse Public License 2.0 which is available at
9 * http://www.eclipse.org/legal/epl-2.0
11 * SPDX-License-Identifier: EPL-2.0
13 package org.openhab.binding.netatmo.internal.api;
15 import static org.openhab.binding.netatmo.internal.api.data.NetatmoConstants.*;
18 import java.util.Collection;
19 import java.util.stream.Collectors;
21 import javax.ws.rs.core.UriBuilder;
23 import org.eclipse.jdt.annotation.NonNullByDefault;
24 import org.openhab.binding.netatmo.internal.api.data.NetatmoConstants.FeatureArea;
25 import org.openhab.binding.netatmo.internal.api.data.NetatmoConstants.FloodLightMode;
26 import org.openhab.binding.netatmo.internal.api.dto.Home;
27 import org.openhab.binding.netatmo.internal.api.dto.HomeEvent;
28 import org.openhab.binding.netatmo.internal.api.dto.HomeEvent.NAEventsDataResponse;
29 import org.openhab.binding.netatmo.internal.api.dto.Ping;
30 import org.openhab.binding.netatmo.internal.handler.ApiBridgeHandler;
33 * Base class for all Security related endpoints
35 * @author Gaƫl L'hopital - Initial contribution
38 public class SecurityApi extends RestManager {
39 public SecurityApi(ApiBridgeHandler apiClient) {
40 super(apiClient, FeatureArea.SECURITY);
44 * Dissociates a webhook from a user.
46 * @throws NetatmoException If fail to call the API, e.g. server error or deserializing
48 public void dropWebhook() throws NetatmoException {
49 UriBuilder uriBuilder = getApiUriBuilder(SUB_PATH_DROP_WEBHOOK);
50 post(uriBuilder, ApiResponse.Ok.class, null, null);
54 * Links a callback url to a user.
56 * @param uri Your webhook callback url (required)
57 * @throws NetatmoException If fail to call the API, e.g. server error or deserializing
59 public boolean addwebhook(URI uri) throws NetatmoException {
60 UriBuilder uriBuilder = getApiUriBuilder(SUB_PATH_ADD_WEBHOOK, PARAM_URL, uri.toString());
61 post(uriBuilder, ApiResponse.Ok.class, null, null);
65 public Collection<HomeEvent> getPersonEvents(String homeId, String personId) throws NetatmoException {
66 UriBuilder uriBuilder = getApiUriBuilder(SUB_PATH_GET_EVENTS, PARAM_HOME_ID, homeId, PARAM_PERSON_ID, personId,
68 NAEventsDataResponse response = get(uriBuilder, NAEventsDataResponse.class);
69 BodyResponse<Home> body = response.getBody();
71 Home home = body.getElement();
73 return home.getEvents().stream().filter(event -> personId.equals(event.getPersonId()))
74 .collect(Collectors.toList());
77 throw new NetatmoException("home should not be null");
80 public Collection<HomeEvent> getDeviceEvents(String homeId, String deviceId, String deviceType)
81 throws NetatmoException {
82 UriBuilder uriBuilder = getApiUriBuilder(SUB_PATH_GET_EVENTS, PARAM_HOME_ID, homeId, PARAM_DEVICE_ID, deviceId,
83 PARAM_DEVICES_TYPE, deviceType);
84 BodyResponse<Home> body = get(uriBuilder, NAEventsDataResponse.class).getBody();
86 Home home = body.getElement();
88 return home.getEvents();
91 throw new NetatmoException("home should not be null");
94 public String ping(String vpnUrl) throws NetatmoException {
95 UriBuilder uriBuilder = UriBuilder.fromUri(vpnUrl).path(PATH_COMMAND).path(SUB_PATH_PING);
96 Ping response = get(uriBuilder, Ping.class);
97 return response.getStatus();
100 public void changeStatus(String localCameraURL, boolean setOn) throws NetatmoException {
101 UriBuilder uriBuilder = UriBuilder.fromUri(localCameraURL).path(PATH_COMMAND).path(SUB_PATH_CHANGESTATUS);
102 uriBuilder.queryParam(PARAM_STATUS, setOn ? "on" : "off");
103 post(uriBuilder, ApiResponse.Ok.class, null, null);
106 public void changeFloodLightMode(String homeId, String cameraId, FloodLightMode mode) throws NetatmoException {
107 UriBuilder uriBuilder = getAppUriBuilder(PATH_STATE);
108 String payload = String.format(
109 "{\"home\": {\"id\":\"%s\",\"modules\": [ {\"id\":\"%s\",\"floodlight\":\"%s\"} ]}}", homeId, cameraId,
110 mode.name().toLowerCase());
111 post(uriBuilder, ApiResponse.Ok.class, payload, "application/json;charset=utf-8");
114 public void setPersonAwayStatus(String homeId, String personId, boolean away) throws NetatmoException {
115 UriBuilder uriBuilder = getAppUriBuilder(away ? SUB_PATH_PERSON_AWAY : SUB_PATH_PERSON_HOME);
116 String payload = String.format(
117 away ? "{\"home_id\":\"%s\",\"person_id\":\"%s\"}" : "{\"home_id\":\"%s\",\"person_ids\":[\"%s\"]}",
119 post(uriBuilder, ApiResponse.Ok.class, payload, "application/json;charset=utf-8");