English概要

JIMIオープンAPIにより、販売店またはアプリケーションベンダーはAPIを呼び出したりユーザー自身のGUIクライアント、アプリ、またはWebサイトを使用したりして、お客様に追跡サービスを提供し、測位またはユーザー体験を向上させます。

アプリまたはウェブクライアントを、JIMI APIサーバーに直接接続するのではなく、アプリケーションサーバーに接続する必要があります。そして、アプリケーションサーバーを使用してJIMIサーバーに接続します。

Usage

1.appKeyとappSecrectを申し込む場合は、当社までお問い合わせください。アカウントを提供する必要があります。
2.このドキュメントに従って、アプリケーションサーバーを実装してaccess_tokenを取得します。
3.access_tokenを使用して他のインターフェースを呼び出し、ビジネスロジックを実行します。

規則

エンコーディング、フォーマットとタイムゾーン

デフォルトでは、UTF-8とJSONが使用されます。
Context-Type:デフォルトでは  application/json charset=utf-8が使用されます
デフォルトではUTC (GMT +0) 時間が使用されます。フォーマットはyyyy-MM-dd HH:mm:ssです。 
                    

一般的な応答フィールド

結果コードの説明

エラーコード：

ワークフロー

API Work Flow

APIワークフロー

APIの説明

リクエストURL

リクエストURLは一意であり、そのアドレスはhttp://open.10000track.com/route/restです。

各インターフェースは、リクエストパラメータメソッドによって識別されます。

セキュリティ

クライアントは、インターフェースを呼び出す前にまずaccess_tokenを取得する必要があります。インターフェースは、提供されたappKeyとappSecrectを使用してjimi.oauth.token.get interface(method=jimi.oauth.token.get)を呼び出すことで、JIMIサーバーによって生成されます。

APIを呼び出す場合、appKeyとaccess_tokenをリクエストパラメータの署名に使用する必要があります。JIMIサーバーは、署名の値をチェックすることにより、リクエストパラメータを検証します。

一般的なパラメータ

各リクエストパラメータには、一般的なパラメータとインターフェースプライベートパラメータが含まれています。たとえば、「jimi.oauth.token.get」インターフェースを呼び出す場合必要なものは：

（一般的なパラメータ）+ 3（プライベートパラメータ）= 10（パラメータ、キー/値）

署名

public static String signTopRequest(Map <String, String> params, >String seccode, String> signMethod) throws IOException {
    // 1：パラメータキーを並べ替える
    String[] keys = params.keySet().toArray(new String[0]);
    Arrays.sort(keys);
 
    // 2:: すべてのパラメータ名とパラメータ値をまとめる
    StringBuilder query = new StringBuilder();
    if (Constants.SIGN_METHOD_MD5.equals(signMethod)) {
        query.append(seccode);
    }
    for (String key : keys) {
        String value = params.get(key);
        if (StringUtils.areNotEmpty(key, value)) {
            query.append(key).append(value);
        }
    }
 
    // 3: MD5/HMACを使用して暗号化する
    byte[] bytes;
    if (Constants.SIGN_METHOD_HMAC.equals(signMethod)) {
        bytes = encryptHMAC(query.toString(), seccode);
    } else {
        query.append(seccode);
        bytes = encryptMD5(query.toString());
    }
 
   // 4: 2進数を大文字の16進数に変換する
    return byte2hex(bytes);
}
 
public static byte[] encryptHMAC(String data, String seccode) throws IOException {
    byte[] bytes = null;
    try {
        seccodeKey seccodeKey = new seccodeKeySpec(seccode.getBytes(Constants.CHARSET_UTF8), "HmacMD5");
        Mac mac = Mac.getInstance(seccodeKey.getAlgorithm());
        mac.init(seccodeKey);
        bytes = mac.doFinal(data.getBytes(Constants.CHARSET_UTF8));
    } catch (GeneralSecurityException gse) {
        throw new IOException(gse.toString());
    }
    return bytes;
}
 
public static byte[] encryptMD5(String data) throws IOException {
    return encryptMD5(data.getBytes(Constants.CHARSET_UTF8));
}
 
public static String byte2hex(byte[] bytes) {
    StringBuilder sign = new StringBuilder();
    for (int i = 0; i < bytes.length; i++) {
        String hex = Integer.toHexString(bytes[i] & 0xFF);
        if (hex.length() == 1) {
            sign.append("0");
        }
        sign.append(hex.toUpperCase());
    }
    return sign.toString();
}
                            

