Miele@home, miele@mobile component

Giovanni85 · December 14, 2023, 3:01am

Use developer tools>states?

mundschenk-at · December 14, 2023, 7:28am

Well, not to defend their software stack, but at least they have an official 3rd-party API (though I would prefer documentation for their local protocol), and the machines themselves are well-built.

selfmade · December 15, 2023, 7:34pm

Hello,

these are the program IDs of the Miele WWP 760 TwinDos.

Can I also access the machine’s extras?
I didn’t find anything about this on the API page. Are there any solutions here?


Program		programId		
"Express 20"		122
"Dunkles/Jeans"	123
"ECO 40-60 "		190
"Imprägnieren"		27
"Oberhemden"		23
"Seide "			9
"Wolle "		8
"Feinwäsche"		4
"Pflegeleicht"		3
"Baumwolle"		1
"Outdoor"		37
"Sportwäsche"		29
"Automatic plus"	31
"Nur Spülen/Stärken"	52
"Pumpen/Schleudern"	21
"Maschine reinigen"	91

mundschenk-at · December 15, 2023, 10:52pm

If by “API page” you mean Miele’s Swagger site (where you can log in with your actual credentials and see the response for your devices), no there is no solution. What you see there is all you get.

selfmade · December 16, 2023, 4:05pm

ok, I’ve seen a few things and also how I get my ProgramID’s. But no example of the possibility of sending the temperature.

If I take other examples on the Swagger side, e.g. of an oven or whatever, I see that you can set different actions.

Does this work with washing machines too?

Best example:
I need to remotely start my washing machine.
I need a colored wash at 40° and at the end I would like to have it pre-ironed with steam.

In addition to the program ID, do I also have to send the temperature, start time and the extra pre-ironing?
is that possible?

mundschenk-at · December 16, 2023, 4:09pm

Forget about the examples, authorize with your credentials and use the “Try it out” button.

selfmade · December 16, 2023, 4:13pm

thats the result what i get on swagger-side with my deviceId

curl -X 'PUT' \
  'https://api.mcs3.miele.com/v1/devices/000187069553/programs' \
  -H 'accept: */*' \
  -H 'Content-Type: application/json' \
  -d '{
  "programId": 133
}'

Are you now telling me that I can only send program IDs and not start times and temperatures? and certainly no extra programs like Iron-Steam?

please, thats not true or?

selfmade · December 16, 2023, 4:17pm

maybe i misunderstood you , sorry
if i use node-red on my HAOS instalation, sure i use the credentials and log in and get my token too… but on miele swagger side… i don’t need it to log in… i think i do anything wrong

edit.
thats too what i get on the swagger side if i put my deviceId for start a program

