Reenviar código OTP

Name: FonteData
Author: FonteData

POST https://app.fontedata.com/api/v1/consulta/otp-resend

R$ 0,29 por crédito de SMS (160 caracteres)

Debitado do seu saldo a cada chamada cobrada. Autenticação pelo header X-API-Key. Veja como obter a chave.

Reenvia o código de uma verificação ainda em aberto, reaproveitando o mesmo request_id, o mesmo texto e o mesmo número do envio original.

⚠️ O reenvio GERA UM CÓDIGO NOVO. O código anterior deixa de valer imediatamente — existe sempre um único código válido por request_id. Se o usuário digitar o código da primeira mensagem depois de pedir o reenvio, a verificação falha; oriente-o a usar sempre a mensagem mais recente.

O reenvio não estende a validade. O prazo continua contando a partir do envio original: se faltavam 40 segundos, o novo código também vale por 40 segundos. Quando o prazo acaba, não há mais reenvio — emita outro código com Enviar código OTP.

Cada reenvio é um SMS novo e é cobrado como tal, em créditos, pela mesma regra de 160 caracteres. Há um intervalo mínimo de 30 segundos entre reenvios.

Requisição

curl -X POST -H "X-API-Key: SUA_CHAVE" \
  "https://app.fontedata.com/api/v1/consulta/otp-resend?request_id=otp_5c1d0e00000000000000000000000000"

Parâmetros

Nome	Tipo	Descrição	Exemplo
request_id obrigatório	texto	Identificador da verificação em aberto.	otp_5c1d0e00000000000000000000000000

Resposta

request_id — O mesmo identificador de antes.
status — Situação do reenvio (sent = aceito para envio).

Os créditos cobrados em cada reenvio ficam registrados no seu painel, em Uso e no Extrato.

Exemplo — 200 OK

{
  "status": "sent",
  "creditos": 1,
  "request_id": "otp_5c1d0e00000000000000000000000000"
}

Schema da resposta (JSON Schema)

JSON Schema

{
  "type": "object",
  "properties": {
    "status": {
      "type": [
        "string",
        "null"
      ]
    },
    "creditos": {
      "type": [
        "integer",
        "null"
      ],
      "description": "Créditos de 160 caracteres cobrados neste envio."
    },
    "request_id": {
      "type": [
        "string",
        "null"
      ]
    }
  },
  "additionalProperties": true
}

Códigos de erro

Código	Mensagem	Quando acontece
402	Saldo insuficiente.	A conta não tem saldo para cobrir o reenvio.
403	Número em opt-out.	A pessoa pediu para sair (respondeu SAIR) ou a operadora bloqueou o número depois do primeiro envio.
404	Verificação não encontrada.	O `request_id` não existe ou pertence a outra conta.
409	Esta verificação não aceita reenvio.	O código já foi verificado, já travou por excesso de tentativas ou expirou. Em qualquer um dos casos, emita um novo código com Enviar código OTP.
429	Aguarde antes de reenviar.	O reenvio tem intervalo mínimo de 30 segundos. O cabeçalho `Retry-After` diz quanto falta.
503	Serviço de envio temporariamente indisponível.	A plataforma de envio está instável; tente novamente em instantes.

Quando usar

Ofereça o reenvio quando o usuário disser que não recebeu — mas só depois de uns 30 segundos, que é o tempo típico de entrega. Reenviar cedo demais costuma render duas mensagens e um usuário digitando a errada.

Se a verificação já expirou ou travou, não insista no reenvio: comece de novo com Enviar código OTP.

Integrar

OpenAPI (JSON) ↗ — importe a URL no Postman ou no Insomnia para gerar a coleção com todos os endpoints. Também dá para consultar pelo chat: conecte via MCP. Esta página em Markdown.