Aller au contenu principal
Version: Next

Intégration backend

L'Eixam Flutter SDK s'appuie sur un backend partenaire pour fournir des sessions signées et prendre en charge les endpoints opérationnels clés.

Ce que le backend partenaire doit fournir

  1. Une session SDK signée (appId, externalUserId, userHash)
  2. Support d'identité canonique via GET /v1/sdk/me
  3. Support MQTT opérationnel pour SOS et télémétrie
  4. Support HTTP transactionnel pour l'annulation de SOS
  5. Surfaces de contacts et de registre de dispositifs backend

Flux de signature

Le backend partenaire détient le secret de l'app et signe l'identité utilisateur. L'étape de signature doit se faire côté serveur — jamais dans le client mobile.

Consultez Identity Signing (JS) pour des exemples d'implémentation côté serveur.

Endpoints opérationnels

OpérationTransport
Enrichissement de sessionGET /v1/sdk/me
Déclenchement SOSOpérationnel (MQTT)
Annulation SOSPOST /v1/sdk/sos/cancel
Réhydratation SOS actifGET /v1/sdk/sos
TélémétrieOpérationnel (MQTT)
Dispositifs et contactsHTTP

Authentification

HTTP

X-App-ID: <appId>
X-User-ID: <externalUserId>
Authorization: Bearer <userHash>

MQTT (sans préfixe Bearer)

username: sdk:<appId>:<externalUserId>
password: <userHash>
remarque

Le SDK n'appelle pas les routes d'authentification ou de signature du partenaire, et ne calcule pas la signature localement.