ewelink-api-java

KO | EN

gitlite — search

#hacktoberfest #react #typescript #llm #go #deep-learning #linux #docker #awesome #cli #awesome-list #pytorch #security #openai

ewelink-api-java

(★ 18)

Java Api for the Sonoff ewelink

ewelink-api-java Latest Version Download

Download Latest Version (.zip)

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

# ewelink-api-java
> eWeLink API written in JAVA

** 3.3.3-RELEASE ** BREAKING CHANGES prior V2.X.X nolonger working due to ewelik api changes

Import
```xml
    <dependency>
      <groupId>com.github.realzimboguy.ewelink.api</groupId>
      <artifactId>ewelink-api-java</artifactId>
      <version>3.3.3-RELEASE</version>
    </dependency>
```

Usage

Please refer to the Below example, note these are the same details you would login to from the mobile app.
if you get an error on ie "eu" region, try "us" region.

Params for the EWeLink Constructor
- region eg us/eu
- username
- password
- country code **NEW** 
- interval in Minutes for re-login eg, if the api was last called more than 60 min ago, it will perform a login before executing the command.

You must perform a login before calling any other methods, the methods exposed are:

Homepage is the base endpoint that returns all the information about your account, devices, scenes, timers etc.
```java
    public void login() throws Exception

public FamilyPage getFamily() throws Exception

public List<Thing> getThings() throws Exception

//use the getFamily() to find the family IDs 
    public List<Thing> getThings(String familyId) throws Exception

public boolean setDeviceStatus(String deviceId, String status) throws Exception

public boolean setDeviceStatusByName(String name, String status) throws Exception

//ie. used for TX2CH devices
    public boolean setMultiDeviceStatus(String deviceId, List<OutletSwitch> outletSwitches) throws Exception
```
sample 
```java
        Gson gson = new Gson();
        EweLink eweLink = new EweLink("eu", "test@gmail.com", "test", "+263",60);

try {
            eweLink.login();

List<Thing> things = eweLink.getThings();

logger.info("PRINT DEVICE_ID, NAME, ONLINE, SWITCH, VOLTAGE");
            for (Thing thing : things) {
                logger.info("{}, {}, {}, {}, {}",
                        thing.getItemData().getDeviceid() ,
                        thing.getItemData().getName() ,
                        thing.getItemData().getOnline(),
                        thing.getItemData().getParams().getSwitch(),
                        thing.getItemData().getParams().getVoltage());
            }
            logger.info("PRINT JSON OBJECTS");
            for (Thing thing : things) {
                logger.info("{} ",gson.toJson(thing));
            }

eweLink.getWebSocket(new WssResponse() {

@Override
                public void onMessage(String s) {
                    //if you want the raw json data
                    System.out.println("on message in test raw:" + s);

}

@Override
                public void onMessageParsed(WssRspMsg rsp) {

if (rsp.getError() == null) {

//normal scenario
                        StringBuilder sb = new StringBuilder();
                        sb.append("Device:").append(rsp.getDeviceid()).append(" - ");
                        if (rsp.getParams() != null) {
                            sb.append("Switch:").append(rsp.getParams().getSwitch()).append(" - ");
                            sb.append("Voltage:").append(rsp.getParams().getVoltage()).append(" - ");
                            sb.append("Power:").append(rsp.getParams().getPower()).append(" - ");
                            sb.append("Current:").append(rsp.getParams().getCurrent()).append(" - ");
                        }

System.out.println(sb.toString());

} else if (rsp.getError() == 0) {
                        //this is from a login response
                        System.out.println("login success");
                    } else if (rsp.getError() > 0) {
                        System.out.println("login error:" + rsp.toString());
                    }
                }

@Override
                public void onError(String error) {
                    System.out.println("onError in test, this should never be called");
                    System.out.println(error);

}
            });

Thread.sleep(10000);
            System.out.println(eweLink.setDeviceStatus("1000f40d35", "on"));
            Thread.sleep(5000);
            System.out.println(eweLink.setDeviceStatus("1000f40d35", "off"));

} catch (Exception e) {
            e.printStackTrace();
        }
```
tags: 
sonoff eweelink api automation java code library

ewelink-api-java

ewelink-api-java Latest Version Download

Today's picks

Was this content helpful?

Recent Feedback

ewelink-api-java

ewelink-api-java Latest Version Download

Today's picks

Was this content helpful?

Recent Feedback

Download README