Changelog
Planos por ligações activas e o erro de limite de ligações
Os planos diferem agora apenas no número de ligações activas que uma empresa serve: Grátis até 10, depois 100, 250 e 500, com todas as funcionalidades e membros da equipa ilimitados em todos. Acima de 500 há um plano à medida. As ligações pendentes, suspensas, desligadas e retiradas não contam, e a factura mensal usa o número de ligações activas no dia em que é emitida.
Nenhum plano cobra ligações acima do limite. Em vez disso, quando a empresa está no limite, as duas acções que tornam uma ligação activa recusam a seguinte:
POST /connections/{id}/activate(concluir uma instalação);POST /connections/{id}/reconnect(religar uma ligação suspensa ou desligada).
Ambas respondem 409 com error_code subscription.connection_limit_reached e os params max, plan_code e next_plan_code (custom no plano de 500). Criar pedidos e aprovar pedidos de serviço não muda: a ligação fica pendente.
O que mudar na sua integração#
Se activa ou religa ligações pela API, trate o novo 409: mostre a mensagem e indique à empresa as definições da subscrição para mudar de plano. Veja Erros da API e o artigo de ajuda sobre planos e limites de clientes.
Endpoints públicos de planos, conectores e pedidos de contacto
A API pública passou a disponibilizar três novos endpoints sem autenticação para integração directa com o site público:
GET $PUBLIC_API/plans: devolve os planos publicados, ordenados pordisplay_order, com limites, preços e capacidades.GET $PUBLIC_API/connectors: lista os drivers de conectores activos (pagamentos, mensagens, contadores) e respectivas capacidades.POST $PUBLIC_API/contact-requests: recebe pedidos de contacto com validação e limite de pedidos por IP e email.
Cabeçalhos normalizados de limite de pedidos (RateLimit-*)
Onde a limitação de taxa está activa, as respostas da API passam a incluir RateLimit-Limit, RateLimit-Remaining e RateLimit-Reset, além de Retry-After nas respostas 429 Too Many Requests.
Request-Id em todas as respostas e idempotência nas criações
Todas as respostas da API incluem agora o cabeçalho Request-Id, e os corpos de erro application/problem+json incluem o campo correspondente request_id juntamente com type a apontar para a referência do código de erro.
O suporte a Idempotency-Key (com retenção de 24 horas e resposta 409 em caso de reutilização com corpo diferente) foi alargado às rotas de criação das APIs de negócio e de morador.
Conector de pagamentos simulado e avanço de sandbox
As novas contas criadas a partir da página de sandbox (?next=sandbox) entram directamente num ambiente sandbox pré-populado com clientes, ligações, contadores, leituras, rede e facturas de exemplo.
Foi também adicionado um conector de pagamentos simulado disponível apenas em ambientes sandbox, com valores mágicos nos dois últimos cêntimos do montante (00 confirma, 02 falha, 05 expira e 09 fica pendente até executar o comando sandbox advance na CLI).
Cabeçalhos Standard Webhooks e segredos whsec_
As entregas de webhooks passaram a seguir a especificação Standard Webhooks. Os cabeçalhos proprietários anteriores foram substituídos por webhook-id, webhook-timestamp e webhook-signature, e os segredos de assinatura passaram a usar o prefixo whsec_. O cabeçalho User-Agent reflecte agora o nome curto configurado da marca.
O que alterar na sua integração#
Actualize o código de verificação para ler os novos cabeçalhos e calcular o HMAC-SHA256 sobre "{webhook-id}.{webhook-timestamp}.{body}" (ou utilize qualquer biblioteca Standard Webhooks).
Antes#
const sig = req.headers['x-signature']
const eventId = req.headers['x-event-id']
const valid = verifyHmac(secret, req.rawBody, sig)
Depois#
import { Webhook } from 'standardwebhooks'
const wh = new Webhook(process.env.WEBHOOK_SECRET) // whsec_...
const payload = wh.verify(req.rawBody, {
'webhook-id': req.headers['webhook-id'],
'webhook-timestamp': req.headers['webhook-timestamp'],
'webhook-signature': req.headers['webhook-signature'],
})