Cihaz Sahiplenme (Claim Device)

Mobil Uygulama Entegrasyon Kılavuzu

Cihaz Sahiplenme (Claim Device)

POST Kimlik Doğrulamasız /?endpoint=claim_device

Android uygulamasını panelde yeni bir cihaz olarak kendi kendine kaydeder. Bu herkese açık bir endpoint'tir; Authorization başlığı gerekmez. Uygulama, kullanıcı web panelinin Cihazlar sayfasında gösterilen QR kodu taradıktan sonra bunu bir kez çağırmalıdır.

Başarılı bir kayıttan sonra tek kullanımlık token tüketilir ve aynı token değeri kalıcı cihaz bazlı API token'ı hâline gelir. Cihazda güvenli bir şekilde saklayın.

İstek Gövdesi

Alan	Tür		Açıklama
token	string	zorunlu	QR kodunda gösterilen tek kullanımlık kayıt token'ı (büyük harf).
phone_number	string	isteğe bağlı	SIM 1 telefon numarası.
phone_number2	string	isteğe bağlı	SIM 2 telefon numarası (çift SIM'li cihazlar).
is_dual_sim	boolean	isteğe bağlı	`true` / `false` - cihazın iki SIM yuvasına sahip olup olmadığı.
fcm_token	string	isteğe bağlı	Anlık bildirimler için Firebase Cloud Messaging token'ı.
name	string	isteğe bağlı	Cihaz için kolay anlaşılır ad. Boş bırakılırsa varsayılan olarak telefon numarası kullanılır.

Örnek İstek

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

Yanıt

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

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

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