joeshaw / carwings

Go package and CLI tool for the Nissan Leaf Carwings API
MIT License
31 stars 11 forks source link

server endpoints #31

Closed gitrago closed 3 years ago

gitrago commented 4 years ago

When running in server mode, what endpoints are exposed? I found http://server:8040/battery by chance, are there any others?

joeshaw commented 4 years ago

Yeah, sorry, I threw that together pretty quickly and never documented it properly.

The endpoints are

GET /battery
GET /climate
POST /charging/on
POST /climate/on
POST /climate/off

The POST requests have no body.

gitrago commented 4 years ago

Thank you very much. Slightly off-topic but I'll ask you anyway: My understanding is that a charging session can be initiated remotely via the API but it can not be stopped, car is charging until SoC=100. On the other hand, a discharge (v2x) can not be started remotely on a connected car. Is this true and do you know where to confirm this?

joeshaw commented 4 years ago

My understanding is that a charging session can be initiated remotely via the API but it can not be stopped, car is charging until SoC=100.

That's my understanding as well, based on the APIs available.

On the other hand, a discharge (v2x) can not be started remotely on a connected car.

I don't know anything about this. I have a 2017 and have only implemented the older "Carwings" API, which doesn't have any discharge feature. Do you have a link or reference to it?

gitrago commented 4 years ago

No, unfortunately I don't. We have a Leaf 2018 and in theory it supports v2x. I am at a loss as for where to find documentation on it. CHAdeMO website maybe?

On Thu, Jan 30, 2020 at 4:37 PM Joe Shaw notifications@github.com wrote:

My understanding is that a charging session can be initiated remotely via the API but it can not be stopped, car is charging until SoC=100.

That's my understanding as well, based on the APIs available.

On the other hand, a discharge (v2x) can not be started remotely on a connected car.

I don't know anything about this. I have a 2017 and have only implemented the older "Carwings" API, which doesn't have any discharge feature. Do you have a link or reference to it?

— You are receiving this because you authored the thread. Reply to this email directly, view it on GitHub https://github.com/joeshaw/carwings/issues/31?email_source=notifications&email_token=AC5PDGHLHAONTR3GVLYIME3RALX2VA5CNFSM4KMS3XQ2YY3PNVWWK3TUL52HS4DFVREXG43VMVBW63LNMVXHJKTDN5WW2ZLOORPWSZGOEKLNPHQ#issuecomment-580310942, or unsubscribe https://github.com/notifications/unsubscribe-auth/AC5PDGEVGTL3EFU5K4G4RZDRALX2VANCNFSM4KMS3XQQ .

joeshaw commented 4 years ago

Ah, I wasn't familiar with what v2x is. Just read up on it, looks neat.

I am very doubtful there is API for this -- I imagine the discharging is something that the v2x-capable hardware would initiate through the CHAdeMO connection.

joeshaw commented 3 years ago

I've added some documentation to the README about server mode. I don't think there's any other action to take on this, so I'm closing it out.