EnglishVisión General

El beneficio de JIMI Abrir API, el distribuidor o el vendedor de APP podría ofrecer un servicio de rastreo a los consumidores por llamar API y utilizar su propio consumidor de GUI, APP o sitio de web, esto podría mejorar la localización o la experiencia del usuario.

Su APP o el consumidor de web debe conectarse a su servidor de APP, en lugar de conectarse directamente al Servidor de JIMI API , utilizar su servidor de APP a conectarse al servidor de JIMI.

Uso

1. Comunicar con nosotros para aplicar su appKey y appSecrect, debe ofrecer su cuenta.
2. De acuerdo con este documento a implementar su servidor de APP para a obtener acceso_tomado.
3. Llamar a otras interfaces con acceso_tomado para cumplir con su lógica empresarial.

Convenciones

Codificación, Formato & Zona horaria

UTF-8 y JSON se utilizan por falla.
Tipo de Contexto:  aplicación por falla / json charset = utf-8
API usa la hora de UTC (GMT +0) por falla: formato de año-mes-díayyyy-MM-dd HH:mm:ss

Campos de respuesta comunes

Clave	Tipo	Requerido	descripción
código	int	Sí	código de resultado
mensaje	cuerda	No	descripción

Resultado de descripción

código	Valor	descripción
-1	-1	El sistema se ocupa
0	0	éxito
1xxx	1001	Error de parámetro (falta de los parámetros necesarios o el error de formato). Consultar la descripción de la interfaz a obtener más detalles.
	1002	Usuario ilegal / dispositivo ilegal (no es de su propia o subordinaa cuenta o dispositivo)
	1003	Repitar la operación
	1004	Acceso ilegal, excepción token (Token de falla o inexistente)
	1005	Acceso ilegal, ¡el acceso ip excede el límite!
	1006	Acceso ilegal, ¡solicita con demasiada frecuencia!
	1007	Acceso ilegal, error en el método de solicitud.
	1008	¡Acceso ilegal, entrada anormal!
	12001	Error de crear la cuenta de plataforma
	12002	Error de transferir del dispositivo
	12003	Error de crear de la geo-cerca
	12004	Error de eliminar la cerca geográfica
	12005	Error de enviar el comando

Código de error:

código	Valor	descripción
Crear una cuenta	213	La cuenta ya existe
	214	sin permisos
	215	Error de tipo de usuario. Los motivos posibles: 1. El tipo de usuario está vacío; 2. El tipo de usuario no existe; 3. El usuario de inicio de sesión actual no se permite a crear un nuevo tipo de usuario.。
Transferencia de dispositivo	217	El usuario de destino no existe
	218	El usuario puede sólo transferir / vender los dispositivos a la subcuenta
	219	La lista de IMEI es ilegal
	220	El número de IMEI excede al límite
Geo-cerca	41001	Exceder al número máximo de geo-cerca soportada
	41002	El nombre de cerca ya existe
	41003	El dispositivo no está en línea
	41004	Error de operar la geo-cerca
Comando	225	Acabar el tiempo
	226	Error de parametro
	227	El comando no es ejecutado correctamente
	228	El dispositivo no está en línea
	229	Error de red, error de conexión, etc.
	238	Dispositivo interrumpido
	240	Error de formato de datos
	243	No es compatible con el dispositivo
	252	El dispositivo se ocupa

Flujo de Trabajo

Flujo de Trabajo de API

Funciones de API

Tipo de Interfaz	Método	descripción
Acceso de token	jimi.oauth.token.get	Obtener acceso_token
Acceso de token	jimi.oauth.token.refresh	Actualizar acceso_token
Usuario de API	jimi.user.child.list	Lista de todas las subcuentas
	jimi.user.device.list	Lista de todos los dispositivos de la cuenta actual
	jimi.user.child.create	Crear sub-cuenta
	jimi.user.child.del	Eliminar sub-cuenta
	jimi.user.child.move	Mover sub-cuenta a la otra
	jimi.track.device.detail	Obtener la información en detalle del dispositivo para un IMEI especial
	jimi.user.device.location.list	Obtener la ubicación más reciente para todos los dispositivos
Device API	jimi.device.location.get	Obtener los datos de ubicación más recientes para un IMEI especial
	jimi.device.location.URL.share	Obtener URL para mostrar la ubicación en el mapa
	jimi.user.device.expiration.update	Cambiar la fecha de vencimiento del usuario para los dispositivos
	jimi.device.track.list	Obtener datos de rastreo según IMEI
	jimi.device.track.mileage	Obtener el informe de kilometraje para los dispositivos
	jimi.open.device.update	Modificar la información del vehículo para los dispositivos
	Jimi.device.media.URL	Obtener URL a capturar las fotos o los vídeo por cámara
	jimi.device.live.page.url	Obtener la URL de la página de transmisión en directo del dispositivo
Comando de API	jimi.open.instruction.list	Obtener los comandos soportados por el dispositivo
	jimi.open.instruction.send	jimi.abrir.instrucción.enviar
	jimi.open.instruction.result	Obtener el resultado del comando
Geo-cerca de API	jimi.open.device.fence.delete	Retirar la cerca geográfica para el dispositivo
Geo-cerca de API	jimi.open.device.fence.create	Crear una cerca geográfica para el dispositivo
LBS-API	jimi.lbs.address.get	Análisis de ubicación de la estación base de Wi-Fi
Mensaje	jimi.push.device.alarm	Empujar la notificación de alarma
Mensaje	jimi.device.alarm.list	Obtener la lista de alarmas para el dispositivo
Scooter de API	jimi.scooter.instruction.send	Enviar el comando al dispositivo de scooter
Scooter de API	jimi.scooter.device.detail	Obtener el estado del scooter y otra información en detalle

Descripción de API

Solicitar URL

La URLúnica de solicitud es：http://open.10000track.com/route/rest.

Las interfaces diferentes se identifican por solicitar el método de parámetro.

Seguridad

El consumidor debe acceso_token primero antes de llamar a la interfaz, que se genera por el servidor de JIMI mediante llamar la interfaz jimi.oauth.token.obtener interfaz (método = jimi.oauth.token.get) con appKey y appSecrect ofrecidos.

Requieren appKey y acceso_token a signar los parámetros de solicitud cuando llamar API. El servidor de JIMI valida los parámetros de solicitud mediante comprobar el valor del signo.

Parámetros comunes

Los parámetros de cada solicitud deben componer los parámetros comunes y las interfaces privadas. Por ejemplo, si llama a la interfaz "jimi.oauth.token.get", debe ofrecer:

7 (parámetros comunes) + 3 (parámetros privados) = 10 (parámetros, clave / valor)

Nombre	Tipo	Requerido	descripción	Código	Defecto
método	cuerda	Sí	Nombre de la interfaz de API
marca de tiempo	cuerda	Sí	Marca de tiempo, formato: año-mes-día HH: mm: ss. Permiten más o menos 10 minutos. por ejemplo: 2012-03-25 20:00:00	GMT(UTC) tiempo.
app_clave	cuerda	Sí	APP_KEY	de JIMI
signor	cuerda	Sí	Un signo se basa a los parámetros, appKey, appSecrect.
signo_método	cuerda	Sí	Un signo se basa a los parámetros, appKey, appSecrect.
signo_método	cuerda	Sí	Método de signo opcional. Valor disponible: md5, los métodos de soporte son: md5	>md5	>md5
			Sistema predeterminado 1,0, versión de soporte: 0,9, 1,0	1.0: verificar signo
format	cuerda	Sí	Opcional, especificar el formato de respuesta.		json

firma

Con objetivo de proteger las llamadas de API de piratería, cualquier llamada de API debe signorse. El servidor de JIMI verifica el signo según los parámetros de solicitud. La solicitud de signo ilegal va a rechazarse. Los algoritmos de signo soportada son: md5 (signo_método es un parámetro Común que es mencionado arriba). A continuación se muestra el algoritmo de signo:

