Reivindicar Dispositivo

Guia de Integração do Aplicativo Móvel

Reivindicar Dispositivo

POST Sem Auth /?endpoint=claim_device

Autorregistra o aplicativo Android como um novo dispositivo no painel. Este é um endpoint público; nenhum cabeçalho Authorization é necessário. O app deve chamá-lo uma vez depois que o usuário escanear o código QR exibido na página Dispositivos do painel web.

Após um registro bem-sucedido, o token de uso único é consumido e o mesmo valor de token se torna o token de API por dispositivo permanente. Armazene-o com segurança no dispositivo.

Corpo da Requisição

Campo	Tipo		Descrição
token	string	obrigatório	Token de registro de uso único exibido no código QR (em maiúsculas).
phone_number	string	opcional	Número de telefone do SIM 1.
phone_number2	string	opcional	Número de telefone do SIM 2 (dispositivos dual-SIM).
is_dual_sim	boolean	opcional	`true` / `false` - se o dispositivo possui dois slots de SIM.
fcm_token	string	opcional	Token do Firebase Cloud Messaging para notificações push.
name	string	opcional	Nome amigável do dispositivo. Se omitido, o padrão é o número de telefone.

Exemplo de Requisição

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

Resposta

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

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

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