Pular para o conteúdo
tomnumber

API de verificação por SMS

Compre números e leia códigos pelo seu próprio software. A API usa o seu saldo, os mesmos preços e a mesma regra de reembolso de 20 minutos do site.

Você cria a chave de API na sua conta. Os números comprados pela API saem do mesmo saldo, com os mesmos preços do site.

Criar uma contaChave de API

A partir de $0.0018 por número

Principais dados

Menor preço por número
$0.0018
Autenticação
Chave de API
Formato
JSON via HTTPS
Limite de requisições
120 requisições por minuto
Reembolso
Igual ao site

REST e JSON

Seis requisições cobrem saldo, serviços, preços, obter um número, status e cancelamento.

Uma chave da sua conta

Crie uma chave na página Chave de API da sua conta e envie no cabeçalho Authorization.

Mesmos preços do site

Os preços dos números e a regra de reembolso de 20 minutos são os mesmos do site.

Quais requisições posso enviar?

Os caminhos vêm depois da URL base. Toda requisição precisa da sua chave de API.

Quais requisições posso enviar?
Método e caminhoO que faz
GET/balanceSeu saldo em USD
GET/servicesTodos os serviços, com o menor preço e o número de países
GET/prices?service=telegramO preço de um número em todos os países para um serviço
POST/numbersObtém um número para um serviço e país; o preço é descontado do seu saldo
GET/numbers/{id}Status de um número e todos os códigos recebidos até agora
POST/numbers/{id}/cancelCancela antes de chegar um código; o valor volta para o seu saldo

Em que ordem chamo a API?

  1. 1

    Obtenha um número POST /numbers com service e country. Guarde o id e o número.

  2. 2

    Digite o número Digite o número no serviço que envia o código.

  3. 3

    Consulte o código GET /numbers/{id} a cada 5 segundos até a lista codes não estar vazia.

  4. 4

    Conclua Use o código. Se não precisar mais do número antes de o código chegar, cancele.

Como obter uma chave de API?

Entre e abra Chave de API na sua conta. Crie uma chave e copie na hora; ela aparece só uma vez. Criar uma chave nova desativa a anterior.

Chave de API

Qual é a URL base?

Envie todas as requisições para este endereço com a chave no cabeçalho Authorization (Bearer) ou no cabeçalho X-Api-Key:

https://tomnumber.com/api/v1
Authorization: Bearer <API_KEY>

Campos da requisição

Campos da requisição
CampoUsado emValor
servicePOST /numbers, GET /pricesNome do serviço em /services, ex.: telegram
countryPOST /numbersCódigo do país com duas letras, ex.: gb

Campos da resposta e status

Campos da resposta e status
ValorSignificado
waitingO número está ativo e nenhum código chegou ainda
receivedChegou pelo menos um código; outros ainda podem chegar até expires_at
refundedNenhum código em 20 minutos; o valor voltou para o seu saldo
canceledVocê cancelou antes de chegar um código; o valor voltou para o seu saldo

Exemplo de resposta

{  "ok": true,  "id": "R8KQ2M7XWD4P",  "service": "telegram",  "country": "gb",  "number": "+44 7700 900412",  "price": "0.167",  "status": "received",  "expires_at": "2026-11-11T09:20:00.000Z",  "codes": [    { "code": "483920", "text": "Telegram code: 483920", "received_at": "2026-11-11T09:01:12.000Z" }  ]}

Códigos de erro

Códigos de erro
unauthorizedChave de API ausente ou incorreta
rate_limitedMais de 120 requisições em um minuto
bad_serviceNome de serviço desconhecido
bad_countryPaís indisponível para esse serviço
low_balanceO saldo é menor que o preço
unavailableNenhum número disponível agora. Nada foi cobrado
not_foundNão há número com esse id na sua conta
cannot_cancelUm código já chegou ou o número está encerrado

Exemplos de código

# get a numbercurl -X POST https://tomnumber.com/api/v1/numbers \  -H "Authorization: Bearer $API_KEY" \  -H "Content-Type: application/json" \  -d '{"service":"telegram","country":"gb"}' # check for codescurl https://tomnumber.com/api/v1/numbers/R8KQ2M7XWD4P \  -H "Authorization: Bearer $API_KEY"

Perguntas frequentes sobre a API de verificação por SMS

O que é uma API de verificação por SMS?

Uma forma de comprar números e ler códigos pelo seu próprio programa, em vez de usar o site.

A API tem custo extra?

Não. Os números custam o mesmo que no site e são pagos com o mesmo saldo.

Quantas requisições posso enviar?

Até 120 requisições por minuto por chave. Consultar a cada 5 segundos fica bem abaixo disso.

Os números da API também são reembolsados?

Sim, pela mesma regra: sem código em 20 minutos, o valor volta para o seu saldo.

Onde crio a chave?

Na sua conta, em Chave de API.

Números virtuais para outros serviços