1. Ordenar todos los parámetros de solicitud con la clave de parámetro en orden alfabético (incluidos los parámetros Comunes y los especiales del método, pero NO compone el parámetro de tipo de signo y byte.

Por ejemplo:

foo=1, bar=2, foo_bar=3, foobar=4
Resultado: bar=2, foo=1, foo_bar=3, foobar=4

2.Eliminar todos las signos iguales y la coma:

bar2foo1foo_bar3foobar4

3.Después, concatenar appSecret al inicio y el cabo de la cadena de resultado y obtener el valor md5, como:

md5(+bar2foo1foo_bar3foobar4+), la cuerda real debe ser: md5(h9lri085eachcz4sn7gwnkh6j0jt0yz4bar2foo1foo_bar3foobar4h9lri085eachcz4sn7gwnkh6j0jt0yz4)

Notar que la cuerda debe estar en codificación de UTF-8.
Notar que la signo debe ser una cuerda en mayúsculas.

Si el valor del parámetro es un flujo de bytes, debe convertirse a hexadecimal. Por ejemplo: hex ("helloworld" .getBytes ("utf-8")) = "68656C6C6F776F726C64"

MD5 es el algoritmo de resumen de 128-bit y está en hexadecimal. Un carácter hexadecimal puede representar cuatro bits, por eso, la longitud de cuerda de signo es de 32 caracteres hexadecimales.

Ejemplos de JAVA:

Público estático Cuerda señal Top Solicitud (Mapa  params,> Cuerda seccode, Cuerda> Método de señal) arroja IO Excepción {
    // 1：clave de parámetro de clasificación
    String[] keys = params.keySet().toArray(new String[0]);
    Arrays.sort(keys);
 
    // 2:Pone todos los nombres y valores de los parámetros juntos
    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: usar MD5 / HMAC para cifrar
    byte[] bytes;
    if (Constants.SIGN_METHOD_HMAC.equals(signMethod)) {
        bytes = encryptHMAC(query.toString(), seccode);
    } else {
        query.append(seccode);
        bytes = encryptMD5(query.toString());
    }
 
    // 4: convertir binario a hexadecimal en mayúsculas
    volver byte2hex (bytes);
}
 
public static byte[] encryptHMAC(String data, String seccode) throws IOException {
    byte[] bytes = nulo;
    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();
}

Obtener acceso token

descripción

El consumidor (el servidor del distribuidor) debe almacenar el acceso_token localmente, NO obtenga el acceso_token por solicitud, de otro modo, use el acceso_token local antes volverse inválido. El servidor de JIMI no permitirá el acceso si la frecuencia de solicitud del consumidor es demasiado alta.

El acceso de token puedese usar hacia 2 horas (depende del valor del parámetro vencimiento_en), NO intente obtener token para cada solicitud.

Solicitar URL

Ver la solicitar de URL único.Método = jimi.oauth.token.get

Método de solicitud HTTP

POST

Solicitar parámetro

(1) Parámetros comunes

(2) Parámetros privados

Nombre	Tipo	Requerido	descripción	Código	Defecto
usuario_id	cuerda	Sí	ID de usuario	Cuenta de usuario
usuario_pwd_md5	cuerda	Sí	contraseña de usuario (md5)		Lowercase md5 valor
vencimiento_en	Cuerda	Sí	acceso de token vence en segundos	60-7200

Respuesta

Clave	Tipo	descripción
código	int	Código de retorno: 0: regresar correctamente Otro: falla. Consultar la descripción del código de error.
mensaje	cuerda	Si el código no es 0, existe un mensaje correspondiente de error
resultado	cuerda	Resultado
accessToken	cuerda	Acceso de token, es necesario para el acceso posterior a la interfaz.
vencer en	cuerda	acceso de token vence en segundos
cuenta	cuerda	Cuenta de usuario
Clave de APP	cuerda	Desde JIMI
refrescarToken	cuerda	Actualizar token a actualizar el acceso de token
Tiempo	cuerda	Tiempo de generar token

Ejemplo de las Respuestas correctas：

{
  "código": 0,
  "mensaje": "success",
  "resultado": {
  "Clave de APP": "8FB345B8693CCD003CC2DAB61EC8791D",
  "cuenta": "jimitest",
  "Acceso deToken": "7da3330ec28e3996b6ef4a7e3390ba71",
  "vencerEn": 60
  "refrescarToken": "7da3330ec28e3996b6ef4a7e3390ba71",
  "tiempo": "2017-06-15 10:00:00"
  }
}

Ejemplo vuelto de error:

{"código":xxx,"mensaje":"Nombre de usuario o contraseña incorrectos"}

Demo de cartero:

user_id = su cuenta de tracksolid.
user_pwd_md5 = md5 (la contraseña de su cuenta de tracksolid)
signo = md5 ( su valor clave de parámetros por orden de alfabética, sin signo igual, coma y sin componer el campo de signo ).

Por ejemplo:

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

Actualizar el acceso de token

descripción

Esta interfaz es utilizado a actualizar token manualmente cuando el acceso de token no está válido.

Solicitar URL

Consultar la URL de solicitud única.Método = jimi.oauth.token.refresh

Método de solicitud HTTP

POST

Solicitar parámetro

(1) Parámetros comunes

(2) Parámetros privados

parámetro	Tipo	Requerido	descripción	Código
acceso_token	cuerda	Sí	Acceso de token
refresh_token	cuerda	Sí	Acceso de token de actualización autorizado
vencimiento_en	Cuerda	Sí	acceso de token vence en segundos	60-7200

Respuesta

Clave	Tipo	descripción
código	int	Código de retorno: 0: regresar correctamente Otro: falla. Consultar la descripción del código de error.
mensaje	cuerda	Si el código no es 0, existe un mensaje correspondiente de error
Resultado	cuerda	Result
accessToken	cuerda	Acceso de token, es necesario para el acceso posterior a la interfaz.
vencer en	cuerda	acceso de token vence en segundos
cuenta	cuerda	Cuenta solicitada
Clave de APP	cuerda	Desde JIMI
refrescarToken	cuerda	Actualizar token a actualizar el acceso de token
Tiempo	cuerda	Tiempo de generar token

Ejemplo de las Respuestas correctas:

{
  "código": 0,
  "mensaje": "success",
  "resultado": {
    "Clave de APP": "8FB345B8693CCD003CC2DAB61EC8791D",
    "cuenta": "jimitest",
    "Acceso deToken": "7da3330ec28e3996b6ef4a7e3390ba71",
    "vencerEn": 60,
	"refrescarToken": "7da3330ec28e3996b6ef4a7e3390ba71",
	"tiempo": "2017-06-15 10:00:00"
  }
}

Ejemplo vuelto de error:

{"código":xxx,"mensaje":"Solicitud ilegal, token no es válido"}

Listar todas las sub-cuentas

descripción

Listar todas las sub-cuentas de una cuenta específica.

Solicitar URL

Consultar la URL de solicitud única.Método = jimi.user.child.list

Método de solicitud HTTP

POST

Solicitar parámetro

(1) Parámetros comunes

(2) Parámetros privados

parámetro	Tipo	Requerido	Código	descripción
acceso_token	cuerda	Sí		Acceso de token es para acceso de seguridad al servidor de JIMI.
objeto	cuerda	Sí	-	La cuenta especificada para consultada.

Respuesta

Clave	Tipo	descripción
código	int	Código de retorno: 0: regresar correctamente Otro: falla. Consultar la descripción del código de error.
mensaje	cuerda	Si el código no es 0, existe un mensaje correspondiente de error
Resultado:	cuerda	Resultado:

Resultado:

Clave	Tipo	descripción
cuenta	cuerda	Iniciar sesión
nombre	cuerda	Nombre
tipo	int	Tipo de cuenta 3: usuario de APP 8: Distribuidor 9: usuarios normales 10: distribuidor ordinario 11: ventas
mostrar bandera	int	Disponible o no (1: disponible, 0: no disponible)
dirección	cuerda	Ubicación
nacimiento	cuerda	Cumpleaños
nombre de compañía	cuerda	Nombre de compañía
correo electrónico	cuerda	Buzón
teléfono	cuerda	Número de contacto
idioma	cuerda	Idioma (zh, en)
sexo	int	Sexo: 0 hombre, 1 mujer
Bandera Habilitada	int	Bandera: 1 disponible, 0 no disponible
observación	cuerda	Código

Correcto ejemplo vuelto:

{
  "código": 0,
  "mensaje": "success",
  "resultado": [
    {
      "cuenta": "123123",
      "nombre": "test",
      "tipo": 8,
      "mostrarBandera": 1,
      "dirección": nulo,
      "nacimiento": "2017-04-22 00:00:00",
      "nombre de empresa": "",
      "correo electrónico": "",
      "teléfono": "",
      "idioma": "zh",
      "sexo": 0,
      "bandera habilitada": 1,
      "observación": nulo
    }
  ]
}

Ejemplo vuelto de error:

{"código":xxx,"mensaje":"sin permisos"}

Crear sub-cuenta

descripción

Crear una sub-cuenta de una cuenta específica.

Solicitar URL

Consultar la URL de solicitud única.Método = jimi.user.child.create

Método de solicitud HTTP

POST

Solicitar parámetro

(1) Parámetros comunes

(2) Parámetros privados

parámetro	Tipo	Requerido	Código	descripción
acceso_token	cuerda	Sí		Acceso de token es para acceso de seguridad al servidor de JIMI.
super_cuenta	cuerda	No	-	La cuenta principal especificada. Si no se ofrece, utilice la cuenta API en su lugar.
ID de la cuenta	cuerda	Sí	-	identidad de cuenta, longitud de 3 ~ 30 caracteres. Soporta los caracteres especiales como "_ @". tal como a-Z, 0-9.
apodo	cuerda	Sí	-	Apodo o nombre del cliente
Tipo de cuenta	int	Sí	-	1-Distribuidor 2-Usuario final 3-Ventas
contraseña	cuerda	Sí	-	Contraseña con md5.
teléfono	cuerda	No	-
Correo electrónico	cuerda	Sí	-	El usuario puede recuperar la contraseña si la olvida.
persona de contacto	cuerda	No	-
nombre de compañía	cuerda	No	-
permisos	cuerda	Sí	-	Web de Inicio de sesión APP de Iniciar sesión Enviar comando Establecer modo de trabajo Editar por Web Editar por APP 6 dígitos representan el permiso de habilitar / deshabilitar.

Respuesta

Clave	Tipo	descripción
código	int	Código de retorno: 0: regresar correctamente Otro: falla. Consultar la descripción del código de error.
mensaje	cuerda	Si el código no es 0, existe un mensaje correspondiente de error
resultado	cuerda	Resultado

Correcto vuelto ejemplo：

{
  "código": 0,
  "mensaje": "Modificación correcta de la información del vehículo",
  "resultado": nulo
}

Ejemplo vuelto de error:

{"código":xxx,"mensaje":"sin permisos"}

Mover cuenta

descripción

Mueve la cuenta de una sub-cuenta a la otra.

Solicitar URL

Consultar la URL de solicitud única.Método = jimi.user.child.del

Método de solicitud HTTP

POST

Solicitar parámetro

(1) Parámetros comunes

(2) Parámetros privados

parámetro	Tipo	Requerido	Código	descripción
acceso_token	cuerda	Sí		Acceso de token es para acceso de seguridad al servidor de JIMI.
super_cuenta	cuerda	No	-	La cuenta principal especificada. Si no se ofrece, utilice la cuenta API en su lugar.
ID de la cuenta	cuerda	Sí	-	identidad de cuenta, longitud de 3 ~ 30 caracteres. Soporta los caracteres especiales como "_ @". tal como a-Z, 0-9.

Respuesta

Clave	Tipo	descripción
código	int	Código de retorno: 0: regresar correctamente Otro: falla. Consultar la descripción del código de error.
mensaje	cuerda	Si el código no es 0, existe un mensaje correspondiente de error
resultado	cuerda	Resultado

Correcto vuelto ejemplo：

{
  "código": 0,
  "mensaje": "Modificación correcta de la información del vehículo",
  "resultado": nulo
}

Ejemplo vuelto de error:

{"código":xxx,"mensaje":"sin permisos"}

Eliminar sub-cuenta

descripción

Eliminar una sub-cuenta de una especial

Solicitar URL

Consultar la URL de solicitud única.Método = jimi.user.child.move

Método de solicitud HTTP

POST

Solicitar parámetro

(1) Parámetros comunes

(2) Parámetros privados

parámetro	Tipo	Requerido	Código	descripción
acceso_token	cuerda	Sí	-	Acceso de token es para acceso de seguridad al servidor de JIMI.
super_cuenta	cuerda	No	-	La cuenta principal especificada. Si no se ofrece, utiliza la cuenta de API en su lugar.
ID de la cuenta	cuerda	Sí	-	identidad de cuenta, longitud de 3 ~ 30 caracteres. Soporta caracteres especiales como "_ @". tal como a-Z, 0-9.

Respuesta

Clave	Tipo	descripción
código	int	Código de retorno: 0: regresar correctamente Otro: falla. Consultar la descripción del código de error.
mensaje	cuerda	Si el código no es 0, existe un mensaje correspondiente de error
resultado	cuerda	Resultado

Correcto vuelto ejemplo:

{
  "código": 0,
  "mensaje": "Modificación correcta de la información del vehículo",
  "resultado": nulo
}

Ejemplo vuelto de error:

{"código":xxx,"mensaje":"sin permisos"}

Listar todos dispositivos de sub-cuentas

descripción

Consultar todos los dispositivos de una cuenta específica.

Solicitar URL

Consultar la URL de solicitud única.Método = jimi.user.device.list

Método de solicitud HTTP

POST

Solicitar parámetro

(1) Parámetros comunes

(2) Parámetros privados

parámetro	Tipo	Requerido	descripción	Description
acceso_token	cuerda	Sí		Acceso de token es para acceso de seguridad al servidor de JIMI.
objeto	cuerda	Sí	-	La cuenta especificada para consultada.

Respuesta

Clave	Tipo	descripción
código	int	Código de retorno: 0: regresar correctamente Otro: falla. Consultar la descripción del código de error.
mensaje	cuerda	Si el código no es 0, existe un mensaje correspondiente de error
resultado	cuerda	Dato vuelto
imei	cuerda	IMEI Dispositivo
nombre del dispositivo	cuerda	Nombre del dispositivo
McTipo	cuerda	Modelo de dispositivo
mcTipo Uso alcance	cuerda	Coche, electromóvil, personal, mascota, avión, otros
sim	cuerda	Número de tarjeta de SIM
vencimiento	cuerda	Fecha de vencimiento de plataforma
Tiempo de activar	cuerda	Tiempo de activación
observación	cuerda	Observaciones
Nombre de Vehículo	cuerda	Nombre del vehículo
Icono de Vehículo	cuerda	Icono de vehículo
número de vehículo	cuerda	Numero de licencia
Vehículos e Modelos	cuerda	Marca
marco del coche	cuerda	VIN
nombre del conductor	cuerda	Nombre del conductor
Móvil de conductor	cuerda	Número de teléfono del conductor
Bandera Habilitada	int	Disponible o no (1: disponible, 0: no disponible)
Número de motor	cuerda	Número de motor

Correcto ejemplo vuelto：

{
  "código": 0,
  "mensaje": "success",
  "resultado": [
    {
      "imei": "868120145233604",
      "nombre del dispositivo": "868120145233604",
      "mcTipo": "GT300L",
      "mcTipo Uso Scope": "personal",
      "sim": "415451",
      "vencimiento": "2037-04-01 23:59:59",
      "Tiempo de activar": "2017-04-01 11:02:20",
      "observación": "prueba",
      "Nombre de Vehículo": nulo,
      "Icono de Vehículo": "bus",
      "vehicleNumber": "粤B3604",
      "número de vehículo": nulo,
      "marco del coche": "2235",
      "nombre del conductor": "controlador",
      "controlador": "13825036579",
      "Bandera Habilitada": 1,
      "Bandera Habilitada": "8565674"
    }
  ]
}

Ejemplo vuelto de error:

{"código":xxx,"mensaje":"La cuenta consultada no existe"}

Obtener la información en detalle del dispositivo

descripción

Obtener la información en detalle del dispositivo para un IMEI específico.

Solicitar URL

Consultar la URL de solicitud única.Método = jimi.track.device.detail

Método de solicitud HTTP

POST

Solicitar parámetro

(1) Parámetros comunes

(2) Parámetros privados

parámetro	Tipo	Requerido	Código	descripción
acceso_token	cuerda	Sí		Acceso de token es para acceso de seguridad al servidor de JIMI.
IMEI	cuerda	Sí	-	El IMEI especificado para consultado.

Respuesta

Clave	Tipo	descripción
código	int	Código de retorno: 0: regresar correctamente Otro: falla. Consultar la descripción del código de error.
mensaje	cuerda	Si el código no es 0, existe un mensaje correspondiente de error
resultado	cuerda	Dato vuelto
imei	cuerda	IMEI Dispositivo
nombre del dispositivo	cuerda	Nombre del dispositivo
McTipo	cuerda	Modelo de dispositivo
mcTipo Uso alcance	cuerda	Coche, electromóvil, personal, mascota, avión, otros
SIM	cuerda	Número de tarjeta de SIM
vencimiento	cuerda	Fecha de vencimiento de plataforma
usuario_vencimiento	cuerda	Fecha de vencimiento del usuario, formato como: cuenta1,2019-01-01 \| cuenta2,2019-02-02
Tiempo de activar	cuerda	Tiempo de activación
observación	cuerda	Código
Nombre de Vehículo	cuerda	Nombre del vehículo
Icono de Vehículo	cuerda	Icono de vehículo
número de vehículo	cuerda	Numero de licencia
Vehículos e Modelos	cuerda	Modelo de vehículo
marco del coche	cuerda	VIN
nombre del conductor	cuerda	Nombre del conductor
Móvil de conductor	cuerda	Número de teléfono del conductor
Bandera Habilitada	int	Disponible o no (1: disponible, 0: no disponible)
Número de motor	cuerda	Número de motor
ICCID	cuerda
Tiempo de importar	cuerda
IMSI	cuerda
Licencia de PlatNo	cuerda
VIN	cuerda
Marca de Vehículo	cuerda
combustible_100km	cuerda	Consumo de combustible por cada 100 km.
estado	cuerda	0-deshabilitar 1-habilitar

Correct return example：

{
  "código": 0,
  "mensaje": "success",
  "resultado":
    {
      "imei": "868120145233604",
      "nombre del dispositivo": "868120145233604",
      "McTipo": "GT300L",
      "mcTipo Uso alcance": "personal",
      "sim": "415451",
      "vencimiento": "2037-04-01 23:59:59",
      "Tiempo de Activar": "2017-04-01 11:02:20",
      "observación": "prueba",
      "Nombre de Vehículo": nulo,
      "Vehículo Icono": "bus",
      "número de vehículo": "粤B3604",
      "Modelos de Vehículos": nulo,
      "marco del coche": "2235",
      "nombre del conductor": "driver",
      "Móvil de conductor": "13825036579",
      "bandera habilitada": 1,
      "Número de motor": "8565674",
      "iccid": "xxxxxxx",
      "imsi": "xxxx",
      "Tiempo de importar": "2017-04-01 11:02:20",
      "Licencia de PlatNo": "8565674",
      "VIN": "xxxxxxx",
      "Marca de Vehículo": "xxxx",
      "combustible_100km": "9",
      "status": "8565674"
    }
}

Ejemplo vuelto de error:

{"código":xxx,"mensaje":"La cuenta consultada no existe"}

Obtener la ubicación de los dispositivos por cuenta

descripción

Obtener la ubicación última para todos los dispositivos de una cuenta.

Solicitar URL

Consultar la URL de solicitud única.Método = jimi.user.device.location.list

Método de solicitud HTTP

POST

Solicitar parámetro

(1) Parámetros comunes

(2) Parámetros privados

parámetro	Tipo	Requerido	Código	descripción
acceso_token	cuerda	Sí		Acceso de token es para acceso de seguridad al servidor de JIMI.
objeto	cuerda	Sí	-	Especificar la cuenta para consultar.
mapa_tipo	cuerda	No	-	mapa_tipo = GOOGLE, calibrado por la calibración de Google. mapa_tipo = nulo, devolver la latitud y la longitud del origen

Respuesta

Clave	Tipo	descripción
código	int	Código de retorno: 0: regresar correctamente Otro: falla. Consultar la descripción del código de error.
mensaje	cuerda	Si el código no es 0, existe un mensaje correspondiente de error
resultado	cuerda	Dato vuelto
IMEI	cuerda	IMEI Dispositivo
nombre del dispositivo	cuerda	Nombre del dispositivo
icono	cuerda	Icono de vehículo
estado	cuerda	Estado del dispositivo 0 - fuera de línea; 1 - en línea
Lat	doble	Longitud (si el dispositivo está caducado, el valor es 0)
Lng	doble	Latitud (si el dispositivo caducó, el valor es 0)
Bandera de vencer	cuerda	Caducado o no: 1- caducado; 0 - no caducado
Bandera de activar	cuerda	Activar o no 1 - Activar; 0 - No activo
posTipo	cuerda	GPS, LBS, WIFI, BALIZA
locDesc	cuerda	Información sobre la ubicación
gpsTiempo	cuerda	Tiempo de posicionamiento de GPS
hbTiempo	cuerda	Tiempo de latido
Velocidad	cuerda	Velocidad (unidad: km / h)
Estado de acc	cuerda	ACC 0-APAGADO; 1 ENCENDIDO
Elect Cantidad	cuerda	Batería del dispositivo (0-100), algunos modelos no son compatibles
Valor de Energía	cuerda	Voltaje externo (0-100), algunos modelos no son compatibles

Correcto ejemplo vuelto:

{
  "código": 0,
  "mensaje": "success",
  "resultado": [
    {
      "imei": "868120145233604",
      "nombre del dispositivo": "868120145233604",
      "icono": "bus",
      "estado": "0",
      "posTipo": "GPS",
      "lat": 22.577282,
      "lng": 113.916604,
      "hbTiempo": "2017-04-26 09:14:50",
      "accEstado": "0",
      "Velocidad": "0",
      "gpsTiempo": "2017-04-26 09:17:46",
      "Bandera de activar": "1",
      "Bandera de vencer": "1",
      "electCantidad": "60",
      "locDesc": nulo
      "Valor de Energía": nulo
    }
  ]
}

Ejemplo vuelto de error:

{"código":xxx,"mensaje":"sin permisos"}

OBTENER LA UBICACIÓN DE LOS DISPOSITIVOS

descripción

OBTENERLA LA UBICACIÓN ÚLTIMA PARA UNO O VARIOS DISPOSITIVOS.

Solicitar URL

Consultar la URL de solicitud única.Método = jimi.device.location.get

Método de solicitud HTTP

POST

Solicitar parámetro

(1) Parámetros comunes

(2) Parámetros privados

parámetro	Tipo	Requerido	Código	descripción
acceso_token	cuerda	Sí		Acceso de token para acceso de seguridad al servidor de JIMI.
imei	cuerda	Sí	-	IMEI dispositivo. Separe imei por coma; Se recomienda POST si hay demasiados dispositivos (máximo 100 IMEI)
mapa_tipo	cuerda	No	-	mapa_tipo = GOOGLE, calibrado por la calibración de Google. mapa_tipo = nulo, devolver la latitud y la longitud del origen

Respuesta

Clave	Tipo	descripción
código	int	Código de retorno: 0: regresar correctamente Otro: falla. Consultar la descripción del código de error.
mensaje	cuerda	Si el código no es 0, existe un mensaje correspondiente de error
resultado	cuerda	Dato vuelto

LISTA DE RESULTADO:

Clave	Tipo	descripción
IMEI	cuerda	IMEI Dispositivo
nombre del dispositivo	cuerda	Nombre del dispositivo
Icon	cuerda	Icono de vehículo
estado	cuerda	Estado del dispositivo 0, fuera de línea; 1, en línea
Lat	doble	Longitud (si el dispositivo está caducado, el valor es 0)
Lng	doble	Latitud (si el dispositivo caducó, el valor es 0)
Bandera de vencer	cuerda	1- caducado; 0 - no caducado
Bandera de activar	cuerda	1 - Activar; 0 - No activo
posTipo	cuerda	GPS, LBS, WIFI, BEACON
locDesc	cuerda	Información sobre la ubicación
gpsTiempo	cuerda	Tiempo de posicionamiento de GPS
hbTiempo	cuerda	Tiempo de latido
velocidad	cuerda	Velocidad (unidad: km / h)
Acc Estado	cuerda	ACC 0-APAGADO; 1 ENCENDIDO
Elect Cantidad	cuerda	batería （0-100）, algunos modelos de dispositivos no son compatibles
Valor de Energía	cuerda	Voltaje externo （0-100), algunos modelos de dispositivos no son compatibles
distancia	cuerda	Distancia del dispositivo.