アクセストークンの取得

説明

クライアント（販売店のサーバー）はaccess_tokenをローカルに保存する必要があります。リクエストごとにaccess_tokenを取得する代わりに、ローカルのaccess_tokenを無効になる前に使用してください。クライアントからのリクエスト回数が多すぎた場合、JIMIサーバーはアクセスを許可しなくなります。

アクセストークンは約2時間（expires_inパラメータの値によって異なる）使用できます。すべてのリクエストでトークンを取得しようとしないでください。

リクエストURL

一意のリクエストURLを参照してください。Method = jimi.oauth.token.get

HTTPリクエストメソッド

POST

リクエストパラメータ

(1) 一般的なパラメータ
    

(2) 個人パラメータ
    

レスポンス

正常終了の例：

{
  "code": 0,
  "message": "success",
  "result": {
    "appKey": "8FB345B8693CCD003CC2DAB61EC8791D",
    "account": "jimitest",
    "accessToken": "7da3330ec28e3996b6ef4a7e3390ba71",
"expiresIn": 60
"refreshToken": "7da3330ec28e3996b6ef4a7e3390ba71",
	"time": "2017-06-15 10:00:00"

  }
}                  

異常終了の例：

{"code":xxx,"message":"Incorrect user name or password"}

Postmanデモ:

user_id ：TrackSolidアカウント
user_pwd_md5：md5（TrackSolidアカウントのパスワード）
Sign：md5（等号、コンマ、およびSignフィールドを除く、アルファベット順のパラメーター）
「Sign」は32文字の大文字の文字列である必要があります。

例:

<app_secrect>app_key9FB345B8693CCD0054E44ADF99139409expires_in7200formatjsonmethodjimi.oauth.token.getsign_methodmd5timestamp2017-09-28 01:55:00user_id<account>user_pwd_md5<password_md5>v1.0<app_secrect>

アクセストークンの更新

説明

このインターフェースは、アクセストークンが無効になる前に手動でトークンを更新するために使用されます。

リクエストURL

一意のリクエストURLを参照してください。Method = jimi.oauth.token.refresh

HTTPリクエストメソッド

POST

リクエストパラメータ

(1) 一般的なパラメータ

(2) 個人パラメータ

レスポンス

正常終了の例：

{
  "code": 0,
  "message": "success",
  "result": {
    "appKey": "8FB345B8693CCD003CC2DAB61EC8791D",
    "account": "jimitest",
    "accessToken": "7da3330ec28e3996b6ef4a7e3390ba71",
    "expiresIn": 60,
	"refreshToken": "7da3330ec28e3996b6ef4a7e3390ba71",
	"time": "2017-06-15 10:00:00"
  }
}
                    

異常終了の例：

{"code":xxx,"message":"Illegal request，token is invalid"}

すべてのサブアカウントの一覧表示

説明

指定したアカウントのすべてのサブアカウントを一覧表示します。

リクエストURL

一意のリクエストURLを参照してください。Method = jimi.user.child.list

HTTPリクエストメソッド

POST

リクエストパラメータ

(1) 一般的なパラメータ

(2) 個人パラメータ

レスポンス

結果:

正常終了の例：

{
  "code": 0,
  "message": "success",
  "result": [
    {
      "account": "123123",
      "name": "test",
      "type": 8,
      "displayFlag": 1,
      "address": null,
      "birth": "2017-04-22 00:00:00",
      "companyName": "",
      "email": "",
      "phone": "",
      "language": "zh",
      "sex": 0,
      "enabledFlag": 1,
      "remark": null
    }
  ]
}
                    

異常終了の例：

{"code":xxx,"message":"The account does not exist"}

サブアカウントの作成

説明

指定アカウントのサブアカウントを作成します。

リクエストURL

一意のリクエストURLを参照してください。Method = jimi.user.child.create

HTTPリクエストメソッド

POST

リクエストパラメータ

(1) 一般的なパラメータ

(2) 個人パラメータ

レスポンス

正常終了の例：：

{
  "code": 0,
  "message": "Vehicle information modification successful",
  "result": null
}
                    

異常終了の例：

