IP dedicado
Se o número tem o adicional de IP dedicado: um IP fixo de provedor residencial brasileiro só dele, em vez de um IP que ele divide com, no máximo, alguns outros números do mesmo projeto. Escopo necessário: connections:read.
Parâmetros de caminho
idstring · uuidobrigatórioIdentificador da conexão (o número).
Respostas
| Código | Erro e descrição |
|---|---|
| 200 | dedicatedIp: o adicional em andamento (provisioning ou active), senão o último que a conexão teve, ou null quando ela nunca teve um. |
| 400 | FST_ERR_VALIDATIONA requisição não segue o schema da operação (por exemplo, um id que não é um UUID); message diz o que está errado. |
| 401 | Sem chave de API, ou com uma chave desconhecida, revogada ou expirada. O corpo é {"error": "Unauthorized"}. |
| 403 | A chave não tem o escopo connections:read; a mensagem de erro cita o escopo que falta. |
| 404 | A conexão não existe ou não é de quem chama: a de outra pessoa responde exatamente como uma que não existe (Connection not found). |
| 429 | Requisições demais deste IP de origem, ou autenticações com falha demais: espere os segundos de Retry-After.Cabeçalho: Retry-After |
Detalhes
O IP dedicado é um recurso PRO (dedicated_ip) comprado por número pelos donos e administradores da organização no painel, numa assinatura mensal; a API só o consulta. Depois do pagamento, o número passa para o IP dedicado em poucos minutos (uma reconexão planejada), ou assim que um IP é comprado para ele.
status: awaiting_payment (o pagamento ainda não foi feito), provisioning (pago, e o número ainda não está no IP dedicado), active (o número sai por um IP só dele) ou canceled (a assinatura terminou, e o número voltou para um IP compartilhado). waived: true: concedido pela equipe, sem assinatura.
lastError diz por que o adicional não está ativo: waiting_for_proxy (o IP dedicado está sendo comprado), own_proxy (a conexão sai pelo proxy próprio, que tem prioridade), connection_deleted, duplicate (um segundo adicional pago para uma conexão que já tem um) ou unplaced (terminou, e ainda nenhum IP compartilhado tem lugar para o número).
Guia: Proxy e IP dedicado