Correcto vuelto ejemplo:

{
  "código": 0,
  "mensaje": "success",
  "resultado": [
    {
      "imei": "868120145233604",
      "nombre del dispositivo": "868120145233604",
      "icono": "bus",
      "estado": "0",
      "posTipo": "GPS",
      "lat": 22.577282,
      "lng": 113.916604,
      "hbTiempo": "2017-04-26 09:14:50",
      "accEstado": "0",
      "Velocidad": "0",
      "gpsTiempo": "2017-04-26 09:17:46",
      "Bandera de activar": "1",
      "Bandera de vencer": "1",
      "electCantidad": "60",
      "locDesc": nulo
      "Valor de Energía": nulo
    }
  ]
}

Ejemplo vuelto de error:

{"código":xxx,"mensaje":"Dispositivo ilegal"}

descripción

Obtener URL de ubicación del dispositivo mostrado en el Mapa.

Solicitar URL

Consultar la URL de solicitud única.Método = jimi.device.location.URL.share

Método de solicitud HTTP

POST

Solicitar parámetro

(1) Parámetros comunes

(2) Parámetros privados

parámetro	Tipo	Requerido	Código	descripción
acceso_token	cuerda	Sí		Acceso de token para acceso de seguridad al servidor de JIMI.
imei	cuerda	Sí	-	IMEI Dispositivo

