Provisionar troncos no LiveKit
Faz o LiveKit ficar igual ao cadastro. Com trunk_id, um tronco; sem ele, todos os troncos da plataforma, um a um (só a equipe DOM360; fora dela, 404 TRUNK_NOT_FOUND, como todo recurso da plataforma). Antes de aceitar, o que o cadastro já sabe responde na hora: tronco de DID ativo sem rota ativa é 422, e um nome já usado no LiveKit por outro tronco do cadastro é 409 (details.reason = livekit_name_taken). Aceito, responde 202 com a operação em Location: um tronco que o LiveKit recusa termina failed (error.code = livekit_rejected); no lote de plataforma, as falhas de cada tronco vão para result.failed e o lote segue. Um tronco de entrada desativado sai do LiveKit; um de saída desativado fica, com o mesmo id.
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 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 /trunk-provisionings.
Corpo da resposta
application/json
application/json
curl -X POST "https://example.com/trunk-provisionings" \ -H "Idempotency-Key: b3f0c1e2-4a5b-4c6d-8e9f-0a1b2c3d4e5f" \ -H "Content-Type: application/json" \ -d '{}'{ "completed_after_interruption": true, "created_at": "2019-08-24T14:15:22Z", "dealer_id": 0, "error": null, "finished_at": "2019-08-24T14:15:22Z", "kind": "billing_closing", "operation_id": "cb4ede3c-a5d1-45e3-a9d2-fe83accbce52", "progress": { "done": 0, "total": 0 }, "required_capability": "string", "result": {}, "result_location": "string", "started_at": "2019-08-24T14:15:22Z", "status": "queued", "tenant_id": 0}