>otpfactory.io

API

REST API para pedir números virtuais, consultar SMS, gerenciar aluguel de números e recarregar a carteira. Os mesmos endpoints que o dashboard usa — autenticação por bearer token, JSON entrada e saída, sem SDK necessário.

Autenticação

Gere um token API pessoal em Dashboard → Tokens API. Inclua-o como header bearer em toda requisição:

Authorization: Bearer <your-token>

URL base

https://api.otpfactory.com

Endpoints

  • GET/v1/servicesListe serviços suportados com preços atuais por país.
  • GET/v1/countriesListe países com estoque ativo.
  • POST/v1/ordersapiPage.endpoints.items.createOrder
  • GET/v1/orders/:idapiPage.endpoints.items.getOrder
  • DELETE/v1/orders/:idCancele um pedido ativo. Reembolsa a carteira se nenhum SMS foi recebido.
  • POST/v1/paymentsapiPage.endpoints.items.createPayment
  • GET/v1/walletObtenha o saldo atual da carteira e transações recentes.
  • GET/v1/rentalsListe aluguel de números ativos de longo prazo.

Início rápido

curl -X POST https://api.otpfactory.com/v1/orders \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"serviceSlug":"telegram","countryIso":"US"}'

Limites de taxa

  • • Criar pedidos: 30 requisições / minuto / token
  • • Consultar pedidos: 120 requisições / minuto / token
  • • Pagamentos / depósitos: 10 requisições / hora / token
  • • Fallback global por IP: 120 requisições / minuto (se aplica mesmo sem token)

Ao atingir um limite, retorna HTTP 429 com um header Retry-After.

Precisa de um limite maior?

Entre em contato @otpfactory_support com seu caso de uso. Planos reseller e integração ganham orçamento 10x maior em endpoints de pedidos.