Integració de backend
L'Eixam Flutter SDK depèn d'un backend del partner per proporcionar sessions signades i donar suport als endpoints operacionals clau.
Què ha de proporcionar el backend del partner
- Una sessió SDK signada (
appId,externalUserId,userHash) - Suport d'identitat canònica via
GET /v1/sdk/me - Suport MQTT operacional per a SOS i telemetria
- Suport HTTP transaccional per a cancel·lació de SOS
- Superfícies de contactes i registre de dispositius de backend
Flux de signatura
El backend del partner posseeix el secret de l'app i signa la identitat de l'usuari. El pas de signatura ha d'ocórrer al servidor — mai en el client mòbil.
Consulta Identity Signing (JS) per a exemples d'implementació al servidor.
Endpoints operacionals
| Operació | Transport |
|---|---|
| Enriquiment de sessió | GET /v1/sdk/me |
| Activació de SOS | Operacional (MQTT) |
| Cancel·lació de SOS | POST /v1/sdk/sos/cancel |
| Rehidratació de SOS actiu | GET /v1/sdk/sos |
| Telemetria | Operacional (MQTT) |
| Dispositius i contactes | HTTP |
Autenticació
HTTP
X-App-ID: <appId>
X-User-ID: <externalUserId>
Authorization: Bearer <userHash>
MQTT (sense prefix Bearer)
username: sdk:<appId>:<externalUserId>
password: <userHash>
note
L'SDK no crida a rutes d'autenticació o signatura del partner, ni calcula la signatura localment.