[https://api.mcs3.miele.com/v1/devices/000187069553/programs)]

Code	Details
Undocumented
Failed to fetch.
Possible Reasons:

CORS
Network Failure
URL scheme must be "http" or "https" for CORS request.

if i send any programID, start then the wash-machine automaticly?
i can not send any starttime?
and temperature?
of course i have to send some temperature… if not then the api not work…

mundschenk-at · December 16, 2023, 4:46pm

At the top of Miele 3rd Party API - Get started is an “Authorize” button. Once you do that, you can try out API calls with the “Try it out” button directly on the page. No need for curl calls from your machine.

selfmade · December 16, 2023, 4:53pm

oh my god, sorry, i never see that BIG button.
ok now i logged in by username/Password already… is better to logged in by bearer because maybe i can use my actualy node-red- miele-bearer

okay… sorry for all my stupid questions… now i see a little clearer the swagger-side

I’m sitting here and I’m really ashamed right now

selfmade · December 16, 2023, 5:55pm

@mundschenk-at
I just want to make sure I tested everything correctly:

Is it correct when I see under miele-swagger that none of my washing machine actions are supported and probably no start time, that this is actually the case?

What I currently see there is:
Washing machines probably only support programid’s and you can’t even enter a temperature

is it correct?

I think that I have a normal Miele washing machine and that others must have the same problem

Is that correct?

edit:
sorrry if i ask so directly but i can’t believ it now that all what i can use is only the programid…

mundschenk-at · December 16, 2023, 6:09pm

Well, probably. It might depend on the state of the washing machine (e.g. whether you enabled MobileStart) and also on the specific model

If you can get something to work with the Swagger UI, @astrandb can potentially implement in the integration. If you can’t, you might be doing something wrong or it might be impossible. Without owning the specific model, no one can rule out one or the other.

selfmade · December 16, 2023, 6:30pm

exactly that i have to ask you again, sorry… but i have to ask and understood this.
Because i can’t belive my washmachine understood only the programID… because now looks like that

if that true… sure i call 100 times to Miele , i don’t have a problem with this and ask so long i get a answere why i can start ALL with my Miele-app and in the Miele-3thrd-Party app what use the same same cloud and maybe the same gateway and all, i can only use the programmid… and mybe ist it only a BIG-Miele Joke

i’m logged in in the swagger-side
all locks are closed (looks good)
all what i get now on the miele-swaggger-side is now from my machine (sometimes i have to put in the deviceID)

the result what i get is:
only programmID looks like works fine
all other , startime, steam-iron or temperature not work… i get different errors

i have now a actually WWP 760 Miele, and i think some others have same same… or is there big different from washmachine to Washmachine?

and of course… yes my machine is in mobilestart-mode !

astrandb · December 16, 2023, 6:36pm

The /actions endpoint i the key to what can be done or not. If the entries are empty or false the API will not accept command/settings. So set the machine to different states and check the endpoint. If it indicates that a setting is accepted and there is no obvious way to do it in the integration, then please report it here or preferably on GitHub.

selfmade · December 16, 2023, 6:43pm

aaah, okay,
thats mean
if i send any setting to the machine like temperature the machine will only accept a complete setting like, startime, temperature and programId ?

and if this not work, then i have to report it by Github… is that right?
that is not a problem … i do this
and for you is It possible to clear that? with Miele?
edit
i ask, because i have then to protocol and report that all…

astrandb · December 16, 2023, 7:08pm

Set the machine to a state that seems logical, e.g. power on and mobile start. Then look in Swagger what the resonse is on the /actions endpoint.

This is an example of a response where the API will accept only a command:to change the device name and nothing else.

{
        "processAction": [],
        "light": [],
        "ambientLight": [],
        "startTime": [],
        "ventilationStep": [],
        "programId": [],
        "targetTemperature": [],
        "deviceName": true,
        "powerOn": false,
        "powerOff": false,
        "colors": [],
        "modes": [],
        "runOnTime": []
      }

selfmade · December 16, 2023, 7:21pm

okay, the wash machine take now any program and wash…
in swagger i take that

curl -X 'GET' \
  'https://api.mcs3.miele.com/v1/devices/000187069553/actions' \
  -H 'accept: application/json; charset=utf-8' \
  -H 'Authorization: Bearer DE_9e098ba17a12ac71c2afb70ed3756165'

and i get

{
  "processAction": [
    2,
    3
  ],
  "light": [],
  "ambientLight": [],
  "startTime": [],
  "ventilationStep": [],
  "programId": [],
  "targetTemperature": [],
  "deviceName": true,
  "powerOn": false,
  "powerOff": true,
  "colors": [],
  "modes": [],
  "runOnTime": []
}

i will send later this what i get in Machine-On and Mobile-Start.

and this is the output of currently suported actions for my machine

{
  "processAction": [
    1,
    2,
    3
  ],
  "light": [],
  "ambientLight": [],
  "startTime": [],
  "ventilationStep": [],
  "programId": [],
  "targetTemperature": [],
  "deviceName": true,
  "powerOn": false,
  "powerOff": true,
  "colors": [],
  "modes": [],
  "runOnTime": []
}

mundschenk-at · December 16, 2023, 7:42pm

Please note that the Miele app does not use the Miele 3rd-Party API but a separate internal API with much more fine-grained control.

Theoretically, it would be possible to control the devices entirely locally, but initial efforts to reverse engineer the protocol fizzled out once the 3rd-Party API became available.

selfmade · December 16, 2023, 9:52pm

yes i miss that…

@astrandb
her is my action output from swagger
My Wash Machine was in Mobilestart (WWP 760 Twindose)

edit:
the curl command:
curl -X 'GET' \
  'https://api.mcs3.miele.com/v1/devices/000187069553/actions' \
  -H 'accept: application/json; charset=utf-8' \
  -H 'Authorization: Bearer DE_9e09xxxxxxxxxxxxxxxxxxxx'
and what i get:

{
  "processAction": [],
  "light": [],
  "ambientLight": [],
  "startTime": [],
  "ventilationStep": [],
  "programId": [],
  "targetTemperature": [],
  "deviceName": true,
  "powerOn": false,
  "powerOff": true,
  "colors": [],
  "modes": [],
  "runOnTime": []
}

astrandb · December 17, 2023, 8:36am

No surprises there.
I cannot remember that I have seen programId working in the /actions endpoint. But the /programs endpoint will produce a list of available programs if the machine is in a proper state.

I think the only productive way forward is to experiment with Swagger to see what settings you can change in your machine. Miele developer support are rarely answering support questions of these topics unfortunately.

Use the endpoint /devices/{deviceId}/actions with PUT and follow the examples.
Look at the response codes and at your machine to see if the commands are accepted.
It is possible to turn oven lights on and off, to set target temperature in freezers, control the speed of evacuation fans etc. But I have’t been successful with controlling details for dishwashers, washing machines, hobs etc.