Changelog
Todas as alterações nos widgets incorporáveis - URLs, parâmetros, chaves, domínios e limites -, as mais recentes primeiro. O que permanece estável dentro de uma versão está descrito nas políticas.
Os widgets não abrem mais uma conexão websocket com a Bitculator nem gravam dados de tradução no armazenamento do navegador do visitante. Nada muda na tela: os widgets nunca transmitiram preços ao vivo, então os números sempre refletem o momento do carregamento da página.
Uma duração que termina no meio de um período de capitalização agora rende juros pro rata e ainda credita os depósitos feitos dentro dele, e a curva de crescimento é espaçada pelo tempo decorrido. As entradas são limitadas a um capital de 1.000.000.000.000, um aporte de 1.000.000.000, uma taxa de 1.000% e 50 anos ou 600 meses; um valor acima do limite é redefinido para o limite.
A taxa agora é uma taxa nominal anual, dividida entre os períodos de capitalização. Antes, a taxa inteira era aplicada a cada período, então 5% com capitalização mensal cresciam como 5% ao mês; os resultados nos embeds existentes caem de forma correspondente.
Cancelar um plano de embed pago agora também descarta qualquer downgrade que você tinha agendado; o plano simplesmente segue até o fim do período pago.
Os seletores de data de início e fim do DCA liam as datas como meia-noite UTC, o que mostrava o dia anterior para visitantes a oeste do UTC. Agora usam o dia do calendário local do visitante.
O segmento de caminho {locale} agora também aceita ar (exibido da direita para a esquerda), sk, th, ko, ro, hu, sr e fi, adicionados entre 19 e 24 de setembro - 27 idiomas no total.
As páginas dos widgets não definem mais um cookie de sessão nem um cookie XSRF e não registram mais um service worker no navegador do visitante. O contador por visitante sem chave agora usa um hash com chave do endereço IP, e os carregamentos sem chave e sem referrer são informados como "direct" em vez de pelo IP.
As linhas mensais e semanais de /embed/zoom/{slug} agora são buscadas sem um token de sessão, que um widget dentro do iframe de outro site não consegue obter.
O conversor não mostra nenhum valor quando um dos ativos não tem preço utilizável, em vez de "1 X = 0 Y", e o flipper de marketcap limpa os seus números quando um par não tem capitalização de mercado, em vez de manter os números do par anterior sob os novos nomes.
Uma URL de widget que usa o slug anterior de uma moeda agora retorna um 301 para o mesmo widget com o slug atual, mantendo a query string - incluindo embed_key. Antes, retornava 404.
Os domínios registrados são analisados da mesma forma que um navegador lê uma URL: o esquema, o caminho, a porta e um www. inicial são descartados, o nome é convertido para minúsculas e nomes internacionais viram punycode; qualquer coisa que não seja um hostname é rejeitada. O Referer da página que incorpora o widget é normalizado da mesma forma. Subdomínios diferentes de www continuam precisando de uma entrada própria.
A mudança para um plano de embed inferior agora entra em vigor quando o período pago termina. Antes, um downgrade no mesmo intervalo de cobrança era aplicado imediatamente e reduzia o limite mensal no meio do período. Os upgrades continuam sendo aplicados na hora.
Um slug de moeda desconhecido ou inativo agora retorna uma resposta de texto simples "Not Found", em vez de renderizar o site completo da Bitculator - cabeçalho, barra lateral e rodapé - dentro do seu iframe.
Criar uma chave de embed agora exige um endereço de e-mail verificado; contas criadas com uma wallet cripto estão isentas. A criação de chaves é limitada a 10 por minuto, e as chaves existentes continuam funcionando.
A partir de 14 de agosto, as verificações de domínio ficavam em cache por 5 minutos, incluindo resultados "não registrado", então um domínio que você tinha acabado de adicionar podia continuar retornando 403 por até 5 minutos. Agora só as correspondências bem-sucedidas ficam em cache; remover um domínio ainda pode levar até 5 minutos para ter efeito.
O horário do último uso de uma chave no console de embed agora é gravado no máximo uma vez por hora, e os carregamentos de widgets não contam mais como visitas nas estatísticas do próprio site da Bitculator. As contagens de uso de embed não são afetadas.
Em larguras estreitas, a faixa semanal e a faixa anual, trimestral e mensal agora rolam de forma independente, então arrastar a longa linha semanal não puxa mais a faixa mais curta para o lado.
Entre 12 e 16 de julho, os widgets de calculadora e o flipper ganharam novos layouts e campos, e algumas seções foram removidas: picker no flipper, chart e table na calculadora de juros, results nas de impostos e de empréstimo, e banner, table e chart na de staking, que agora lista as recompensas diárias a anuais diretamente no corpo. As disposições salvas pelos visitantes foram redefinidas; refaça qualquer valor de layout ou visible que mencione uma seção removida.
Uma página host pode enviar {type: 'bitculator-embed-host-growable'} para a janela do widget. O widget então abre os seus seletores para baixo e os inclui na altura que informa por meio de bitculator-embed-resize; sem a mensagem, os seletores abrem como uma sobreposição dentro do frame fixo.
/embed/zoom/{slug} agora mostra uma única grade de retornos anuais, trimestrais, mensais e semanais por ano, com uma linha de média e resumos de taxa de acerto, além de uma visualização trimestral "tornado". Ela substitui as tabelas trimestrais, mensais e semanais anteriores e não tem moldura de card externa.
O console de embed agora mostra em um gráfico as solicitações por dia do período de cobrança atual.
/{locale}/pricing/embed agora redireciona para /{locale}/crypto-tools, que ganhou um seletor de planos com checkout e um explorador de widgets que mostra a prévia de um widget por vez ao lado do construtor de snippets.
Esta referência entrou no ar em /{locale}/documentation/embed/v1, com um construtor de snippets, autenticação, domínios, cota, planos, os parâmetros de cada widget e prévias carregadas com um clique.
Os carregamentos de embed agora têm plano, período de cobrança e contador próprios; a Data API havia consumido do plano de embed nos seus dois primeiros dias. Apenas as chaves de embed contam para o seu limite de chaves de embed, uma chave da Data API ou uma chave expirada em uma URL de widget recebe 403, e as respostas dos widgets não trazem cabeçalhos X-Quota-*.
Depois que você cancela um plano de embed pago, o uso continua sendo contado na janela do seu dia de cobrança até o plano terminar, em vez de mudar para o mês civil no meio do período, e a data de redefinição no console fica correta para dias de cobrança no fim do mês.
Os primeiros endpoints JSON /api/v1/prices e /api/v1/widgets/convert/{from}/{to}, que aceitavam uma chave de embed, foram substituídos pela Data API, que aceita apenas as suas próprias chaves. As chaves de embed são gerenciadas em /user/developer/embed.
O host que incorpora o widget é convertido para minúsculas e perde qualquer ponto final antes de ser comparado com os seus domínios registrados.
/{locale}/crypto-tools virou uma página de widgets com um conversor ao vivo, um snippet copiável e a comparação entre Free, Starter e Pro.
Um carregamento com embed_key, mas sem o cabeçalho Referer ou Origin, agora recebe 403; antes, ele pulava a verificação de domínio. Mantenha a política de referrer padrão do navegador e não defina referrerpolicy="no-referrer" no iframe.
A franquia sem chave de 1.000 carregamentos por mês agora é contada por IP de visitante em todos os widgets sem chave de todos os sites, em vez de um pool por domínio que incorpora os widgets.
O link no rodapé de cada widget voltou depois de ter sido removido em 4 de abril. Ele aponta para a ferramenta correspondente em bitculator.com e não pode ser desativado.
Os snippets do construtor voltaram a ser um <iframe> simples; os snippets copiados em 3 de abril também traziam um wrapper, um link Powered-by separado e um <script> de redimensionamento automático. O link no rodapé do widget foi removido ao mesmo tempo e voltou em 2 de maio.
Cada página de ferramenta ganhou um construtor: cole a sua chave de embed, escolha o idioma do widget, um modelo de layout e as seções visíveis, e defina largura, altura, raio dos cantos e carregamento lazy ou eager, com o snippet e uma prévia ao vivo sendo atualizados juntos.
Os widgets de calculadora e o flipper aceitam ?visible=, uma lista separada por vírgulas dos IDs das seções a mostrar por padrão. A escolha do próprio visitante, salva no navegador dele, tem prioridade.
Passe a sua chave como ?embed_key=; ?api_key= continua funcionando como alias. O console mudou para /{locale}/user/developer/embed, e o valor completo de uma nova chave é mostrado uma única vez, logo após a sua criação.
As páginas dos widgets ainda saíam com X-Frame-Options: SAMEORIGIN e frame-ancestors 'self', então os navegadores se recusavam a exibi-las em outros domínios. Agora enviam frame-ancestors * e nenhum X-Frame-Options.
Os planos introduzidos em 22 de março viraram planos de embed com checkout próprio, e a página de preços mudou para /{locale}/pricing/embed. Os limites não mudaram.
Os widgets de DCA, lucro, juros, impostos, empréstimo, staking e o flipper são divididos em seções que os visitantes podem arrastar, redimensionar e alinhar, salvas no navegador deles, com um botão "Redefinir layout". ?layout= define a disposição inicial, por exemplo c(stats::cc,settings::cc), em que c() é uma coluna, r() uma linha e uma seção é id:width:alignment.
Os widgets aceitam uma chave na URL, e um carregamento com chave precisa vir de um domínio registrado no console, ou recebe 403; os carregamentos sem chave continuam sendo renderizados. O Free permite 10.000 carregamentos por mês, 1 domínio e 2 chaves; o Starter, 50.000, 3 e 5; e o Pro, 500.000, 10 e 10. Acima do limite, o widget mostra uma página de limite de uso (HTTP 429).
O widget conversor perdeu a sua tabela de comparação, então hideTable não tem efeito desde então. O parâmetro continua sendo aceito.
Os widgets enviam {type: 'bitculator-embed-resize', height} para a janela pai sempre que a sua altura muda, para que um script da página host possa dimensionar o iframe, e mostram um placeholder de carregamento até estarem prontos. Cada página de ferramenta ganhou um snippet de embed copiável.
Lançamento: o conversor (/{locale}/embed/converter/{from}/{to}), o zoom (/zoom/{slug}), o flipper de marketcap (/flip/{entity1}/{entity2}) e as calculadoras /dca, /profit, /interest, /tax, /loan e /staking. Todos os widgets aceitam ?compact=1 e ?theme=dark, têm fundo transparente, são noindex e trazem um link "Powered by Bitculator".
A remoção de uma versão de widget ou a redução de um limite é anunciada aqui e por e-mail com pelo menos seis meses de antecedência - veja a política de descontinuação.