Respuesta

Clave	Tipo	descripción
código	int	Código de retorno: 0: regresar correctamente Otro: falla. Consultar la descripción del código de error.
mensaje	cuerda	Si el código no es 0, existe un mensaje correspondiente de error
resultado	cuerda	Los datos vueltos contienen información de URL.

Correcto vuelto ejemplo:

{
  "código": 0,
  "mensaje": "success",
  "resultado":
    {
      "URL": "data.16180track.com/api/share?ver=2&method=trackDevice_abr&deviceinfo=7ae7c62385f2067f164002db315854a969a40e3888021cb01dc8f2183ca08dbbd8581f6bb86df4c2e3e1b887cb67c21039b4c0ced18fdf8dd08e0460c5edd13ad87e16dca9702ce6",
    }
}

Ejemplo vuelto de error:

{"código":xxx,"mensaje":"Dispositivo ilegal"}

Actualizar la fecha de vencimiento del usuario de los dispositivos.

descripción

Solicitar URL

Consultar la URL de solicitud única.Método = jimi.user.device.expiration.update

Método de solicitud HTTP

POST

Solicitar parámetro

(1) Parámetros comunes

(2) Parámetros privados

parámetro	Tipo	Requerido	Código	descripción
acceso_token	cuerda	Sí		Acceso de token para acceso de seguridad al servidor de JIMI.
imei_lista	cuerda	Sí	-	IMEI de uno o varios dispositivos.
nuevo_vencimiento	cuerda	Sí	-	Fecha de vencimiento de nuevo usuario para dispositivos.

