# SLA 80% vs 99% vs 99,9%: O que Cada Nível Significa na Prática para Sua Integração

> Entenda o que cada nível de SLA significa para sua integração com API de CPF. Comparação prática entre 80%, 99% e 99,9% de disponibilidade.

**Publicado:** 20/03/2024
**Autor:** Redação CPFHub.io
**URL:** https://cpfhub.io/blog/sla-api-cpf-niveis-disponibilidade

---


## Introdução

Quando um provedor de API de CPF promete "99,9% de SLA", a maioria das pessoas pensa que é quase a mesma coisa que 99%. Na prática, a diferença é enorme. Cada "nove" adicional representa uma redução de dez vezes no tempo de indisponibilidade permitido.

## O que os números realmente significam

Um SLA (Service Level Agreement) de disponibilidade define o percentual do tempo em que o serviço deve estar operacional. Veja como cada nível se traduz em tempo de indisponibilidade real.

| SLA | Downtime/ano | Downtime/mês | Downtime/semana | Downtime/dia |
|-----|-------------|-------------|----------------|-------------|
| 80% | 73 dias | 6 dias | 33,6 horas | 4,8 horas |
| 90% | 36,5 dias | 3 dias | 16,8 horas | 2,4 horas |
| 95% | 18,25 dias | 1,5 dia | 8,4 horas | 1,2 horas |
| 99% | 3,65 dias | 7,3 horas | 1,68 horas | 14,4 minutos |
| 99,5% | 1,83 dias | 3,65 horas | 50,4 minutos | 7,2 minutos |
| 99,9% | 8,76 horas | 43,8 minutos | 10,1 minutos | 1,44 minutos |
| 99,95% | 4,38 horas | 21,9 minutos | 5 minutos | 43,2 segundos |
| 99,99% | 52,6 minutos | 4,38 minutos | 1 minuto | 8,6 segundos |

- **80% de SLA** -- significa que a API pode ficar fora do ar por quase 5 horas por dia; inaceitável para qualquer operação séria
- **99% de SLA** -- parece bom, mas permite mais de 14 minutos de downtime por dia, o que pode afetar picos de tráfego
- **99,9% de SLA** -- o padrão ouro para a maioria das operações, com menos de 1,5 minuto de downtime diário

---

## Impacto financeiro por nível de SLA

O downtime tem custo direto. Para calcular, multiplique o tempo de indisponibilidade pelo valor das operações que dependem da API.

```python
def calcular_impacto_sla(
 consultas_por_hora: int,
 valor_por_consulta_perdida: float,
 sla_percentual: float,
):
 horas_ano = 8760
 downtime_horas = horas_ano * (1 - sla_percentual / 100)
 consultas_perdidas = downtime_horas * consultas_por_hora
 prejuizo_anual = consultas_perdidas * valor_por_consulta_perdida

 return {
 "sla": f"{sla_percentual}%",
 "downtime_horas_ano": round(downtime_horas, 1),
 "consultas_perdidas_ano": int(consultas_perdidas),
 "prejuizo_anual": f"R$ {prejuizo_anual:,.2f}",
 }

cenarios = [80, 90, 95, 99, 99.5, 99.9, 99.99]
for sla in cenarios:
 resultado = calcular_impacto_sla(
 consultas_por_hora=200,
 valor_por_consulta_perdida=15.0, # valor médio de um cadastro perdido
 sla_percentual=sla,
 )
 print(f"SLA {resultado['sla']}: {resultado['prejuizo_anual']}")
```

| SLA | Downtime/ano | Consultas perdidas | Prejuízo anual |
|-----|-------------|-------------------|---------------|
| 80% | 1.752h | 350.400 | R$ 5.256.000 |
| 95% | 438h | 87.600 | R$ 1.314.000 |
| 99% | 87,6h | 17.520 | R$ 262.800 |
| 99,9% | 8,76h | 1.752 | R$ 26.280 |
| 99,99% | 0,876h | 175 | R$ 2.628 |

- **Cada nível adicional** -- reduz o prejuízo em aproximadamente 10 vezes
- **O custo do SLA** -- APIs com SLA mais alto geralmente custam mais, mas a economia em perdas evitadas compensa
- **Volume importa** -- operações com alto volume de consultas sentem mais o impacto de cada minuto de downtime

---

## Como cada nível afeta sua arquitetura

O nível de SLA que você precisa determina a complexidade da sua arquitetura de integração.

| SLA necessário | Arquitetura mínima | Complexidade |
|---------------|-------------------|-------------|
| 80-95% | Chamada direta sem fallback | Baixa |
| 99% | Retry com backoff exponencial | Média |
| 99,5% | Retry + cache local | Média |
| 99,9% | Retry + cache + fallback para segundo provedor | Alta |
| 99,99% | Multi-provedor ativo + cache distribuído + circuit breaker | Muito alta |