{"code":xxx,"message":"The account does not exist"}

サブアカウントの削除

説明

指定されたアカウントのサブアカウントを削除します。

リクエストURL

一意のリクエストURLを参照してください。Method = jimi.user.child.del

HTTPリクエストメソッド

POST

リクエストパラメータ

(1) 一般的なパラメータ

(2) 個人パラメータ

レスポンス

正常終了の例：

{
  "code": 0,
  "message": "Vehicle information modification successful",
  "result": null
}
                    

異常終了の例：

{"code":xxx,"message":"no permissions"}

アカウントの移動

説明

あるサブアカウントから別のサブアカウントにアカウントを移動します。

リクエストURL

一意のリクエストURLを参照してください。Method = jimi.user.child.move

HTTPリクエストメソッド

POST

リクエストパラメータ

(1) 一般的なパラメータ

(2) 個人パラメータ

レスポンス

正常終了の例：

{
  "code": 0,
  "message": "Vehicle information modification successful",
  "result": null
}
                    

異常終了の例：

{"code":xxx,"message":"no permissions"}

サブアカウントのすべてのデバイスの一覧表示

説明

指定したアカウントのすべてのデバイスを照会します。

リクエストURL

一意のリクエストURLを参照してください。Method = jimi.user.device.list

HTTPリクエストメソッド

POST

リクエストパラメータ

(1) 一般的なパラメータ

(2) 個人パラメータ

レスポンス

正常終了の例：

{
  "code": 0,
  "message": "success",
  "result": [
    {
      "imei": "868120145233604",
      "deviceName": "868120145233604",
      "mcType": "GT300L",
      "mcTypeUseScope": "personal",
      "sim": "415451",
      "expiration": "2037-04-01 23:59:59",
      "activationTime": "2017-04-01 11:02:20",
      "reMark": "test",
      "vehicleName": null,
      "vehicleIcon": "bus",
      "vehicleNumber": "粤B3604",
      "vehicleModels": null,
      "carFrame": "2235",
      "driverName": "driver",
      "driverPhone": "13825036579",
      "enabledFlag": 1,
      "engineNumber": "8565674"
    }
  ]
}
             

異常終了の例：

{"code":xxx,"message":"Account queried doesn’t exist"}

デバイスの詳細情報の取得

説明

特定のIMEIのデバイス詳細情報を取得します。

リクエストURL

一意のリクエストURLを参照してください。Method = jimi.track.device.detail

HTTPリクエストメソッド

POST

リクエストパラメータ

(1) 一般的なパラメータ

(2) 個人パラメータ

レスポンス

正常終了の例：

{
  "code": 0,
  "message": "success",
  "result":
    {
      "imei": "868120145233604",
      "deviceName": "868120145233604",
      "mcType": "GT300L",
      "mcTypeUseScope": "personal",
      "sim": "415451",
      "expiration": "2037-04-01 23:59:59",
      "activationTime": "2017-04-01 11:02:20",
      "reMark": "test",
      "vehicleName": null,
      "vehicleIcon": "bus",
      "vehicleNumber": "粤B3604",
      "vehicleModels": null,
      "carFrame": "2235",
      "driverName": "driver",
      "driverPhone": "13825036579",
      "enabledFlag": 1,
      "engineNumber": "8565674",
 "iccid": "xxxxxxx",
 "imsi": "xxxx",
 "importTime": "2017-04-01 11:02:20",
 "licensePlatNo": "8565674",
 "VIN": "xxxxxxx",
 "vehicleBrand": "xxxx",
 "fuel_100km": "9",
 "status": "8565674"
    }
}                 

異常終了の例：

{"code":xxx,"message":"Account queried doesn’t exist"}

アカウントを介したデバイスの位置の取得

説明

アカウントのすべてのデバイスの最新の位置情報を取得します。

リクエストURL

一意のリクエストURLを参照してください。Method = jimi.user.device.location.list

HTTPリクエストメソッド

POST

リクエストパラメータ

(1) 一般的なパラメータ

(2) 個人パラメータ

レスポンス

正常終了の例：

