Revendiquer l'appareil

Guide d'intégration application mobile

Revendiquer l'appareil

POST Sans auth /?endpoint=claim_device

Enregistre automatiquement l'application Android comme nouvel appareil dans le panneau. C'est un endpoint public ; aucun en-tête Authorization n'est requis. L'application doit appeler ceci une fois après que l'utilisateur scanne le code QR.

Après un enregistrement réussi, le token unique est consommé et la même valeur devient le token API permanent par appareil. Stockez-le en sécurité sur l'appareil.

Corps de requête

Champ	Type		Description
token	string	obligatoire	Token d'enregistrature unique affiché dans le code QR (majuscules).
phone_number	string	optionnel	Numéro de téléphone SIM 1.
phone_number2	string	optionnel	Numéro de téléphone SIM 2 (appareils dual-SIM).
is_dual_sim	boolean	optionnel	`true` / `false` - si l'appareil a deux emplacements SIM.
fcm_token	string	optionnel	Token Firebase Cloud Messaging pour les notifications push.
name	string	optionnel	Nom convivial de l'appareil. Par défaut le numéro de téléphone si omis.

Exemple de requête

cURL

curl -X POST "https://api.rcszilla.com/?endpoint=claim_device" \
  -H "Content-Type: application/json" \
  -d '{
    "token": "ABCD-1234-EFGH-5678",
    "phone_number": "+40712345678",
    "is_dual_sim": false,
    "fcm_token": "eXample_FCM_token_here",
    "name": "My Pixel 7"
  }'

Réponse

{
  "success": true,
  "message": "Device registered",
  "device_id": 7
}

{
  "success": true,
  "message": "Already registered",
  "device_id": 7
}

{
  "success": false,
  "message": "Invalid or expired registration token"
}