Respuesta

Clave	Tipo	descripción
código	int	Código de retorno: 0: regresar correctamente Otro: falla. Consultar la descripción del código de error.
mensaje	cuerda	Si el código no es 0, existe un mensaje correspondiente de error
resultado	cuerda	Los datos vueltos contienen información de URL.

Correcto vuelto ejemplo:

{
  "código": 0,
  "mensaje": "success",
  "resultado": [
    {
      "imei": "868120145233604",
      "Activar_resultado": "0",
      "Activar_msg": "update success"
},
{
      "imei": "868120145233605",
      "Activar_resultado": "1",
      "Activar_msg": "update failed, reason:xxxxxx"
    }

  ]
}

Ejemplo vuelto de error:

{"código":xxx,"mensaje":"Dispositivo ilegal"}

Obtener los datos de kilometraje de los dispositivos

descripción

Obtener los datos de kilometraje de los dispositivos de un rango de tiempo especificado.

Solicitar URL

Consultar la URL de solicitud única.Método = jimi.device.track.mileage

Método de solicitud HTTP

POST

(1) Parámetros comunes

(2) Parámetros privados

Solicitar parámetro

parámetro	Tipo	Requerido	Código	descripción
acceso_token	cuerda	Sí	-	Acceso de token: se utiliza para identificar al consumidor legal.
imeis	cuerda	Sí	-	Dispositivo imeis, separados por comas.
inicio_tiempo	número	Sí	-	Formato: año-mes-día HH: mm: ss
tiempo de finalización	número	Sí	-	tiempo de inicio
inicio_fila	número	No	-	Formato: año-mes-día HH: mm: ss
tamaño de página	número	No	-	Tiempo de finalización

Respuesta:

Clave	Tipo	descripción
código	int	Código de retorno: 0: regresar correctamente Otro: falla. Consultar la descripción del código de error.
mensaje	cuerda	Si el código no es 0, existe un mensaje correspondiente de error
resultado	cuerda	Dato vuelto
imei	cuerda	IMEI Dispositivo
Tiempo de inicio	cuerda	Tiempo de inicio
Tiempo de cabo	cuerda	Tiempo de cabo
iniciarLat	cuerda	Latitud de la posición inicial.
iniciarLng	cuerda	Longitud de la posición inicial.
caboLat	cuerda	Latitud de la posición final.
caboLng	cuerda	Longitud de la posición final.
Correo tiempo segundo	int	Segundo transcurrido entre la posición inicial y final.
distancia	Double	Distancia (metros) entre la posición inicial y final.
avgvolecidad	Double	Velocidad media

Por ejemplo:

{
  "código": 0,
  "mensaje": "success",
  "resultado": [
{
    "imei": “3505831983422342”,
    "Tiempo de inicio": "2017-04-26 00:00:58",
    "Tiempo de cabo": "2017-04-26 00:03:58",
    "IniciarLat": 22.577144898887813,
    "IniciarLng": 113.91674845964586,
    "CaboLat": 22.677144898887813,
    "CaboLng": 113.92674845964586,
    "pasar": 2130,
    "distancia": 25000,
    "avgVelocidad": 90
    }
  ]
}

Obtener los datos de rastreo del dispositivo

descripción

Obtener los datos de rastreo del dispositivo de no más de 2 días, dentro de los 3 meses.

Solicitar URL

Consultar la URL de solicitud única.Método = jimi.device.track.list

Solicitar parámetro

(1) Parámetros comunes

(2) Parámetros privados

Método de solicitud HTTP

POST

Solicitar parámetro

parámetro	Tipo	Requerido	Código	descripción
acceso_token	cuerda	Sí	-	Acceso de token: se utiliza para identificar al consumidor legal.
imei	cuerda	Sí	-	descripción
Tiempo de inicio	Cuerda	Sí	-	Tiempo de inicio Formato: año-mes-día HH:mm:ss
Tiempo de cabo	Cuerda	Sí	-	Tiempo de cabo Formato: yyyy-MM-dd HH:mm:ss
mapa_tipo	cuerda	No	-	apa_tipo = GOOGLE, calibrado por la calibración de Google. mapa_tipo = nulo, devolver la latitud y la longitud del origen

Respuesta:

Clave	Tipo	descripción
código	int	Código de retorno: 0: regresar correctamente Otro: falla. Consultar la descripción del código de error.
mensaje	cuerda	Si el código no es 0, existe un mensaje correspondiente de error
resultado	cuerda	Dato vuelto
lng	doble	Longitud
lat	doble	Latitud
gpsTiempo	cuerda	Tiempo de posicionamiento de GPS. Formato año-Mes-día HH: mm: ss
dirección	cuerda	Dirección, coordenadas polares inician desde el norte
gpsVolecidad	cuerda	Velocidad de GPS
posTipo	cuerda	1-GPS 2-LBS 3-WIFI
satélite	cuerda	Intensidad de la señal de la antena de GPS

Correcto vuelto ejemplo:

{
  "código": 0,
  "mensaje": "success",
  "resultado": [
    {
      "lat": 22.577144898887813,
      "lng": 113.91674845964586,
      "gpsTiempo": "2017-04-26 00:00:58",
      "dirección": 0,
      "gpsVelocidad": -1,
      "posType": 3
    },
    {
      "lat": 22.57708,
      "lng": 113.916631,
      "gpsTiempo": "2017-04-26 00:01:30",
      "dirección": 184,
      "gpsVelocidad": 0,
      "posTipo": 1
    }
  ]
}

Ejemplo vuelto de error:


{"código":xxx,"mensaje":"IMEI does not exist{353419031939627}"}

{"código":xxx,"mensaje":"The device has expired{353419031939627}"}

Actualizar la información del vehículo por IMEI

descripción

Actualizar la información del vehículo por IMEI

Solicitar URL

Consultar la URL de solicitud única.Método = jimi.open.device.update

Método de solicitud HTTP

POST

Solicitar parámetro

(1) Parámetros comunes

(2) Parámetros privados

parámetro	Tipo	Requerido	Código	descripción
acceso_token	cuerda	Sí	-	Acceso de token: se utiliza para identificar al consumidor legal.
imei	cuerda	Sí	-	IMEI Dispositivo
nombre del dispositivo	cuerda	No	-	Nombre del dispositivo
nombre_vehículo	cuerda	No	-	VNombre de vehículo
vehículo_icono	cuerda	No	-	Icono de vehículo
Número de placa del vehículo	cuerda	No	-	Número de placa del vehículo
Modelos de vehículos	cuerda	No	-	Numero de licencia
nombre del conductor	cuerda	No	-	Nombre del conductor
Teléfono de conductor	cuerda	No	-	Número de teléfono del conductor
estado del dispositivo	cuerda	No	-	0 - deshabilitar / 1-habilitar.

Respuesta:

Clave	Tipo	descripción
código	int	Código de retorno: 0: regresar correctamente Otro: falla. Consultar la descripción del código de error.
mensaje	cuerda	Si el código no es 0, existe un mensaje correspondiente de error
resultado	cuerda	Dato Vuelto podría ser en fila

Correcto vuelto ejemplo:

{
  "código": 0,
  "mensaje": "Modificación correcta de la información del vehículo",
  "resultado": nulo
}
Incorrecto vuelto ejemplo：
{"código":xxx,"mensaje":"imei no existe"}

cono de vehículo:

Icono clave	descripción
Coche	Coche
autobús	Autobús
por	Personas
mtc	Motocicleta
camión
Taxi
avión
autobús escolar
excavador
Embarcación
triciclo
policía mtc	Motocicleta de la policía
tractor
coche de policía
vaca
otro

Obtener Foto de Dispositivo o URL de Vídeo

descripción

Obtener foto de dispositivo o URL de vídeo que captura por cámara

Solicitar URL

Solicitar URLMétodo = jimi.device.media.URL

Método de solicitud HTTP

POST

Solicitar parámetro

(1) Parámetros comunes

(2) Parámetros privados

