Add a *Functionality* to the device.
Required parameters are :
- functionality class
- endpoint
Each device class has its own restrictions on which Functionality classes can be added and on which endpoints.
Only a few devices allow to add Functionalities.
|Device class|Functionality class|Endpoints|
|------------|-------------------|---------|
|MINT |CurrentPeriod |1,2,3 |
|MINT |ElectricityRates |1,2,3 |
|MINT |GenericRate |1,2,3 |
**Note**: requires full access to the *Account*.
Trigger the request of a new password.
The account administrator will receive an e-mail with an URL pointing to a form
to allow him/her to enter a new password.
The old password is still functional until a new one is submitted.
Either the login or e-mail of the account must be given.
Create a new *Place*.
A *Device* (`class`: `MINT`, `address`: `0`) is automatically created and attached to the new *Place*.
**Note:** requires full access to the *Account*.
Get the mapping of virtual electricity flows to functionalities.
Some rules are applied to expand the virtual flows using the concrete
flows available.
The `factor` tells how each energy value coming from a functionality
must be added with values from other functionality to compute the
energy of the virtual flow. Factors are usually `1` or `-1`.
The `code` property gives the result which may be partial:
- If all flows are available, `200000` is returned.
- If no flows are available (indicating that the place has no
electricity functionality or that no functionality has been attached
to a flow), the `code` is `200001`. The `missing` property contains
all the requested flows.
- If some flows are missing, the `code` is `200002` and the `missing`
property lists them.
Get the values of multiple *Attributes* and their history.
If the `names` parameter is not given, all the attributes of the *Functionality*
are returned. As the list may be huge, this must be avoided.
If the `to` parameter is set, `from` must also be set.
If `from` is not set, only the last value is returned.
The `surround` parameter allows to ask also for one value beyond each interval boundaries.
The request may fail if too many values are asked.
Get information on the authenticated *User* who does the request.
The *login* property is returned only if the *User* is the administrator of
the *Account*.
Get the list of *Buses* available on the gateway of this *Place*.
If `withPairing` is `true`, return only buses that allow device pairing (see `/places/{placeId}/buses/{busId}/pairing`).
Modify the metadata of a *Notification*.
Keys are limited to the same format as tags (up to 21 characters, [a-z0-9], starting with [a-z]). Values can be any JSON value.
Modify the metadata of a *Program*.
Keys are limited to the same format as tags (up to 21 characters, [a-z0-9], starting with [a-z]). Values can be any JSON value.
Run an *Action* on zero, one or multiple *Functionalities* selected with tags.
*Device* and *Functionality* selection are combined with « AND ».
If no functionality is matched by the device/functionality selection, an empty array is returned.