{
  "code": 0,
  "message": "success",
  "result": [
    {
      "imei": "868120145233604",
      "deviceName": "868120145233604",
      "icon": "bus",
      "status": "0",
      "posType": "GPS",
      "lat": 22.577282,
      "lng": 113.916604,
      "hbTime": "2017-04-26 09:14:50",
      "accStatus": "0",
      "speed": "0",
      "gpsTime": "2017-04-26 09:17:46",
      "activationFlag": "1",
      "expireFlag": "1",
      "electQuantity": "60",
      "locDesc": null
      "powerValue": null
    }
  ]
}
                    

異常終了の例：

{"code":xxx,"message":"The account does not exist"}

デバイスの位置情報の取得

説明

つまたは複数のデバイスの最新の位置情報を取得します。

リクエストURL

一意のリクエストURLを参照してください。Method = jimi.device.location.get

HTTPリクエストメソッド

POST

リクエストパラメータ

(1) 一般的なパラメータ

(2) 個人パラメータ

レスポンス

結果リスト：

正常終了の例：

{
  "code": 0,
  "message": "success",
  "result": [
    {
      "imei": "868120145233604",
      "deviceName": "868120145233604",
      "icon": "bus",
      "status": "0",
      "posType": "GPS",
      "lat": 22.577282,
      "lng": 113.916604,
      "hbTime": "2017-04-26 09:14:50",
      "accStatus": "0",
      "speed": "0",
      "gpsTime": "2017-04-26 09:17:46",
      "activationFlag": "1",
      "expireFlag": "1",
      "electQuantity": "60",
      "locDesc": null
      "powerValue": null
    }
  ]
}
                    

異常終了の例：

{"code":xxx,"message":"Illegal device"}

共有位置のURLの取得/h2>

説明

地図に表示されているデバイスの位置のURLを取得します。

リクエストURL

一意のリクエストURLを参照してください。Method = jimi.device.location.URL.share

HTTPリクエストメソッド

POST

リクエストパラメータ

(1) 一般的なパラメータ

(2) 個人パラメータ

レスポンス

正常終了の例：

{
  "code": 0,
  "message": "success",
  "result":
    {
      "URL": "data.16180track.com/api/share?ver=2&method=trackDevice_abr&deviceinfo=7ae7c62385f2067f164002db315854a969a40e3888021cb01dc8f2183ca08dbbd8581f6bb86df4c2e3e1b887cb67c21039b4c0ced18fdf8dd08e0460c5edd13ad87e16dca9702ce6",
    }
}
                    

異常終了の例：

{"code":xxx,"message":"Illegal device"}

デバイスのユーザー有効期限の更新

説明

リクエストURL

一意のリクエストURLを参照してください。Method = jimi.user.device.expiration.update

HTTPリクエストメソッド

POST

リクエストパラメータ

(1) 一般的なパラメータ

(2) 個人パラメータ

レスポンス

正常終了の例：

{
  "code": 0,
  "message": "success",
  "result": [
    {
      "imei": "868120145233604",
      "update_result": "0",
      "update_msg": "update success"
},
{
      "imei": "868120145233605",
      "update_result": "1",
      "update_msg": "update failed, reason:xxxxxx"
    }

  ]
}
                    

異常終了の例：

{"code":xxx,"message":"Illegal device"}

デバイスの走行距離データの取得

説明

指定した時間範囲のデバイスの走行距離データを取得します。

リクエストURL

一意のリクエストURLを参照してください。Method = jimi.device.track.mileage

HTTPリクエストメソッド

POST

(1) 一般的なパラメータ

(2) 個人パラメータ

リクエストパラメータ

レスポンス:

例：

{
  "code": 0,
  "message": "success",
  "result": [
{
 "imei": “3505831983422342”,
 "startTime": "2017-04-26 00:00:58",
 "endTime": "2017-04-26 00:03:58",
      "startLat": 22.577144898887813,
      "startLng": 113.91674845964586,
      "endLat": 22.677144898887813,
      "endLng": 113.92674845964586,
  
      "elapsed": 2130,
      "distance": 25000,
      "avgSpeed": 90
    }
  ]
}
              

デバイスの追跡データの取得

説明

3か月以内に、2日以内のデバイス追跡データを取得します。

リクエストURL

一意のリクエストURLを参照してください。Method = jimi.device.track.list

リクエストパラメータ

(1) 一般的なパラメータ

(2) 個人パラメータ

HTTPリクエストメソッド

POST

リクエストパラメータ

レスポンス::

正常終了の例：

