Funcionalidade
Você reserva um número, recebe as mensagens que chegarem nele e devolve. Nada fica pendurado entre uma execução e outra, e a linha que a sua operação usa continua fora do caminho.
Uma caixa do acervo compartilhado nasce com um tempo máximo de reserva definido pelo plano: 10 minutos no Free, 30 nos demais. Quando o prazo vence, ou quando você devolve antes, o número sai do seu alcance sozinho. O prazo existe para o número rodar entre contas — então uma caixa criada sobre um número que você reivindicou não vence por relógio: ela dura enquanto o claim durar.
Um número devolvido entra em quarentena antes de voltar ao acervo. Se ele foi devolvido rápido e não recebeu nada, a espera é curta (UNUSED_QUARANTINE_SECONDS, 60s por padrão); se chegou qualquer mensagem, vale a quarentena cheia (QUARANTINE_SECONDS, 600s). Mensagem atrasada de um teste não cai no teste de outra pessoa.
Antes de alocar do acervo público, a API soma as suas reservas ativas e em quarentena para aquele país e canal e limita a fatia a 10% do inventário elegível. Passou disso, a resposta é ROTATION_LIMIT com HTTP 429 e Retry-After, em vez de esvaziar o acervo para os outros.
O corpo de cada mensagem é cifrado em AES-256-GCM com uma chave exclusiva da caixa. O purge destrói essa chave, não só as linhas: o que sobrar em backup é texto cifrado sem chave que o abra.
Escreva para a gente e respondemos no mesmo dia útil.
Abre o seu cliente de e-mail com a mensagem começada para contato@numport.app.
Continue por aqui