parámetro	Tipo	Tipo	Código	descripción
acceso_token	cuerda	Sí	-	Acceso de token: se utiliza para identificar al consumidor legal.
imei	cuerda	Sí	-	IMEI Dispositivo
cámara	cuerda	Sí	-	1 cámara frontal 2- cámara interior
Tipo de media	cuerda	Sí	-	1 -foto 2-video
Tiempo de inicio	fecha	No	-	Tiempo de inicio de la foto o el video creado.
Tiempo de cabo	fecha	No	-	Tiempo de cabo de la foto o el vídeo creado.
token	cuerda	No	-	Token utilizado para validar si se puede acceder a una foto o un vídeo o no.
página_no	int	No	-	Cero indexado, 0 por defecto.
tamaño de página	int	No	-	10 filas por defecto.

Respuesta:

Clave	Tipo	descripción
código	int	Código de retorno: 0: regresar correctamente Otro: falla. Consultar la descripción del código de error.
mensaje	cuerda	Si el código no es 0, existe un mensaje correspondiente de error
resultado	cuerda	Dato vuelto
plugar_URL	cuerda	URL de la miniatura de vídeo o foto.
archivo_URL	cuerda	URL de vídeo o foto.
tipo de mime	fecha	Crear tiempo de vídeo o foto.
tipo de media	fecha	1 foto 2 vídeo
Tipo de media	cuerda	1 -foto 2-video
cámara	cuerda	0 cámara frontal 1 cámara interior
tamaño del archivo	int	Tamaño de archivo de foto o video.

Correcto vuelto ejemplo:

{
  "código": 0,
  "mensaje": "Operación exitosa",
  "resultado": 
[
{
      "plugar_URL": “Q9GLAFFqfCrYF6YfQAcON4w4Ezs=/lhWse7ie3wtFrjuQZ22dLAk5CSaR”,
      "archivo_URL": “357730090345670_3949477_2019_04_29_12_32_38_01”,
      "archivo_URL": "video/mp4",
      "Tiempo de crear": 2019-04-29 10:32:43,
      "tipo de media": 2,
      "cámara": 1,
      "tamaño del archivo": 9949087
},
{
      "plugar_URL": “Q9GLAFFqfCrYF6YfQAcON4w4Ezs=/FhCrZEIy3518sR_ylOlqDg7w3Ju-”,
      "archivo_URL": “351609080120911_3949476_2019_04_29_18_32_12”,
      "tipo de mime": "video/3gpp",
      "Tiempo de crear": 2019-04-29 10:32:42,
      "tipo de medio": 2,
      "cámara": 1,
      "tamaño del archivo": 2411318
}
]
}

Ejemplo vuelto de error:

{"código":xxx,"mensaje":"imei no existe"}

Obtener la URL de Página de Transmisión en directo del Dispositivo

descripción

Obtener la URL de página de transmisión en directo & información de la última posición del Dispositivo

Solicitar URL

Consultar la URL de solicitud única.Método = jimi.device.live.page.url

Método de solicitud HTTP

POST

Solicitar parámetro

(1) Parámetros comunes

(2) Parámetros privados

parámetro	Tipo	Requerido	Código	descripción
acceso_token	cuerda	Sí	-	Acceso de token: se utiliza para identificar al consumidor legal.
imei	cuerda	Sí	-	IMEI Dispositivo
V	cuerda	No	-	Si v=2, es necesario proporcionar el parámetro de token, el servidor de Jimi utilizará token a validar la URL.
token	cuerda	No	-	Token se utiliza para validar si puede accederse al vídeo en directo o no.

Respuesta:

Clave	Tipo	descripción
código	int	Código de retorno: 0: regresar correctamente Otro: falla. Consultar la descripción del código de error.
mensaje	cuerda	Si el código no es 0, existe un mensaje correspondiente de error
resultado	cuerda	Dato vuelto
lng	doble	Longitud
lat	doble	Longitud
gpsTiempo	cuerda	Tiempo de posicionamiento de GPS. Formato año-mes-día HH: mm: ss
dirección	cuerda	Dirección, coordenadas polares inician desde el norte
gpsVolecidad	cuerda	Velocidad de GPS
posTipo	cuerda	1-GPS, 2-LBS, 3-WIFI
satélite	cuerda	Intensidad de la señal de la antena de GPS
VIN	cuerda	VIN
plateNo	cuerda	Numero de licencia
UrlCamera	cuerda	URL de la página de transmisión en directo

Correcto vuelto ejemplo:

{
  "código": 0,
  "mensaje": "Modificación correcta de la información del vehículo",
  "resultado": 
    {
      "lat": 22.577144898887813,
      "lng": 113.91674845964586,
      "gpsTiempo": "2017-04-26 00:00:58",
      "dirección": 0,
      "gpVelocidad": -1,
      "posTipo": 3,
      "satélite": 11,
      "VIN":  "V12345",
      "plateNo":"ABC-12345",
      "UrlCamera": "https://www.domain.com/device/video/35408343202342345",
    }
  

}

Ejemplo vuelto de error:

{"código":xxx,"mensaje":"imei no existe"}

Wi-Fi, análisis de localización de Estación de Base

descripción

Asignar por todo el dispositivo bajo la cuenta (10 veces/día/dispositivo. Todas las sub-cuentas compuestas)

Solicitar URL

Solicitar URLMétodo = jimi.lbs.address.get

Método de solicitud HTTP

POST

Solicitar parámetro

(1) Parámetros comunes

(2) Parámetros privados

parámetro	Tipo	Requerido	Código	descripción
acceso_token	cuerda	Sí	-	Acceso de token: se utiliza para identificar al consumidor legal.
imei	Cuerda	Sí	-	IMEI Dispositivo
lbs	Cuerda	No	-	（wifi/LBS: por lo menos uno）grupo de LBS inforamación (mcc,mnc,lac,cell,rssi)， max 7. Cada grupo tiene cinco, que no deben ser nulos y ordenados. MCC, China: 460 MNC LAC información, 2312 23222 CELL código: 23222 RSSI Semáforo-70
wifi	cuerda	No	-	（wifi/LBS: por lo menos uno） mac1,rssi1\| mac2,rssi2 MMac dirección, sin dos puntos en las ambos aprtes Rssi fuerza de signo

Respuesta:

Clave	Tipo	descripción
código	int	Código de retorno: 0: regresar correctamente Otro: falla. Consultar la descripción del código de error.
mensaje	cuerda	Si el código no es 0, existe un mensaje correspondiente de error
resultado	cuerda	Dato vuelto
lng	cuerda	Longitud
lat	cuerda	Latitud
precisión	cuerda	Más precisión, el valor mejor
dirección	cuerda	Dirección, las coordenadas polares inician desde el norte

Correcto vuelto ejemplo:

{
"código": 0,
"mensaje": "success",
"resultado": {
  "lat": 40.65615416521587,
  "lng": 109.89894039833524,
  "precisión": 0
}
}

Ejemplo vuelto de error:

{"código":xxx,"mensaje":"Dispositivo ilegal"}

Crear Geo-cerca para IMEI

descripción

Crear Geo-cerca para IMEI

Solicitar URL

Consultar la URL de solicitud única.Método = jimi.open.device.fence.create

Método de solicitud HTTP

POST

Solicitar parámetro

(1) Parámetros comunes

(2) Parámetros privados

parámetro	Tipo	Requerido	Código	descripción
acceso_token	cuerda	Sí	-	Accesotoken: se utiliza para identificar a la tercera parte legal
imei	cuerda	Sí	-	IMEI Dispositivo
nombre_de_cerca	cuerda	Sí	-	Nombre de Geo-cerca
tipo_de_alarma	cuerda	Sí	-	Tipo de alarma (entrada / salida / entrada, salida)
modo_de_informe	cuerda	Sí	-	Modo de informe de alarma, 0: GPRS, 1: SMS + GPRS
interruptor_de_alarma	cuerda	Sí	-	Interruptor de alarma de cerca ((ENCENDIDO/APAGADO))
lng	cuerda	Sí	-	Longitud
lat	cuerda	Sí	-	Latitud
radius	cuerda	Sí	-	Radio de cerca (1～9999 ； unidad: 100 metros)
nivel del enfoque	cuerda	Sí	-	Nivel de enfoque (3-19)
mapa_tipo	cuerda	Sí	-	Mapa (GOOGLE)

Respuesta:

Clave	Tipo	descripción
código	int	Código de retorno: 0: regresar correctamente Otro: falla. Consultar la descripción del código de error.
mensaje	cuerda	Si el código no es 0, existe un mensaje correspondiente de error
resultado	cuerda	Dato vuelto. Fence serial number returned if succeed.

Correcto vuelto ejemplo:


{
"código": 0,
"mensaje": "Crear geocerca correctamente.",
"resultado": "5"
}
Incorrecto vuelto ejemplo：
{
"código": 41003,
"mensaje": "El dispositivo no está en línea, y no llega a la creación de geocerca",
"resultado": nulo
}

Eliminar Geo-cerca para dispositivo

descripción

