RCSZilla Versi贸n 1.0

Reclamar dispositivo

Gu铆a de integraci贸n de la aplicaci贸n m贸vil

Reclamar dispositivo

POST Sin auth /?endpoint=claim_device

Registra autom谩ticamente la aplicaci贸n Android como nuevo dispositivo en el panel. Este es un endpoint p煤blico; no se requiere encabezado Authorization. La app debe llamar esto una vez despu茅s de que el usuario escanee el c贸digo QR.

*
Despu茅s del registro exitoso, el token 煤nico se consume y el mismo valor se convierte en el token API permanente por dispositivo. Gu谩rdelo de forma segura en el dispositivo.

Cuerpo de la solicitud

Campo Tipo Descripci贸n
token string obligatorio Token de registro 煤nico mostrado en el c贸digo QR (may煤sculas).
phone_number string opcional N煤mero de tel茅fono SIM 1.
phone_number2 string opcional N煤mero de tel茅fono SIM 2 (dispositivos dual-SIM).
is_dual_sim boolean opcional true / false - si el dispositivo tiene dos ranuras SIM.
fcm_token string opcional Token Firebase Cloud Messaging para notificaciones push.
name string opcional Nombre amigable del dispositivo. Por defecto el n煤mero de tel茅fono si se omite.

Ejemplo de solicitud

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

Respuesta

{
  "success": true,
  "message": "Device registered",
  "device_id": 7
}
{
  "success": true,
  "message": "Already registered",
  "device_id": 7
}
{
  "success": false,
  "message": "Invalid or expired registration token"
}