Gerät beanspruchen

Integrationsleitfaden für mobile App

Gerät beanspruchen

POST Keine Auth /?endpoint=claim_device

Registriert die Android-App als neues Gerät im Panel. Dies ist ein öffentlicher Endpoint; kein Authorization-Header erforderlich. Die App sollte dies einmal aufrufen, nachdem der Benutzer den QR-Code gescannt hat.

Nach erfolgreicher Registrierung wird das Einmaltoken verbraucht und derselbe Token-Wert wird zum permanenten Geräte-API-Token. Sicher auf dem Gerät speichern.

Anfragekörper

Feld	Typ		Beschreibung
token	string	erforderlich	Einmaliger Registrierungstoken aus dem QR-Code (Großbuchstaben).
phone_number	string	optional	SIM-1-Telefonnummer.
phone_number2	string	optional	SIM-2-Telefonnummer (Dual-SIM-Geräte).
is_dual_sim	boolean	optional	`true` / `false` - ob das Gerät zwei SIM-Slots hat.
fcm_token	string	optional	Firebase Cloud Messaging-Token für Push-Benachrichtigungen.
name	string	optional	Gerätename. Standard ist die Telefonnummer wenn weggelassen.

Beispielanfrage

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

Antwort

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

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

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