{
  "code": 0,
  "message": "success",
  "result": [
    {
      "lat": 22.577144898887813,
      "lng": 113.91674845964586,
      "gpsTime": "2017-04-26 00:00:58",
      "direction": 0,
      "gpsSpeed": -1,
      "posType": 3
    },
    {
      "lat": 22.57708,
      "lng": 113.916631,
      "gpsTime": "2017-04-26 00:01:30",
      "direction": 184,
      "gpsSpeed": 0,
      "posType": 1
    }
  ]
}
                 

異常終了の例：

                    {"code":xxx,"message":"IMEI does not exist{353419031939627}"}
                    {" code ":xxx,"message":"The device has expired{353419031939627}"}
                    

IMEIによる車両情報の更新

説明

IMEIによる車両情報の更新

リクエストURL

一意のリクエストURLを参照してください。Method = jimi.open.device.update

HTTPリクエストメソッド

POST

リクエストパラメータ

(1) 一般的なパラメータ

(2) 個人パラメータ

レスポンス:

正常終了の例：

{
  "code": 0,
  "message": "Vehicle information modification successful",
  "result": null
}
Wrong return example：
{"code":xxx,"message":"imei doesn’t exists"}

                 

車両のアイコン：

デバイスの写真またはビデオのURLの取得

説明

カメラで撮影したデバイスの写真またはビデオのURLを取得します。

リクエストURL

一意のリクエストURLを参照してください。Method = jimi.device.media.URL

HTTPリクエストメソッド

POST

リクエストパラメータ

(1) 一般的なパラメータ

(2) 個人パラメータ

レスポンス:

正常終了の例：

{
  "code": 0,
  "message": "Operation successful",
  "result": 
[
{
      "thumb_URL": “Q9GLAFFqfCrYF6YfQAcON4w4Ezs=/lhWse7ie3wtFrjuQZ22dLAk5CSaR”,
      "file_URL": “357730090345670_3949477_2019_04_29_12_32_38_01”,
      "mime_type": "video/mp4",
      "create_time": 2019-04-29 10:32:43,
      "media_type": 2,
      "camera": 1,
      "file_size": 9949087
},
{
      "thumb_URL": “Q9GLAFFqfCrYF6YfQAcON4w4Ezs=/FhCrZEIy3518sR_ylOlqDg7w3Ju-”,
      "file_URL": “351609080120911_3949476_2019_04_29_18_32_12”,
      "mime_type": "video/3gpp",
      "create_time": 2019-04-29 10:32:42,
      "media_type": 2,
      "camera": 1,
      "file_size": 2411318
}

]
  

}
                 

異常終了の例：

{"code":xxx,"message":"imei doesn’t exists"}

デバイスのライブスチーミングページのURLの取得

説明

デバイスのライブストリーミングページのURLと最後の位置情報を取得します。

リクエストURL

一意のリクエストURLを参照してください。Method = jimi.device.live.page.url

HTTPリクエストメソッド

POST

リクエストパラメータ

(1) 一般的なパラメータ

(2) 個人パラメータ

レスポンス:

正常終了の例：

{
  "code": 0,
  "message": "Vehicle information modification successful",
  "result": 
    {
      "lat": 22.577144898887813,
      "lng": 113.91674845964586,
      "gpsTime": "2017-04-26 00:00:58",
      "direction": 0,
      "gpsSpeed": -1,
      "posType": 3,
    	  "satellite": 11,
      "VIN":  "V12345",
      "plateNo":"ABC-12345",
      "UrlCamera": "https://www.domain.com/device/video/35408343202342345",
    }
  

}
                 

異常終了の例：

{"code":xxx,"message":"imei doesn’t exists"}

Wi-Fi、基地局の位置分析

説明

アカウントのデバイス総数で割り当てます（10回/日/デバイス、すべてのサブアカウントを含む）

リクエストURL

リクエストURLMethod = jimi.lbs.address.get

HTTPリクエストメソッド

POST

リクエストパラメータ

(1) 一般的なパラメータ

(2) 個人パラメータ

レスポンス:

正常終了の例：

{
"code": 0,
"message": "success",
"result": {
  "lat": 40.65615416521587,
  "lng": 109.89894039833524,
  "accuracy": 0
}
}
                 

異常終了の例：

{"code":xxx,"message":"illegal device"}

