sharee.bike-Wiki/2.-sharee-JSON-defaults.md
2022-01-28 11:21:33 +00:00

4.3 KiB

standard JSON root response after ALL requests

key Required Format Comment
user_id + text returns user_id email-address
user_group + array user group describes user registered bike fleets
user_tour o array user tour describes registered service tour
debuglevel o text returns user specified debuglevel for development
response + text return request value
response_state + text OK or Failure with description
response_text o text Text description for UI feedback
authcookie + text>=30 unique encrypted key on authorization success
copri_version + text returns COPRI Version
clearing_cache o text returns 1 if client have to clear cached values
agb_checked + text returns 1 if AGB checked
uri_primary + text returns primary server URI (Authorization server)
impress_html o text returns site/impress.html
tariff_info_html o text returns site/tariff_info.html
bike_info_html o text returns site/bike_info.html
privacy.html o text returns site/privacy.html
agb_html o text returns site/agb.html
lang o text language iso code
init_map o object json object for init map (see example)
last_used_operator o object json object wit last jused operator data (see example)

keep in mind, integers will also be delivered as characters.

Example request authorization

https://shareeapp-primary.example.tld/APIjsonserver?request=authorization&merchant_id=your-merchant-id&user_id=mail@example.tld&user_pw=example-pw&hw_id=unique-device-id

response on success

{
   "shareejson" : {
      "debuglevel" : "32",
      "tariff_info_html" : "site/tariff_info.html",
      "user_tour" : [],
      "user_group" : [],
      "bike_info_html" : "site/bike_info.html",
      "lang" : "DE",
      "agb_html" : "site/agb.html",
      "impress_html" : "site/impress.html",
      "privacy_html" : "site/privacy.html",
      "agb_checked" : "1",
      "copri_version" : "4.1.9.6",
      "user_id" : "ragu@gnu-systems.de",
      "init_map" : {
         "center" : {
            "longitude" : "7.825490",
            "latitude" : "47.976634"
         },
         "radius" : "2.9"
      },
      "uri_primary" : "https://shareeapp-primary.copri.eu",
      "authcookie" : "1842966_9580e08d7a627f80ab12ff8f65f1f598_87fab741bb98",
      "clearing_cache" : "0",
      "response" : "authorization",
      "response_text" : "Herzlich willkommen im Fahrradmietsystem",
      "response_state" : "OK, nothing todo",
      "last_used_operator" : {
         "operator_phone" : "+49 761 453xxxxx7",
         "operator_color" : "#009699",
         "operator_name" : "sharee.bike | TeilRad GmbH",
         "operator_email" : "hotline@example.tld",
         "operator_hours" : "Bürozeiten: Montag, Mittwoch, Freitag 9-12 Uhr"
      }
   }
}

response on authentication failure

{
   "shareejson" : {
      "authcookie" : "",
      "clearing_cache" : "0",
      "agb_checked" : "0",
      "response_text" : "Entschuldigung, die Anmeldung schlug fehl",
      "copri_version" : "4.1.10.2",
      "user_id" : "",
      "agb_html" : "site/agb.html",
      "response" : "authorization",
      "user_group" : [],
      "impress_html" : "site/impress.html",
      "response_state" : "Failure: cannot generate authcookie",
      "uri_primary" : "https://shareeapp-primary.copri-bike.de",
      "tariff_info_html" : "site/tariff_info.html",
      "lang" : "DE",
      "privacy_html" : "site/privacy.html",
      "bike_info_html" : "site/bike_info.html"
   }
}