Sondar a conectividade de um tronco
Testa agora o servidor da operadora: DNS, alcance por UDP e um OPTIONS SIP. Sonda o servidor cadastrado ou, num tronco de entrada, o primeiro endereço permitido. Um servidor interno ou privado é recusado antes de qualquer pacote. O resultado não é gravado; a recusa da operadora vem como ok = false, não como erro.
Autorização
bearer trunks:executeCredencial da v3: o JWT da sessão (o mesmo da v2) ou um token pessoal dom_pat_…. A lista de escopos de cada operação diz o que ela exige: uma capacidade (agents:read), authenticated ou session-only. Segredo de máquina (X-Agent-Secret, X-API-Token, sdk_…) não é aceito.
Em: header
Escopo: trunks:execute
Parâmetros de caminho
Id do tronco
Parâmetros de cabeçalho
Chave opcional de 1 a 255 caracteres ASCII visíveis; quando enviada, vale o mesmo contrato da §8.
Corpo da resposta
application/json
application/json
curl -X POST "https://example.com/trunks/string/probes" \ -H "Idempotency-Key: b3f0c1e2-4a5b-4c6d-8e9f-0a1b2c3d4e5f"{ "dns_ok": true, "error": "string", "latency_ms": 0, "note": "string", "ok": true, "provisioned": true, "resolved_ip": "string", "sip_options_ok": true, "sip_port": 0, "sip_server": "string", "socket_ok": true, "transport": "string"}