IMEIのジオフェンスの作成

説明

IMEIのジオフェンスの作成

リクエストURL

一意のリクエストURLを参照してください。Method = jimi.open.device.fence.create

HTTPリクエストメソッド

POST

リクエストパラメータ

(1) 一般的なパラメータ

(2) 個人パラメータ

レスポンス:

正常終了の例：

{
"code": 0,
"message": "Successfully create geo-fence.",
"result": "5"
}
Wrong return example：
{
"code": 41003,
"message": "Device is not online, geo-fence creation failed ",
"result": null
}
                 

デバイスのジオフェンスの削除

説明

デバイスのジオフェンスの削除

リクエストURL

一意のリクエストURLを参照してください。Method = jimi.open.device.fence.delete

HTTPリクエストメソッド

POST

リクエストパラメータ

(1) 一般的なパラメータ

(2) 個人パラメータ

レスポンス:

正常終了の例：

{
"code": 0,
"message": "delete the geo-fence successfully",
"result": null
}
                 

異常終了の例：

{
"code": 41003,
"message": "The device is not online and geo-fence can’t be deleted",
"result": null
}
                

デバイス対応のコマンドリストの取得

説明

デバイスでサポートされているコマンドリストを取得します

リクエストURL

一意のリクエストURLを参照してください。Method = jimi.open.instruction.list

HTTPリクエストメソッド

POST

リクエストパラメータ

(1) 一般的なパラメータ

(2) 個人パラメータ

レスポンス:

正常終了の例：

{
"code": 0,
"message": "success",
"result": [
  {
    "id": 81,
    "orderName": "SOS setting",
    "orderContent": "SOS,A,{0},{1},{2}#",
    "orderExplain": "SOS is used for receive alerts and SOS alerts. SOS number should have 3-20 numbers.",
    "orderMsg": "",
    "isOffLine": "1"
  }
  ...
]
}
                 

異常終了の例：

{"code":xxx,"message":"Illegal device"}

コマンドのデバイスへの送信

説明

コマンドをデバイスに送信します。

リクエストURL

リクエストURLMethod = jimi.open.instruction.send

HTTPリクエストメソッド

POST

リクエストパラメータ

(1) 一般的なパラメータ

(2) 個人パラメータ

inst_param_jsonの説明：

例：

{"inst_id": "113","inst_template":"RELAY,1#","params":[],"is_cover":"true"}
{"inst_id": "114","inst_template":"RELAY,0#","params":[],"is_cover":"true"}
                 

ユーザー定義コマンド：

{"inst_id": "96","inst_template":"{0}","params":["STATUS#"],"is_cover":"true"}

レスポンス:

正常終了の例：

{
  "code": 0,
  "message": "command is successfully sent.",
  "result": null
}

                 

異常終了の例：

{
  "code": 12005,
  "message": "Fail to send command. Result code：226",
  "result": null
}

               

コマンドの実行結果の取得

説明

コマンドの送信結果を取得します。

リクエストURL

一意のリクエストURLを参照してください。Method = jimi.open.instruction.result

HTTPリクエストメソッド

POST

リクエストパラメータ

(1) 一般的なパラメータ

(2) 個人パラメータ

レスポンス:

正常終了の例：

{
  "code": 0,
  "message": "success",
  "result": [
    {
      "codeId": "99",
      "code": "status#",
      "content": "Parameter error",
      "isExecute": "4",
      "sendTime": "2017-06-19 11:46:00",
      "sender": "jimitest",
      "receiveDevice": "868120111111117",
      "isOffLine": "1",
      "idsource": "User-defined command"
    }
  ]
}
                 

異常終了の例：

{"code":xxx,"message":"Illegal device"}

通知の受信

説明

サードパーティのプラットフォームは、通知を受信するためのURLアドレスを提供する必要があります（JIMIに連絡してURLを手動で提供してください）。JIMIサーバーは、このURLを使用してHTTPリクエストを送信することで、通知をプッシュします。

メッセージサービスリスト

リクエスト内容

メッセージの内容（jimi.push.device.alarm）

プッシュアラームは以下の通りです。

例：

Parameter1:
Key = msgType
Value = jimi.push.device.alarm