Eliminar Geo-cerca para dispositivo

Solicitar URL

Consultar la URL de solicitud única.Método = jimi.open.device.fence.delete

Método de solicitud HTTP

POST

Solicitar parámetro

(1) Parámetros comunes

(2) Parámetros privados

parámetro	Tipo	Requerido	Código	descripción
acceso_token	cuerda	Sí	-	Acceso de token: se utiliza para identificar a la tercera parte legal
imei	cuerda	Sí	-	IMEI Dispositivo
instruct_no	cuerda	Sí	-	Número de serie del comando de Geo-cerca

Respuesta:

Clave	Tipo	descripción
código	int	Código de retorno: 0: regresar correctamente Otro: falla. Consultar la descripción del código de error.
mensaje	cuerda	Si el código no es 0, existe un mensaje correspondiente de error
resultado	cuerda	Dato vuelto

Correcto vuelto ejemplo:

{
"código": 0,
"mensaje": "Eliminar la geocerca correctamente",
"resultado": nulo
}

Ejemplo vuelto de error:

{
"código": 41003,
"mensaje": "El dispositivo no está en línea y la geoce no se puede eliminarse",
"resultado": nulo
}

Obtener la lista de comandos compatible con el dispositivo

descripción

Obtener la lista de comandos compatible con el dispositivo

Solicitar URL

Consultar la URL de solicitud única.Método = jimi.open.instruction.list

Método de solicitud HTTP

POST

Solicitar parámetro

(1) Parámetros comunes

(2) Parámetros privados

parámetro	Tipo	Requerido	Código	descripción
acceso_token	cuerda	Sí	-	Acceso de token: se utiliza para identificar a la tercera parte legal
imei	cuerda	Sí	-	IMEI Dispositivo

Respuesta:

Clave	Tipo	descripción
código	int	Código de retorno: 0: regresar correctamente Otro: falla. Consultar la descripción del código de error.
mensaje	cuerda	Si el código no es 0, existe un mensaje correspondiente de error
resultado	cuerda	Resultado
identidad	cuerda	Código de comando
Nombre de orden	cuerda	Nombre del comando
Contenido de orden	cuerda	Plantilla de comando
Explicar orden	cuerda	Explicación del comando
Orden de Msg	cuerda	Rápido
fuera de línea	cuerda	Si es compatible con el comando fuera de línea 0-no; 1-sí

Correcto vuelto ejemplo:

{
"código": 0,
"mensaje": "success",
"resultado": [
  {
    "identidad": 81,
    "Nombre de orden": "Configuración SOS",
    "Configuración SOS": "SOS,A,{0},{1},{2}#",
    "Explicar orden": "SOS se utiliza a recibir las alertas y SOS. El número de SOS debe ser entre 3 y 20 números.",
    "Orden de Msg": "",
    "fuera de línea": "1"
  }
  ...
]
}

Ejemplo vuelto de error:

{"código":xxx,"mensaje":"Dispositivo ilegal"}

Enviar el comando al dispositivo

descripción

Enviar el comando al dispositivo

Solicitar URL

Solicitar URLMétodo = jimi.open.instruction.send

Método de solicitud HTTP

POST

Solicitar parámetro

(1) Parámetros comunes

(2) Parámetros privados

parámetro	Tipo	Requerido	Código	descripción
acceso_token	cuerda	Sí	-	Acceso de token: se utiliza para identificar a la tercera parte legal
imei	cuerda	Sí	-	IMEI Dispositivo
inst_param_json	cuerda	Sí	-	Mensaje de comando json de caracteres cuerda

inst_param_json descripción:

parámetro	Tipo	Requerido	Código	descripción
inst_identidad	cuerda	Sí	-	Código de comando
inst_modelo	cuerda	Sí	-	Código de comando
parámetros	formación	Sí	-	Formación de cuerda de comando de parámetros
ser_cubierto	boolean	NO	falso	Si cubra el comando existente está fuera de línea o no cubrrir-verdadero no-falso

Por ejemplo:

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

Comando de usuario-definido:

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

Respuesta:

Clave	Tipo	descripción
código	int	Código de retorno: 0: regresar correctamente Otro: falla. Consultar la descripción del código de error.
mensaje	cuerda	Si el código no es 0, existe un mensaje correspondiente de error
resultado	cuerda	Resultado

Correcto vuelto ejemplo:

{
  "código": 0,
  "mensaje": "el comando se envió correctamente.",
  "resultado": nulo
}

Ejemplo vuelto de error:

{
  "código": 12005,
  "mensaje": "Error DE enviar el comando. Código de resultado: 226",
  "resultado": nulo
}

Obtener los resultados de la ejecución de comandos

descripción

Obtener los resultados de la ejecución de comandos

Solicitar URL

Consultar la URL de solicitud única.Método = jimi.open.instruction.result

Método de solicitud HTTP

POST

Solicitar parámetro

(1) Parámetros comunes

(2) Parámetros privados

parámetro	Tipo	Requerido	Código	descripción
acceso_token	cuerda	Sí	-	Acceso de token: se utiliza para identificar a la tercera parte legal
imei	cuerda	Sí	-	IMEI Dispositivo

Respuesta:

Respuesta:	Tipo	descripción
código	int	Código de retorno: 0: regresar correctamente Otro: falla. Consultar la descripción del código de error.
mensaje	cuerda	Si el código no es 0, existe un mensaje correspondiente de error
resultado	cuerda	Dato vuelto
codeId	cuerda	Código de comando
código	cuerda	Comando enviado
contenido	cuerda	Contenido de respuesta por el dispositivo
ejecutar	cuerda	Estado del comando 0: ejecución de falla, 1: ejecución exitosa, 3: por enviar, 4: cancelado
fuera de línea	cuerda	Hora, formato: año-mes-día HH: mm: ss
remitente	cuerda	Remitente
recibir dispositivo	cuerda	Recibido imei
fuera de línea	cuerda	0: en línea 1: fuera de línea
fuente de identidad	cuerda	Descripción del comando

Correcto vuelto ejemplo:

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

Ejemplo vuelto de error:

{"código":xxx,"mensaje":"Dispositivo ilegal"}

Recibir la notificación

descripción

La plataforma de la tercera parte debe ofrecer una dirección de URL a recibir la notificación (haga el favor de comunicar con nosotros y ofrecer la URL manualmente), el servidor de JIMI envia la notificación enviando una solicitud de HTTP mediante el uso de esta URL.

Lista de servicios de mensajes

Lista de servicios de mensajes	descripción
jimi.push.device.alarm	Datos de Alarma

Solicitar contenido

Clave	Tipo	descripción
Tipo de msg	cuerda	Tipo de mensaje, correspondiente a la lista de servicios de mensajes
datos	cuerda	El contenido del mensaje, correspondiente al tipo de msg

Contenido del mensaje( jimi.push.device.alarm)

Las alarmas empujadas son las siguientes:

Clave	Tipo	Tipo
Tipo	cuerda	IMEI Dispositivo
nombre del dispositivo	cuerda	cuerda
Tipo de alarma	cuerda	Tipo de alarma
Nombre de alarma	cuerda	Nombre de alarma
lat	cuerda	Latitud
lng	cuerda	Longitud
Tiempo de alarma	cuerda	Tiempo de alarma, formato (año-Mes-día HH: mm: ss)

Por ejemplo:

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

Parameter2:
Key = data
Value =  {
    "imei": "868120145233604",
    "Nombre del dispositivo": "868120145233604",
    "Tipo de alarma": "2",
    "Nombre de alarma": "Power off alarm",
    "lat": 40.65615416521587,
    "lng": 109.89894039833524,
    "Tiempo de alarma": "2017-05-08 12:00:00"
  }

Obtener la lista de alarmas del dispositivo

descripción

Obtener la lista de alarmas del dispositivo
El rango de tiempo de los criterios de buscar debe ser dentro de 1 mes.
Devolver un máximo de 1,000 filas.

Solicitar URL

Consultar la URL de solicitud única.Método = jimi.device.alarm.list

Método de solicitud HTTP

POST

Solicitar parámetro

(1) Parámetros comunes

(2) Parámetros privados

parámetro	Tipo	Requerido	Código	descripción
acceso_token	cuerda	Sí	-	Acceso de token: se utiliza para identificar a la tercera parte legal
imei	cuerda	Sí	-	IMEI Dispositivo
Identidad de tipo de alerta	cuerda	No	-	Si no especifica el Identidad del tipo de alerta, todos los tipos de alertas vuelven.
inicio_tiempo	fecha	No	-	Si no ofrecen el tiempo de inicio y tiempo de cabo, vuelve las últimas 50 alertas del último mes.
Tiempo de cabo	fecha	No	-

Respuesta:

