Gestão da conta (API Key)

Provisionar número(s)

POSThttps://api.nodinfra.com.br/instances

URL completa: https://api.nodinfra.com.br/instances

Cria um ou mais números na conta, respeitando a cota disponível. Devolve as credenciais de cada número criado (token + link de conexão).

Se falhar no meio de um lote, os números já criados voltam em created com status 207 — salve os tokens para não deixar números órfãos.

Resposta 201:

{
  "created": [
    {
      "id": "clx123",
      "name": "Atendimento",
      "status": "disconnected",
      "token": "instancetoken_abc123",
      "connectLink": "https://nodinfra.com.br/connect/xyz789"
    }
  ],
  "gatewayBaseUrl": "https://api.nodinfra.com.br/api/v1"
}

Parâmetros

Authorizationstringobrigatório

Bearer nod_live_<sua_chave>. Alternativa: header x-api-key: nod_live_<sua_chave>.

Corpo da requisição

namestringopcional

Nome base do número. Padrão: "Número".

exemplo: Atendimento

countintegeropcional

Quantos números criar (1–50). Padrão: 1.

exemplo: 1

Exemplo

Criar 1 número

{
  "name": "Atendimento"
}

Respostas

201Número(s) criado(s) com sucesso.

207Criação parcial — alguns números foram criados.

400JSON inválido ou parâmetro 'count' inválido.

401API Key inválida ou ausente.

402Assinatura pendente de pagamento.

409Cota insuficiente para a quantidade pedida.