DOM360
Telefonia

Listar troncos SIP

GET
/trunks

Lista os troncos SIP do alcance do chamador, por cliente e nome, com a revenda, os agentes que cada tronco toca e o estado no LiveKit. provisioning=stale lista o que foi alterado e ainda não vale nas ligações. Credenciais nunca são devolvidas.

Autorização

bearer trunks:read
AutorizaçãoBearer <token>

Credencial 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:read

Parâmetros de consulta

tenant_id?integer

Estreita a um cliente do alcance.

Formatoint64
direction?string

De que lado da operadora o tronco está: inbound recebe ligações (a operadora é autenticada pelos endereços permitidos), outbound disca pela operadora (com servidor e credencial).

Valor em

  • "inbound"
  • "outbound"
enabled?boolean

true só os ativos; false só os desativados.

provisioning?string

Só os troncos neste estado de provisionamento — stale lista o que precisa ser provisionado de novo.

Valor em

  • "never"
  • "in_sync"
  • "stale"
cursor?string

Cursor opaco devolvido em page.next_cursor da página anterior. Omita para começar do início.

limit?integer

Tamanho da página. Padrão 50; o máximo é o da coleção: 200, ou até 500 nas coleções de itens pequenos.

Formatoint32
Intervalo0 <= value

Corpo da resposta

application/json

application/json

curl -X GET "https://example.com/trunks"
{  "data": [    {      "agents": [        {          "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",          "name": "string"        }      ],      "allowed_addresses": [        "string"      ],      "created_at": "2019-08-24T14:15:22Z",      "dealer_id": 0,      "dealer_name": "string",      "default_agent_id": "3fbd0ae5-640f-4cf1-97c8-0ab89a60d902",      "direction": "inbound",      "enabled": true,      "has_auth": true,      "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",      "name": "string",      "provider": "string",      "provisioning": {        "livekit_trunk_id": "string",        "provisioned_at": "2019-08-24T14:15:22Z",        "state": "never"      },      "routing_mode": null,      "sip_port": 0,      "sip_server": "string",      "tenant_id": 0,      "tenant_name": "string",      "updated_at": "2019-08-24T14:15:22Z"    }  ],  "page": {    "has_more": true,    "next_cursor": "string"  }}