Tous les produits
Search
Centre de documentation

IoT Platform:Messagerie

Dernière mise à jour :Aug 10, 2026

Le moteur de règles d'IoT Platform transfère les messages d'enregistrement, de désenregistrement et de soumission de données des appareils passerelle JT/T 808 vers vos serveurs. Vous pouvez également utiliser les abonnements côté serveur AMQP (Advanced Message Queuing Protocol) pour pousser les messages de soumission de données.

Notes d'utilisation

Lorsque vous configurez des règles de transfert de données, tenez compte des points suivants :

  • Seule la nouvelle version de la fonctionnalité de transfert de données prend en charge les appareils passerelle. Pour plus d'informations, consultez la rubrique Configurer un analyseur de transfert de données.

  • Les appareils ajoutés aux passerelles cloud JT/T 808 ne peuvent pas s'abonner à des topics. Il est impossible de transférer les données des appareils de passerelle cloud JT/T 808 vers un topic.

  • Pour utiliser le transfert de données avec les appareils de passerelle cloud JT/T 808, ajoutez des topics des types suivants comme source de données : Custom, Device Status Change Notification et Device Changes Throughout Lifecycle. Pour ajouter un topic personnalisé comme source de données, spécifiez l'ID du fabricant, le modèle d'appareil et l'ID d'appareil dans le nom du topic. Pour plus d'informations, consultez la rubrique Créer une source de données.

  • Les abonnements côté serveur prennent uniquement en charge les types de messages Device Upstream Notification, Device Status Change Notification et Device Changes Throughout Lifecycle. Pour plus d'informations, consultez la rubrique Configurer un abonnement côté serveur AMQP.

Enregistrement d'appareil

Topic : /sys/${productKey}/${deviceName}/device/identity/register.

