Dispositivos

Update device

Atualiza um dispositivo do cliente autenticado.

A linha telefônica e o ICCID são sempre regravados a partir do chip informado em simcard_id. Omitir simcard_id desvincula o chip e zera linha e ICCID do dispositivo — para preservar o vínculo, reenvie o simcard_id atual. O mesmo vale para in_out_profile_id: ausente, é gravado como nulo.

put/manager/devices/{device}

Request

  • Base URL: https://api.mapper.net.br/api
  • URL: https://api.mapper.net.br/api/manager/devices/{device}
  • Auth: HTTP bearer

Path parameters

deviceinteger required

Device ID

Request body

uniqueidstring required

IMEI. Único em toda a base, exceto o próprio registro.

commandidinteger required

ID do Modelo/Fabricante do Dispositivo (deve existir na tabela commands)

simcard_idinteger nullable

ID do chip a vincular (deve existir na tabela simcards e pertencer ao cliente autenticado). Define a linha e o ICCID gravados no dispositivo. Omitido, desvincula o chip.

device_typeinteger nullable

ID do tipo de dispositivo (deve existir na tabela device_types). Validado, mas não gravado — serve apenas para filtrar a lista de modelos no formulário web. O tipo efetivo vem de commandid.

officeidstring nullable

ID da filial. Valores <= 0 são gravados como nulo.

manufacturerstring nullable

Validado, mas não gravado — serve apenas para filtrar a lista de modelos no formulário web. O fabricante efetivo vem de commandid.

operatorinteger nullable

ID da operadora (deve existir na tabela operators)

simcard_providerinteger nullable

ID do fornecedor do chip (deve existir na tabela simcard_suppliers). Gravado em attributes.supplierid.

in_out_profile_idinteger nullable

ID do perfil de entrada/saída (deve existir na tabela device_in_out_profiles). Omitido, é gravado como nulo.

observationstring nullable

Observações sobre o dispositivo. Gravado em attributes.observation; omitido, é gravado como "".

is_disabled'true' | 'false'

Se o dispositivo está desabilitado. Opcional na validação, mas envie sempre — quando omitido é tratado como "false".

iccidstring nullable

Aceito na validação, mas ignorado — o ICCID gravado vem sempre do chip em simcard_id.

Response

Device updated successfully

Changes

No recorded changes to this operation across all 1 revision of this API.