API de importação

Os arquivos e as suas colunas: Importar de CSV. O equivalente na CLI é dtvsol import …. Autenticação e erros: veja a visão geral da API.

GET /import/template/{kind}

O modelo de um tipo (plans, networks, clients, services): {"ok": true, "kind": "clients", "csv": "mac,ip,name,…\nAA:BB:CC:00:00:05,10.21.0.5,…\n"}.

POST /import/{kind}

Verifica o arquivo e, com apply, o importa.

Nome	Em	Tipo	Observações
kind	path	string	plans, networks, clients ou services.
csv	body	string	O texto do arquivo. Até 50.000 linhas.
apply	body	boolean	Importar. Sem ele, nada muda.
skip_errors	body	boolean	Com apply: importa as linhas boas. Sem ele, uma única linha ruim faz com que nada seja importado.

curl -s -X POST "http://ROUTER-IP:8880/import/clients" -H "X-API-Key: YOUR_API_KEY" \
  -H "Content-Type: application/json" --data-binary @- <<EOF
{"csv": "mac,ip,name\nAA:BB:CC:00:00:05,10.21.0.5,Juan Perez\n", "apply": false}
EOF

{
  "ok": true, "kind": "clients", "dry_run": true, "lines": 2, "good": 1, "clean": false,
  "errors": [{"line": 3, "error": "IP 10.99.99.9 does not belong to any interface on this server"}],
  "count": 1, "done": ["AA:BB:CC:00:00:05"], "note": null
}

line é a linha do arquivo (o cabeçalho é a linha 1). dry_run: false quando importou; done então lista o que foi importado (os 500 primeiros; count, todos). 400 para um cabeçalho com uma coluna desconhecida ou faltando.