Desconexão de clientes

A desconexão de um cliente no OZmap, que está conectado a uma Caixa e a um Splitter, pode ser realizada de duas maneiras:

1. Desconectar a Fibra do Cliente (mantendo o cliente na Caixa): Neste caso, o cliente será desconectado do Splitter, mas continuará vinculado à Caixa.

2. Desconectar o Cliente da Caixa (removendo o cabo de drop): Aqui, o cliente será totalmente desconectado, tanto do Splitter quanto da Caixa, com a remoção do cabo de drop.

➡️ Exemplo

A seguir, apresentamos um exemplo de como realizar cada um dos processos de desconexão mencionados. Para isso, utilizaremos a seguinte property do OZmap, que será usada para ilustrar ambos os tipos de desconexão:

{
   "observation": "",
   "drop": "665a0b258ce829001532be3b",
   "tags": [],
   "cables": [],
   "towers": [],
   "kind": "Property",
   "box": "665a099ad502780021370a59",
   "address": "RUA TEST OZMAP",
   "client": {
    ...
   },
   "creatorData": {
       "id": "65d645dc76afab0014bbc9d1",
       "name": "test_ozmap",
       "username": "test_ozmap"
   },
   "connections": [
       {
           "id": "665a099ad502780021370a61",
           "kind": "Splitter",
           "port": 1,
           "name": "Splitter 1",
           "implanted": true,
           "fiber": "665a0b258ce829001532be3c"
       }
   ]
	...
}

• Desconectar a Fibra do Cliente (mantendo o cliente na Caixa)

Neste caso, o cliente é desconectado do Splitter, mas permanece vinculado à Caixa. Para realizar esta operação, é necessário o ID do cabo de drop (neste exemplo, "665a0b258ce829001532be3b"), localizado na propriedade "drop" da property.

Para desconectar a fibra do cliente, realize a seguinte chamada ao OZmap:

curl --location --request POST 'https://sandbox.ozmap.com.br:9994/api/v2/cables/665a0b258ce829001532be3b/fibers/disconnect' \
--header 'Authorization: AUTHORIZATION_KEY'

A resposta esperada será um status 204 No Content, confirmando que a desconexão da fibra foi realizada com sucesso.

• Desconectar o Cliente da Caixa (removendo o cabo de drop)

Já neste caso, além de desconectar a fibra do cliente, o cabo de drop será removido, desconectando-o completamente da caixa.

Para realizar isso, removeremos o cabo no OZmap, que desconectará simultaneamente o cliente da fibra. Esse procedimento será realizado por meio de uma exclusão em cascata, utilizando a query cascade=true. Dessa forma, ao deletar o cabo de drop, sua fibra também será excluída, caso esteja conectada. Para executar esse processo, faça a seguinte chamada ao OZmap, informando o ID do drop (neste exemplo, "665a0b258ce829001532be3b") e a query cascade=true:

curl --location --request DELETE 'https://sandbox.ozmap.com.br:9994/api/v2/cables/665a0b258ce829001532be3b?cascade=true' \
--header 'Authorization: AUTHORIZATION_KEY'

A resposta esperada será um status 204 No Content, indicando que o cabo foi removido com sucesso.