Parameter2:
Key = data
Value =  {
    "imei": "868120145233604",
    "deviceName": "868120145233604",
    "alarmType": "2",
    "alarmName": "Power off alarm",
    "lat": 40.65615416521587,
    "lng": 109.89894039833524,
    "alarmTime": "2017-05-08 12:00:00"
  }
                 

デバイスアラームリストの取得

説明

デバイスアラームリストを取得します。
検索条件の期間は1か月以内である必要があります。
最大1000行を返します。

リクエストURL

一意のリクエストURLを参照してください。Method = jimi.device.alarm.list

HTTPリクエストメソッド

POST

リクエストパラメータ

(1) 一般的なパラメータ

(2) 個人パラメータ

レスポンス:

正常終了の例：

{
  "code": 0,
  "message": "success",
  "result": [
    {
      "deviceName": "ABC-34352",
      "IMEI": "343503422910345",
      "model": "GT06N",
      "account": "test1234",
      "alertTypeId": "1002",
      "alertType": "ACC On",
      "alertTime": "2019-03-14 14:02:03",
      "positioningTime": "2019-03-14 14:02:03",
      "lat": 22.577144898887813,
      "lng": 113.91674845964586
    }
  ]
}
                 

異常終了の例：

{"code":xxx,"message":"Illegal device"}

コマンドの送信（スクーターデバイス）

説明

コマンドをスクーターデバイスに送信します。

リクエストURL

一意のリクエストURLを参照してください。Method = jimi.scooter.instruction.send

HTTPリクエストメソッド

POST

リクエストパラメータ

(1) 一般的なパラメータ

(2) 個人パラメータ

レスポンス:

成功例：

{
  "code": 100,
  "message": "Success"
}
                 

失敗例:

{
  "code": 200,
  "message": "Invalid parameter"
}
               

スクーターの詳細情報の取得

説明

デバイスの詳細情報とステータスを取得します。

リクエストURL

一意のリクエストURLを参照してください。Method = jimi.scooter.device.detail

HTTPリクエストメソッド

POST

リクエストパラメータ

(1) 一般的なパラメータ

(2) 個人パラメータ

レスポンス:

結果リスト：

正常終了の例：

{
  "code": 0,
  "msg": "Operation success.",
  "result": 
    {
      "deviceImei": "860425040472944",
      "scooterError": {
        "IoT": 0,
        "accelerator": 0,
        "battery": 0,
        "brakeHandlebar": 0,
        "controller": 0,
        "dashboard": 0,
        "motor": 0,
        "voltage": 0
      },
      "scooterProperties": {
        "ECUVersion": "0.1",
        "batteryCapacity": 22834,
        "batteryVoltage": 36,
        "bluetoothVersion": "2.1",
        "firmwareVersion": "c.0",
        "scooterVersion": "3.0",
        "speedLimit": 50
      },
      "realtimeData": {
        "totalOdometer": 14592,
        "batteryCycle": 512,
        "batteryLevel": 56,
        "batteryTemperature": 23,
        "current": 614.39,
        "currentOdometer": 217.6,
        "remainingMileage": 69.2,
        "speed": 99.86,
        "voltage": 460.94
      },
      "realtimeStatus": {
        "DLCC": 0,
        "DLCCStatus": 0,
        "acceleratorStatus": 0,
        "brake": 0,
        "settingBrakeLight": 1,
        "charge": 0,
        "settingFrontLight": 0,
        "realFrontLight": 0,
        "motoStatus": 0,
        "realBrakeLight": 0,
        "workingMode": 0
      },
      "drivingSetting": {
        "DLCC": 0,
        "drivingMode": 2,
        "lightMode": 0,
        "quickStart": 1,
        "speedLimit": 30,
        "speedUnit": 0
      },
      "IoTModule": {
        "imsi": "0460045394000271",
        "iccid": "89860433231880390271",
        "BluetoothMac": "000000000000",
        "satellite": 11,
        "course": 0,
        "gpsMode": 0,
        "gpsSpeed": 0,
        "gpsTime": "2019-05-09 18:41:12",
        "lAC": 0,
        "latitude": 22.577137,
        "longitude": 113.916756,
        "mCC": 0,
        "mNC": 0,
        "positioningType": "GPS",
        "gsmSignal": 4,
        "gpsStatus": 0,
        "batteryVoltage": 4.15
      }
    }
}
                 

正常終了の例：

{"code":xxx,"message":"Illegal device"}