```bash
# Verificando a disponibilidade real com monitoramento simples
# Execute a cada 1 minuto via cron

#!/bin/bash
ENDPOINT="https://api.cpfhub.io/cpf/12345678909"
API_KEY="sua-chave-aqui"
TIMESTAMP=$(date -u +"%Y-%m-%dT%H:%M:%SZ")

HTTP_CODE=$(curl -s -o /dev/null -w "%{http_code}" \
 -H "x-api-key: $API_KEY" \
 "$ENDPOINT")

RESPONSE_TIME=$(curl -s -o /dev/null -w "%{time_total}" \
 -H "x-api-key: $API_KEY" \
 "$ENDPOINT")

echo "$TIMESTAMP,$HTTP_CODE,$RESPONSE_TIME" >> /var/log/cpf-api-uptime.csv
```

- **Para 99% de SLA** -- um simples retry com timeout já é suficiente para cobrir a maioria das falhas
- **Para 99,9% de SLA** -- adicione cache de resultados recentes para servir respostas durante indisponibilidades curtas
- **Para 99,99% de SLA** -- necessário múltiplos provedores com failover automático e cache distribuído

---

## Escolhendo o SLA certo para seu caso

Não existe um nível de SLA universalmente correto. A escolha depende do impacto do downtime na sua operação específica.

| Tipo de operação | SLA mínimo recomendado | Justificativa |
|-----------------|----------------------|---------------|
| Ferramenta interna / backoffice | 95% | Tolerável esperar, usuários internos |
| E-commerce (cadastro) | 99% | Perda de vendas em picos |
| Fintech (onboarding) | 99,5% | Regulação exige disponibilidade |
| Pagamentos em tempo real | 99,9% | Cada falha impacta transações |
| Infraestrutura crítica (PIX) | 99,99% | Indisponibilidade gera crises |

- **Avalie o custo do downtime** -- se cada minuto fora custa mais do que o SLA premium, invista no nível mais alto
- **Considere horários de pico** -- um downtime de 14 minutos durante a madrugada é diferente de 14 minutos ao meio-dia
- **Combine com sua arquitetura** -- você pode compensar um SLA de 99% do provedor com cache e fallback para atingir 99,9% na sua aplicação

---

## Perguntas frequentes

### O que é necessário para implementar validação de CPF neste contexto?
A validação de CPF exige uma chamada à API com o número do documento e a chave de autenticação. A CPFHub.io retorna o status do CPF, nome do titular e data de nascimento em menos de 200ms, permitindo a verificação em tempo real durante o cadastro ou transação.

### A API CPFHub.io funciona para todos os volumes de consulta?
Sim. O plano gratuito oferece 50 consultas por mês sem cartão de crédito — ideal para testes e projetos pequenos. Para volumes maiores, o plano Pro inclui 1.000 consultas mensais por R$149. Se o limite for ultrapassado, a API não bloqueia: cobra R$0,15 por consulta adicional.

### Como garantir conformidade com a LGPD ao usar uma API de CPF?
Use o CPF apenas para a finalidade declarada ao titular, armazene apenas o necessário (não guarde o CPF cru se um token bastar), implemente controle de acesso aos logs de consulta e documente a base legal para o tratamento. A [ANPD](https://www.gov.br/anpd) orienta que dados de identificação devem ser tratados com o princípio da necessidade.

### Quanto tempo leva para integrar a API CPFHub.io?
A integração básica leva menos de 30 minutos: crie uma conta em cpfhub.io, gere a API key no painel e faça uma chamada GET para `https://api.cpfhub.io/cpf/{CPF}` com o header `x-api-key`. A documentação inclui exemplos em Python, Node.js, PHP, Java e outras linguagens.

### Leia também

- [Checklist para escolher uma API de CPF: o que verificar antes de contratar](https://cpfhub.io/blog/checklist-escolher-api-cpf)
- [Como validar CPF no frontend com React e API REST](https://cpfhub.io/blog/como-validar-cpf-no-frontend-com-react-e-api-rest)
- [10 erros mais comuns ao integrar uma API de CPF e como evitá-los](https://cpfhub.io/blog/10-erros-mais-comuns-ao-integrar-uma-api-de-cpf)
- [API de CPF grátis para desenvolvedores: como começar em 5 minutos](https://cpfhub.io/blog/api-cpf-gratis-desenvolvedores-comecar-5-minutos)

---

## Conclusão

Entender SLAs de API de CPF é fundamental para dimensionar corretamente sua infraestrutura e expectativas. A diferença entre 99% e 99,9% pode parecer pequena, mas representa uma redução de 10 vezes no downtime e no impacto financeiro. Avalie o custo da indisponibilidade para sua operação e escolha o nível adequado. Acesse [cpfhub.io](https://www.cpfhub.io/) para comparar os planos disponíveis — do Grátis (80% SLA) ao Corporativo (99,9% SLA) — e começar a validar CPFs em minutos.