Contratar Número

POST

https://sys.lysi.cloud/voip/citys/numbers

Agora que já temos a cidade e número desejado, vamos fazer a contratação.

Para isso, vamos precisar do DDD e o Número escolhido, conforme retornado no endpoint Obter Números na Cidade e passar no Payload da requisição.

Obtendo Sucesso, você irá receber o ID da contratação, que o qual, você precisará armazenar em um local, pois caso opte por realizar o cancelamento, ele será necessário.

Requisição

Authorization

Forneça seu token bearer no cabeçalho

Authorization

ao fazer requisições para recursos protegidos.

Exemplo:

Authorization: Bearer ********************

Parâmetros Bodyapplication/jsonNecessário

Examples

Respostas

🟢201Sucesso

application/json

Body

🟠400Erro de Contratação

Request Example

Shell

JavaScript

Java

Swift

curl --location --request POST 'https://sys.lysi.cloud/voip/citys/numbers' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data-raw '{
    "number": "3797-9232",
    "ddd": 41
}'

Response Example

201 - Sucesso

{
    "date": "2025-12-29 16:52:43",
    "success": true,
    "error": false,
    "api": {
        "version": "1.0.1",
        "updated": "2025-12-28"
    },
    "__seconds": null,
    "voip": {
        "id": 332,
        "user": "4137979232",
        "password": "XXXXXXX",
        "host": "4137979232@voz.sobreip.com.br",
        "status": 1
    }
}

Página anterior

Obter Números na Cidade

Próxima página

Cancelar Número