sharee.bike-Wiki/4.1.-op-request=bikes_available.md
2023-11-22 18:29:27 +00:00

6.2 KiB

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
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 bike lock system
uri_operator + text URI of Operator-Server
lockit_ID + text bluetooth ID
lockit_GUID + text bluetooth GUID
rental_description + object with tarif_elements and rental_info
bike_type + object describes the bike with some attributes
smartlock_type o object (under development) describes the smartlock with some attributes
bikes_occupied o object Implicit returns the json object which is defined in "request=user_bikes_occupied"

rental_description JSON Object

key Required Format Comment
name + text Tarif name
id + text Tarif number
tarif_elements + object with array contains an indexed array with tarif data
rental_info + object with array contains an indexed array with rental information

bike_type JSON Object

key Required Format Comment
category o text "city" or "cargo"
wheels o text "2" or "3"
engine o object contains engine attributes like "manufacturer"
battery o object contains bike battery attributes. "hidden=0" means not in App visible. "backend_accessible=0" means no bike charge API available

smartlock_type JSON Object

key Required Format Comment
engine o object contains engine attributes like "manufacturer"
battery o object contains smartlock battery attributes.

bike_group describes at which station defined in station_group the bike is allowed. Groups are identified by ID. The following groups of bicycles are defined:

Defined group ID's bike type
300101 cargo
300103 city
Keep in mind, each ID is preceded by an operator-prefix. Data type is array.

Example REST request=bikes_available for authorized users

https://sharee-operator.example.tld/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"
            },
            "bike_type" : {
               "battery" : {
                  "charge_current_bars" : "4",
                  "hidden" : "0",
                  "charge_max_bars" : "5",
                  "backend_accessible" : "0",
                  "charge_current_percent" : "70"
               },
               "category" : "cargo",
               "wheels" : "2",
               "engine" : {
                  "manufacturer" : "dummy"
               }
            },
            "rental_description" : {
               "tarif_elements" : {
                  "1" : [
                     "Mietgebühr",
                     "3,00 € / 1 Std "
                  ],
                  "2" : [
                     "Gratiszeit",
                     "1 Std / Tag"
                  ],
                  "4" : [
                     "Max. Gebühr",
                     "20,00 € / Tag"
                  ]
               },
               "id" : "5519",
               "name" : "Cargo-Bikes",
               "rental_info" : {
                  "2" : [
                     "Tracking",
                     "Ich stimme der Speicherung (Tracking) meiner Fahrstrecke zwecks wissenschaftlicher Auswertung und Berechnung der CO2-Einsparung zu!"
                  ]
               }
            },
            "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-operator.example.tld",
            "system" : "Ilockit",
            "smartlock_type" : {
               "engine" : {
                  "manufacturer" : "Ilockit"
               },
               "battery" : {
                  "charge_current_percent" : "37"
               }
            }
         },
  "LEC5522" : {
   ...
  },
  "bikes_occupied" : {}
}