Criar uma rota de entrada
Liga uma chave do tronco a um agente de voz do mesmo cliente. Num tronco de DID a chave é o número em E.164; num de ramal, a extensão; um tronco estático ou de saída não tem rotas (422). A mesma chave no tronco é 409 (details.reason = route_key_taken). Num tronco de DID, a rota nova é um número novo no LiveKit: o tronco fica stale até o próximo provisionamento. O Location do 201 é o endereço do item, que tem PATCH e DELETE e não tem GET (a análise 09 não prevê leitura de uma rota só): a rota vem inteira no corpo e aparece em GET /trunks/{trunk_id}/routes.
Autorização
bearer trunks:writeCredencial 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:write
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 requisição
application/json
Definições TypeScript
Use o tipo request body no TypeScript.
O corpo de POST /trunks/{trunk_id}/routes.
Corpo da resposta
application/json
application/json
curl -X POST "https://example.com/trunks/string/routes" \ -H "Idempotency-Key: b3f0c1e2-4a5b-4c6d-8e9f-0a1b2c3d4e5f" \ -H "Content-Type: application/json" \ -d '{ "agent_id": "2b1e3b65-2c04-4fa2-a2d7-467901e98978", "match_key": "string" }'{ "agent_id": "2b1e3b65-2c04-4fa2-a2d7-467901e98978", "created_at": "2019-08-24T14:15:22Z", "enabled": true, "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08", "match_key": "string", "trunk_id": "d1c0247b-6570-4df5-9107-7986a22149d1", "updated_at": "2019-08-24T14:15:22Z"}