Revendicați dispozitiv

Ghid de integrare aplicație mobilă

Revendicați dispozitiv

POST Fără autentificare /?endpoint=claim_device

Înregistrează automat aplicația Android ca dispozitiv nou în panou. Este un endpoint public; nu este necesar antetul Authorization. Aplicația ar trebui să apeleze aceasta o singură dată după ce utilizatorul scanează codul QR din pagina Dispozitive.

După înregistrarea cu succes, tokenul unic este consumat și aceeași valoare de token devine tokenul API permanent per dispozitiv. Stocați-l în siguranță pe dispozitiv.

Corp cerere

Câmp	Tip		Descriere
token	string	obligatoriu	Token de înregistrare unic afișat în codul QR (majuscule).
phone_number	string	opțional	Număr de telefon SIM 1.
phone_number2	string	opțional	Număr de telefon SIM 2 (dispozitive dual-SIM).
is_dual_sim	boolean	opțional	`true` / `false` - dacă dispozitivul are două sloturi SIM.
fcm_token	string	opțional	Token Firebase Cloud Messaging pentru notificări push.
name	string	opțional	Nume prietenos al dispozitivului. Implicit numărul de telefon dacă este omis.

Exemplu cerere

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ăspuns

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

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

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