payload: {
    "createTime": 1669968170000,
    "deviceId": "device05",
    "deviceModel": "model1",
    "deviceName": "manufactor_model1_device05",
    "instanceId": "iotx-o****",
    "iotId": "PkhDL********00101",
    "licensePlateColour": "1",
    "licensePlateNumber": "Zhe A****",
    "manufacturer": "manufactor",
    "productKey": "a16h****",
    "status": "register",
    "tenantId": "58CAC7******37C956"
}
|
**Parameter**
|
**Type**
|
**Description**
| | --- | --- | --- | |
payload
|
Object
|
Contenu du message d'enregistrement de l'appareil.
| |
createTime
|
Long
|
Heure de début de l'enregistrement de l'appareil.
| |
deviceId
|
String
|
ID d'appareil enregistré par l'utilisateur.
| |
deviceModel
|
String
|
Modèle d'appareil enregistré par l'utilisateur.
| |
deviceName
|
String
|
DeviceName. Format : `${manufacturer}_${deviceModel}_${deviceId}`.
| |
instanceId
|
String
|
ID de l'instance à laquelle l'appareil appartient.
| |
iotId
|
String
|
Identifiant unique de l'appareil dans IoT Platform.
| |
licensePlateColour
|
String
|
Couleur de la plaque d'immatriculation. La valeur doit être conforme aux exigences du protocole JT/T 808. Pour plus d'informations, consultez le document [JT/T 808-2019](https://help-static-aliyun-doc.aliyuncs.com/file-manage-files/zh-CN/20221220/mdsf/JT-T%20808-2019.pdf).
| |
licensePlateNumber
|
String
|
Numéro de plaque d'immatriculation.
| |
manufacturer
|
String
|
ID du fabricant de l'appareil.
| |
productKey
|
String
|
Identifiant unique du produit auquel l'appareil appartient.
| |
status
|
String
|
Statut de l'appareil. Définissez la valeur sur `register`, ce qui indique que l'appareil est enregistré.
| |
tenantId
|
String
|
ID de l'utilisateur auquel l'appareil appartient.
|



















































































Soumission du statut de l'appareil

Topic : /sys/${productKey}/${deviceName}/device/status/notify.

  • Format des données soumises par un appareil lors de sa mise en ligne :

    {
        "protocol": "jt808",
        "status":"online",
        "iotId":"4z819VQHk6VSLmmBJfrf00107e****",
        "productKey":"al12345****",
        "deviceName":"deviceName1234",
        "time":"2018-08-31 15:32:28.205",
        "utcTime":"2018-08-31T07:32:28.205Z",
        "lastTime":"2018-08-31 15:32:28.195",
        "utcLastTime":"2018-08-31T07:32:28.195Z",
        "clientIp":"192.0.2.1"
    }
  • Format des données soumises par un appareil lors de sa mise hors ligne :

    {
        "protocol": "jt808",
        "status":"offline",
        "iotId":"4z819VQHk6VSLmmBJfrf00107e****",
        "offlineReasonCode":427,
        "productKey":"al12345****",
        "deviceName":"deviceName1234",
        "time":"2018-08-31 15:32:28.205",
        "utcTime":"2018-08-31T07:32:28.205Z",
        "lastTime":"2018-08-31 15:32:28.195",
        "utcLastTime":"2018-08-31T07:32:28.195Z",
        "clientIp":"192.0.2.1"
    }

Paramètres

Parameter

Type

Description

protocol

String

Si vous utilisez une passerelle cloud JT/T 808, définissez la valeur sur jt808.

status

String

Statut de l'appareil.

  • online : En ligne.

  • offline : Hors ligne.

iotId

String

Identifiant unique de l'appareil dans IoT Platform.

offlineReasonCode

Integer

Code d'erreur lorsque l'appareil passe hors ligne. Codes d'erreur de comportement des appareils.

productKey

String

Identifiant unique du produit auquel l'appareil appartient.

deviceName

String

Nom de l'appareil.

lastTime

String

Obsolète. Plus utilisé.

utcLastTime

String

time

String

Heure à laquelle l'appareil est passé en ligne ou hors ligne.

Les messages ne sont pas triés par heure de mise en ligne/hors ligne. Triez-les selon la valeur time.

Par exemple, vous recevez les trois messages suivants dans l'ordre :

  1. En ligne : 2018-08-31 10:02:28.195.

  2. Hors ligne : 2018-08-31 10:01:28.195.

  3. Hors ligne : 2018-08-31 10:03:28.195.

Ces trois messages indiquent que l'appareil est passé hors ligne, puis en ligne, puis à nouveau hors ligne.

utcTime

String

Heure UTC à laquelle l'appareil est passé en ligne ou hors ligne.

clientIp

String

Adresse IP publique de l'appareil.

Soumission de données d'appareil

Topic : /sys/${productKey}/${deviceName}/device/message/uplink.

payload: {
    header:{
        messageId:"",
        version:"",
        phone:"",
        serialNumber:""
    },
    body:{
        data:"dGVzdDEyMw==",
        type: 65
    }
}

Parameter

Type

Description

payload

Object

Message soumis par l'appareil, incluant les paramètres header et body. Le contenu peut être des données en transit, des statistiques de localisation ou des données GPS.

header

Object

En-tête du message.

  • messageId : ID du message.

  • version : version du protocole.

  • phone : numéro de téléphone.

  • serialNumber : numéro de série du message. Valeurs valides : 0 à 65535. L'appareil incrémente le numéro de série d'une unité pour chaque message soumis.

Les valeurs des paramètres messageId, version et phone doivent être conformes aux exigences du protocole JT/T 808. Pour plus d'informations, consultez le document JT/T 808-2019.

body

Object

Corps du message.

  • data : contenu du message. Le contenu est encodé en Base64.

  • type : type du message en transit. Dans cet exemple, 65 représente 0x41, ce qui indique que le port série 1 est utilisé pour le transit des données.

Le corps du message doit être conforme aux exigences du protocole JT/T 808. Pour plus d'informations, consultez le document JT/T 808-2019.

Désenregistrement d'appareil

Topic : /sys/${productKey}/${deviceName}/device/identity/unregister.

payload: {
    "createTime": 1669968170000,
    "deviceId": "device05",
    "deviceModel": "model1",
    "deviceName": "manufactor_model1_device05",
    "instanceId": "iotx-o****",
    "iotId": "PkhDL********00101",
    "licensePlateColour": "1",
    "licensePlateNumber": "Zhe A****",
    "manufacturer": "manufactor",
    "productKey": "a16h****",
    "status": "register",
    "tenantId": "58CAC7******37C956"
}
|
**Parameter**
|
**Type**
|
**Description**
| | --- | --- | --- | |
payload
|
Object
|
Contenu du message de désenregistrement de l'appareil.
| |
createTime
|
Long
|
Heure de début du désenregistrement de l'appareil.
| |
deviceId
|
String
|
ID de l'appareil.
| |
deviceModel
|
String
|
Modèle de l'appareil.
| |
deviceName
|
String
|
DeviceName. Format : `${manufacturer}_${deviceModel}_${deviceId}`.
| |
instanceId
|
String
|
ID de l'instance à laquelle l'appareil appartient.
| |
iotId
|
String
|
Identifiant unique de l'appareil dans IoT Platform.
| |
licensePlateColour
|
String
|
Couleur de la plaque d'immatriculation. La valeur doit être conforme aux exigences du protocole JT/T 808. Pour plus d'informations, consultez le document [JT/T 808-2019](https://help-static-aliyun-doc.aliyuncs.com/file-manage-files/zh-CN/20221220/mdsf/JT-T%20808-2019.pdf).
| |
licensePlateNumber
|
String
|
Numéro de plaque d'immatriculation.
| |
manufacturer
|
String
|
ID du fabricant de l'appareil.
| |
productKey
|
String
|
Identifiant unique du produit auquel l'appareil appartient.
| |
status
|
String
|
Statut de l'appareil. Définissez la valeur sur `unregister`, ce qui indique que l'appareil est désenregistré.
| |
tenantId
|
String
|
ID de l'utilisateur auquel l'appareil appartient.
|