Зареєструвати пристрій

Посібник з інтеграції мобільного додатку

Зареєструвати пристрій

POST Без авторизації /?endpoint=claim_device

Автоматично реєструє Android-додаток як новий пристрій у панелі. Це публічний endpoint; заголовок Authorization не потрібен. Додаток має викликати це один раз після того, як користувач відсканує QR-код.

Після успішної реєстрації одноразовий токен споживається і те саме значення стає постійним API-токеном на пристрій. Зберігайте його безпечно на пристрої.

Тіло запиту

Поле	Тип		Опис
token	string	обов'язково	Одноразовий реєстраційний токен, показаний у QR-коді (верхній регістр).
phone_number	string	необов'язково	Номер телефону SIM 1.
phone_number2	string	необов'язково	Номер телефону SIM 2 (пристрої з двома SIM).
is_dual_sim	boolean	необов'язково	`true` / `false` - чи має пристрій два слоти SIM.
fcm_token	string	необов'язково	Токен Firebase Cloud Messaging для push-сповіщень.
name	string	необов'язково	Зручна назва пристрою. За замовчуванням номер телефону якщо опущено.

Приклад запиту

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

Відповідь

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

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

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