Clave	Tipo	descripción
código	int	Código de retorno: 0: regresar correctamente Otro: falla. Consultar la descripción del código de error.
mensaje	cuerda	Si el código no es 0, existe un mensaje correspondiente de error
resultado	cuerda	Dato vuelto
Nombre del dispositivo	Nombre del dispositivo	Command code
IMEI	cuerda	IMEI
model	cuerda	Modelo de dispositivo
cuenta	cuerda	Cuenta
cuenta	cuerda	Cuenta
cuenta	cuerda	Tipo de alerta
tiempo de alerta	cuerda	tiempo de alerta
tiempo de posicionamiento	cuerda	tiempo de posicionamiento de alerta
lng	doble	Longitud
lat	doble	Latitud

Correcto vuelto ejemplo:

{
  "código": 0,
  "mensaje": "success",
  "resultado": [
    {
      "Nombre del dispositivo": "ABC-34352",
      "IMEI": "343503422910345",
      "modelo": "GT06N",
      "cuenta": "test1234",
      "Identidad de tipo de alerta": "1002",
      "Tipo de alerta": "ACC On",
      "Tiempo de alerta": "2019-03-14 14:02:03",
      "Tiempo de posicionamiento": "2019-03-14 14:02:03",
      "lat": 22.577144898887813,
      "lng": 113.91674845964586
    }
  ]
}

Ejemplo vuelto de error:

{"código":xxx,"mensaje":"Dispositivo ilegal"}

Enviar el comando (para dispositivo de scooter)

descripción

Enviar el comando para dispositivo de scooter

Solicitar URL

Consultar la URL de solicitud única.Método = jimi.scooter.instruction.send

Método de solicitud HTTP

POST

Solicitar parámetro

(1) Parámetros comunes

(2) Parámetros privados

parámetro	Tipo	Requerido	Código	descripción
acceso_token	cuerda	Sí	-	Acceso de token: se utiliza para identificar a la tercera parte legal
imei	cuerda	Sí	-	IMEI Dispositivo
Código de cmd	cuerda	Sí	-	Enviar el comando al dispositivo, por ejemplo: Para habilitar el scooter, código de cmd puede configurarse como: : HABILITAR # Para bloquear el scooter, el código de cmd establecido como: Bloquear# Nota, requiere la signo #.

Respuesta:

Clave	Tipo	descripción
código	int	Código de retorno: 100: éxito 200：parámetro no válido 300: Dispositivo está fuera de línea 301：Dispositivo no registrado 400：Red no disponible 600: tiempo acabado de solicitud de HTTP
mensaje	cuerda	Descripción del resultado enviado del comando

Ejemplo de éxito:

{
  "código": 100,
  "mensaje": "Success"
}

Ejemplo vuelto de error:

{
  "código": 200,
  "mensaje": "Invalid parameter"
}

Obtener la información en detalle de scooter

descripción

Obtener la información y el estado del dispositivo.

Solicitar URL

Consultar la URL de solicitud única.Método = jimi.scooter.device.detail

Método de solicitud HTTP

POST

Solicitar parámetro

(1) Parámetros comunes

(2) Parámetros privados

parámetro	Tipo	Requerido	Código	descripción
acceso_token	cuerda	Sí	-	Accesstoken: used for identifying legal third party
imei	cuerda	Sí	-	IMEI of scooter, multiple scooter Separated by commas, for example: 350583223422451,350583223422452

Respuesta:

Clave	Tipo	descripción
código	int	Código de retorno: 0: regresar correctamente Otro: falla. Consultar la descripción del código de error.
mensaje	cuerda	Si el código no es 0, existe un mensaje correspondiente de error
resultado	cuerda	Dato vuelto(json)

LISTA DE RESULTADO:

Clave	Tipo	descripción
IMEI Dispositivo	cuerda	IMEI de IoT modelo
Estado en tiempo real	json	DLCC	DLCC estado 0 - Apagado 1 - Encendido
		freno	Estado de freno 0 - Apagado 1 - Encendido
		Ajuste de la luz de freno	Estado de ajuste de la luz de freno 0 - Apagado 1 - Encendido
		Ajuste de la luz delantera	Estado de ajuste de la luz delantera 0 - Apagado 1 - Encendido
		luz delantera de la real	Estado de luz delantera de la real 0 - Apagado 1 - Encendido
		luz de freno real	Estado de luz de freno real 0 - Apagado 1 - Encendido
		cargar	Estado de cargar 0 - Apagado 1 - Encendido
		Estado del acelerador	0 - Apagado 1 - Encendido
		Estado del motor	0 - Apagado 1 - Encendido
		modo de trabajo	Modo de conducción. 0 - Modo de discapacidad 1 - Modo de bloqueo 2 - Modo de habilitación 3 - Modo de cargar 4 - Modo de mantenimiento
Fecha en tiempo real	json	nivel de batería	Nivel de BAT, por ejemplo, si el nivel BAT = 50%, el valor del nivel de batería es 50.
		actual	Corriente de salida
		velocidad	Velocidad (pasillo)
		voltaje	Voltaje de BAT
		ciclo de batería	Ciclo de batería
		odómetro total	Kilometraje total
		odómetro actual	Kilometraje del viaje actual (antes desactivado).
		temperatura de batería	°C
		kilometraje restante	Kilometraje restante
Propiedades de scooter	json	versión deECU	versión deECU
		capacidad de batería	capacidad de batería
		voltaje de batería	voltaje de batería
		versión de firmware	versión de firmware
		versión de scooter	versión de scooter
		Límite de velocidad	Límite de velocidad de scooter
		IoT	0 - Sí 1-error
Error de scooter	json
		acelerador	0 - Sí 1-error
		batería	0 - Sí 1-error
		barra de manija de freno	0 - Sí 1-error
		controlador	0 - Sí 1-error
		tablero	0 - Sí 1-error
		voltaje	0 - Sí 1-error
		Motor	0 - Sí 1-error
IoT Modulo	json	Estado de gps	0-GPS no disponible 1-GPS posicionamiento
		curso	Dirección de posicionamiento
		satélite	Número de satélite
		velocidad de gps	velocidad
		Tiempo de gps	Tiempo de posicionamiento
		Tipo de posicionamiento	GPS LBS WIFI
		Latitud	Latitud
		signo de gsm	0-Sin señal 1-Extremadamente semana 2 semanas 3-Fuerte 4-Extremadamente fuerte
		mCC	mCC
		mNC	mNC
		BluetoothMac	cuerda
		iccid	cuerda
		imsi	cuerda
		batteryVoltage	Voltaje de batería

Correcto vuelto ejemplo:

{
  "código": 0,
  "msg": "Operation success.",
  "resultado": 
    {
      "IMEI Dispositivo": "860425040472944",
      "Error de scooter": {
        "IoT": 0,
        "accelerator": 0,
        "batería": 0,
        "barra de manija de freno": 0,
        "controller": 0,
        "tablero": 0,
        "motor": 0,
        "voltaje": 0
      },
      "Propiedad de scooter": {
        "ECUVersión": "0.1",
        "Capacidad de batería": 22834,
        "Voltaje de batería: 36,
        "bluetoothVersión": "2.1",
        "firmwareVersión": "c.0",
        "scooterVersión": "3.0",
        "Límite de velocidad": 50
      },
      "Fecha en tiempo real": {
        "Odómetro total": 14592,
        "Ciclo de batería": 512,
        "Nivel de batería": 56,
        "Temperatura de Batería": 23,
        "actual": 614.39,
        "Odómetro actual": 217.6,
        "kilometraje izquierdo": 69.2,
        "velocidad": 99.86,
        "voltaje": 460.94
      },
      "realtimeStatus": {
        "DLCC": 0,
        "DLCCStatus": 0,
        "Estado de acelerador": 0,
        "freno": 0,
        "Ajuste de Luz de freno": 1,
        "charge": 0,
        "Ajuste de luz delante": 0,
        "Luz delante real": 0,
        "Estado de motor": 0,
        "Luz de freno real": 0,
        "Modo de trabajo": 0
      },
      "drivingSetting": {
        "DLCC": 0,
        "Modo de Conducción": 2,
        "Modo de luz": 0,
        "Inicio Rápido": 1,
        "Límite de Velocidad": 30,
        "Unidad de Velocidad": 0
      },
      "IoTModule": {
        "imsi": "0460045394000271",
        "iccid": "89860433231880390271",
        "BluetoothMac": "000000000000",
        "satélite": 11,
        "curso": 0,
        "gpsModo": 0,
        "gpsVelocidad": 0,
        "satélite": "2019-05-09 18:41:12",
        "lAC": 0,
        "latitud": 22.577137,
        "longitud": 113.916756,
        "mCC": 0,
        "mNC": 0,
        "Tipo de Posición": "GPS",
        "gsmSigno": 4,
        "gpsEstado": 0,
        "bateríaVoltaje": 4.15
      }
    }
}

Correcto vuelto ejemplo:

{"código":xxx,"mensaje":"Dispositivo ilegal"}