docs icon indicating copy to clipboard operation
docs copied to clipboard

Better HTTP POST docs

Open andig opened this issue 3 years ago • 5 comments

Ah, verstanden. Das sollte gehen:

body: { "charging_amps": ${maxcurrent} }

Die maxcurrent ist sowieso int64, deshalb ist keine zusätzliche Formatierung notwendig

Originally posted by @andig in https://github.com/evcc-io/evcc/discussions/2309#discussioncomment-2022117

andig avatar Jan 22 '22 10:01 andig

Gibt es hier nur diesen Wert oder auch andere Beispiele? Wo finde ich die?

DerAndereAndi avatar Jan 27 '22 19:01 DerAndereAndi

Die Werte heissen immer genau so wie das Property des custom devices (soc beim Auto etc). Also genau wie das Property das gerade konfiguriert wird.

andig avatar Jan 27 '22 20:01 andig

Alternativ: wir ändern das so, dass der Parameter immer „value“ heisst? Wäre vielleicht intuitiver?

andig avatar Jan 27 '22 20:01 andig

und wie wir das dann referenziert?

Wir haben hier auch 2 Doku Probleme:

  1. Welche Werte gibt es
  2. Wie werden die in den Plugins verwendet

Für 2. hilft das, dann ist das immer gleich. Für Rückwärtskompatibilität dann beides, wir dokumentieren aber nur value Für 1. muss das eh in die Geräte Bereiche unter der manual rein, und das beispiel muss schon alle möglichen Werte beinhalten

DerAndereAndi avatar Jan 27 '22 20:01 DerAndereAndi

1 hatten wir doch neulich erst diskutiert- siw sind die dokumentiert

andig avatar Jan 27 '22 20:01 andig