# aut2fa

> API HTTP para envio, acompanhamento e verificação de códigos de uso único.

Base da API: https://api.aut2fa.com. Use Bearer token no servidor.
Live entrega atualmente por WhatsApp; test simula entrega e não consome créditos.
A resposta 202 aceita o envio. Só valid=true na verificação confirma a autenticação.
Código próprio tem 4–10 dígitos; teste sem código usa 000000.
Idempotência depende da aplicação e dos bytes exatos do corpo.

## Documentação
- [Documentação da aut2fa](https://doc.aut2fa.com/): Integre envio e verificação de códigos de uso único pela API HTTP da aut2fa.
- [Início rápido](https://doc.aut2fa.com/quickstart): Crie uma chave de teste, envie um OTP e valide o código no servidor.
- [Autenticação](https://doc.aut2fa.com/authentication): Autentique as chamadas com a chave da aplicação e mantenha a credencial no servidor.
- [Modo de teste](https://doc.aut2fa.com/test-mode): Teste envio, status e verificação sem mensagens reais nem consumo de créditos.
- [Enviar código](https://doc.aut2fa.com/api/send): POST /v1/send: aceite um envio assíncrono de código OTP e receba seu ID.
- [Consultar status](https://doc.aut2fa.com/api/status): GET /v1/send/{id}/status: consulte entrega, verificação e timestamps de um envio.
- [Verificar código](https://doc.aut2fa.com/api/verify): POST /v1/send/{id}/verify: valide um código uma única vez e trate tentativas e expiração.
- [Idempotência](https://doc.aut2fa.com/idempotency): Repita um envio com a mesma chave e os mesmos bytes do corpo sem criar outra cobrança.
- [Entrega e estados](https://doc.aut2fa.com/delivery): Entenda o processamento assíncrono, os estados da mensagem e as falhas de entrega.
- [Limites e reenvio](https://doc.aut2fa.com/limits): Trate os limites de criação de envios, Retry-After e tentativas de verificação.
- [Cota e créditos](https://doc.aut2fa.com/credits): Entenda a cota de cadastro, a reserva em live e a devolução em caso de falha.
- [Clientes HTTP](https://doc.aut2fa.com/integrations): Use clientes HTTP nativos em Node.js, Python e PHP para integrar no servidor.
- [Erros e recuperação](https://doc.aut2fa.com/errors): Consulte os códigos estáveis do envelope application/problem+json e escolha como recuperar.
- [Contrato OpenAPI](https://doc.aut2fa.com/openapi): Importe o contrato público OpenAPI 3.1 da aut2fa em clientes HTTP e geradores.

## Contratos
- [OpenAPI JSON](https://doc.aut2fa.com/openapi.json): contrato público OpenAPI 3.1.
- [Documentação completa em texto](https://doc.aut2fa.com/llms-full.txt): guias e referência.