S'abonner à un appareil

Cette page explique comment obtenir une mise à jour des informations d'un appareil à chaque modification.

SSE /devices/{id}/updates

Cet endpoint utilise le mécanisme SSE (Server-Sent Events), une technologie de communication unidirectionnelle en temps réel. Il permet de recevoir instantanément toutes les mises à jour concernant les informations de l'appareil stockées dans l'API.

Headers

Name	Value
Content-Type	application/json
Authorization	Bearer <token>

Exemples d'implementation

NodeJS

JavaScript possède une implémentation native d'EventSource. Cependant, il est recommandé d'utiliser un polyfill d'EventSource (tel que "event-source-polyfill" dans cet exemple) pour accéder à des fonctionnalités avancées comme la personnalisation des en-têtes, ce qui est essentiel pour l'inclusion du token Bearer.

// Importer le polyfill
const { EventSourcePolyfill } = require('event-source-polyfill');
// Ton Bearer Token
const token = 'votre token';

// Utiliser EventSourcePolyfill pour envoyer le token dans l'en-tête Authorization
const eventSource = new EventSourcePolyfill('https://mdm.pulse-xr.com/devices/:id/updates', {
  headers: {
    'Authorization': `Bearer ${token}`
  }
});

eventSource.onopen = function(data) {
    console.log("connection opened ");
}

eventSource.onmessage = function(event) {
   const updatedDevice = JSON.parse(event.data);
   console.log('Mise à jour du device:', updatedDevice);
};

eventSource.onerror = function(err) {
  console.error('Erreur dans la connexion SSE:' + err);
};

Python

Kotlin

C#

Go

Response

200

{
	"id": string,
	"enrollmentToken": string,
	"enterprise": Enterprise,
	"macAddress": string, 
	"androidId": string, // nullable
	"description": string, // nullable
	"temporaryVerificationCode": TemporaryVerificationCode, // nullable
	"settings": Settings,
	"type": TypeDevice,
	"isAvailable": boolean,
	"mdmInfo": { "codeVersion": integer, "labelVersion": string, "isDeviceOwner": boolean } //nullable,
	"label": string,
	"networksAvailable": NetworksDetails[],
	"currentContent": CurrentContent,
	"syncDate": Date,
	"licence": string //nullable
}