Richiedi dispositivo

Guida all'integrazione dell'app mobile

Richiedi dispositivo

POST Nessuna auth /?endpoint=claim_device

Registra automaticamente l'app Android come nuovo dispositivo nel pannello. Questo è un endpoint pubblico; nessun header Authorization richiesto. L'app deve chiamare questo una volta dopo che l'utente ha scansionato il codice QR.

Dopo la registrazione riuscita, il token unico viene consumato e lo stesso valore diventa il token API permanente per dispositivo. Conservalo in modo sicuro sul dispositivo.

Corpo della richiesta

Campo	Tipo		Descrizione
token	string	obbligatorio	Token di registrazione unico mostrato nel codice QR (maiuscolo).
phone_number	string	opzionale	Numero di telefono SIM 1.
phone_number2	string	opzionale	Numero di telefono SIM 2 (dispositivi dual-SIM).
is_dual_sim	boolean	opzionale	`true` / `false` - se il dispositivo ha due slot SIM.
fcm_token	string	opzionale	Token Firebase Cloud Messaging per notifiche push.
name	string	opzionale	Nome del dispositivo. Predefinito il numero di telefono se omesso.

Esempio di richiesta

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"
  }'

Risposta

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

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

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