Resumo
A API gratuita da Calculadora de Porcentagem vai permitir que desenvolvedores usem nossas contas de porcentagem dentro de outros sites e aplicativos — porcentagem de um valor, desconto, aumento, juros e margem — com a mesma fórmula e os mesmos exemplos do site. A API ainda está em desenvolvimento: os endpoints abaixo são o plano, não a documentação final.
O que a API vai oferecer
A ideia é simples: você envia os números e recebe o resultado com a fórmula. Por exemplo, para calcular 20% de 150, você enviaria o valor 150 e a porcentagem 20, e receberia o resultado 30, com a fórmula usada. A API será gratuita para uso básico, sem necessidade de conta para as primeiras chamadas, e documentada em português, com exemplos de requisição e resposta para cada endpoint.
Endpoints planejados — em breve
| Endpoint | O que calcula | Exemplo |
|---|---|---|
| /porcentagem-de-um-valor | X% de um valor | 20% de 150 = 30 |
| /valor-com-desconto | Preço após desconto | R$ 300 com 25% = R$ 225 |
| /valor-com-aumento | Preço após aumento | R$ 2.000 com 10% = R$ 2.200 |
| /juros-simples | Juros e montante | R$ 1.000, 2% a.m., 6 meses = R$ 120 |
| /juros-compostos | Montante com juros sobre juros | R$ 1.000, 1% a.m., 12 meses = R$ 1.126,83 |
| /margem-e-markup | Margem e markup | Custo R$ 40, venda R$ 60 = 33,3% / 50% |
Como vai funcionar
- Sem chave para uso básico — as primeiras chamadas não vão exigir cadastro nem chave de API.
- Resposta em JSON — resultado, fórmula e exemplo, no mesmo formato para todos os endpoints.
- Limites justos — um limite de chamadas por minuto para uso gratuito, com plano maior sob consulta.
- Documentação em português — cada endpoint com exemplo de requisição, resposta e erros comuns.
Enquanto a API não sai
Use as contas diretamente no site: os guias ensinam cada fórmula, as tabelas trazem os valores mais usados, e os exemplos resolvidos mostram o passo a passo. Para embutir uma calculadora em outro site, veja também a página de Widgets. Se você é desenvolvedor e quer ser avisado do lançamento, escreva pelo formulário de contato com o Assunto “API”.
Perguntas frequentes
A API já funciona? Ainda não. Os endpoints estão em desenvolvimento e esta página será atualizada com a documentação oficial no lançamento.
A API será gratuita? Sim, o uso básico será gratuito, sem cadastro para as primeiras chamadas.
Preciso de chave de API? Para o uso básico, não. Se houver um plano com mais chamadas, ele será anunciado aqui.
Última revisão: 19 de novembro de 2026. Saiba mais sobre o site.