sharee.bike-Wiki/3.5.-pri-request=bikes_available.md
2022-01-28 20:41:29 +00:00

90 lines
4 KiB
Markdown

### request=bikes_available
**request** GET of the available rental bikes with the optional specification **station** and/or **system**.
| key | Required | Format | Comment |
| ---------- | -------- | ------- | ----------------------------------- |
| authcookie | + | text>=8 | unique encrypted key OR merchant_id |
| system | o | text | bike lock system |
| station | o | text | station prefix+number |
**response** list of bikes by JSON-Objects
| key | Required | Format | Comment |
| -------------- | -------- | -------- | -------------------------------------- |
| state | + | text | bike available state |
| lock_state | + | text | bike smartlock locking state |
| station_state | o | text | station smartlock locking state |
| service_state | o | text | service state for maintanance |
| bike_charge | o | text | bike akku capacity |
| description | o | text | short bike description |
| bike | + | text | bike prefix+number |
| gps | + | array | GPS: latitude, longitude |
| station | + | text | station prefix+number |
| bike_group | + | array | bike group |
| system | + | text>=1 | bike lock system |
| uri_operator | + | text | URI of Operator-Server |
| lockit_ID | + | text | bluetooth ID |
| lockit_GUID | + | text | bluetooth GUID |
| authed | + | text | if 1 then authenticated request on operator |
| tariff_description | + | array | bike Tariff description |
**tariff_description** JSON Object
| key | Required | Format | Comment |
| ------------------ | -------- | ---------------- | -------------------------- |
| name | + | text | Tarif name |
| number | + | text | Tarif number |
| eur_per_hour | + | text | EUR per hour |
| free_hours | + | text | free hours per bike per day |
| max_eur_per_day | + | text | max EUR per day |
| abo_eur_per_month | + | text | EUR per month by Abo |
| track_info | + | text | GPS tracking message |
| operator_agb | + | text | Operator AGB message and href |
Example
**REST request=bikes_available** for authorized users
```
https://shareeapp-primary.copri-bike.de/APIjsonserver?request=bikes_available&authcookie=6103_f782a208d9399291ba8d086b5dcc2509_23456789
```
**response** sharee JSON defaults + **response** multiple bike objects
```
{
"shareejson" : {
***sharee JSON defaults***
},
"bikes" : {
"WUE5525" : {
"gps" : {
"latitude" : "47.987975491085045",
"longitude" : "7.816756743460897"
},
"tariff_description" : {
"name" : "WuerzBasis Tarif",
"eur_per_hour" : "3.00",
"max_eur_per_day" : "15.00",
"free_hours" : "0.50",
"number" : "5523"
},
"state" : "available",
"authed" : "1",
"description" : "Lastenrad Sabine",
"bike" : "WUE5525",
"lock_state" : "locked",
"station" : "WUE302",
"Ilockit_GUID" : "",
"bike_group" : [
"WUE300029"
],
"Ilockit_ID" : "00000000-0000-0000-0000-fc3c002a2add",
"uri_operator" : "https://shareeapp-wue.copri-bike.de",
"system" : "Ilockit"
},
"LEC5522" : {
...
}
}
```