- Início
- API
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.
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.
| Método e caminho | O que faz |
|---|---|
GET/ | Seu saldo em USD |
GET/ | Todos os serviços, com o menor preço e o número de países |
GET/ | O preço de um número em todos os países para um serviço |
POST/ | Obtém um número para um serviço e país; o preço é descontado do seu saldo |
GET/ | Status de um número e todos os códigos recebidos até agora |
POST/ | Cancela antes de chegar um código; o valor volta para o seu saldo |
Em que ordem chamo a API?
- 1
Obtenha um número POST /numbers com service e country. Guarde o id e o número.
- 2
Digite o número Digite o número no serviço que envia o código.
- 3
Consulte o código GET /numbers/{id} a cada 5 segundos até a lista codes não estar vazia.
- 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 APIQual é 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/v1Authorization: Bearer <API_KEY>Campos da requisição
| Campo | Usado em | Valor |
|---|---|---|
service | POST /numbers, GET /prices | Nome do serviço em /services, ex.: telegram |
country | POST /numbers | Código do país com duas letras, ex.: gb |
Campos da resposta e status
| Valor | Significado |
|---|---|
waiting | O número está ativo e nenhum código chegou ainda |
received | Chegou pelo menos um código; outros ainda podem chegar até expires_at |
refunded | Nenhum código em 20 minutos; o valor voltou para o seu saldo |
canceled | Você 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
unauthorized | Chave de API ausente ou incorreta |
rate_limited | Mais de 120 requisições em um minuto |
bad_service | Nome de serviço desconhecido |
bad_country | País indisponível para esse serviço |
low_balance | O saldo é menor que o preço |
unavailable | Nenhum número disponível agora. Nada foi cobrado |
not_found | Não há número com esse id na sua conta |
cannot_cancel | Um 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"const api = (path, init = {}) => fetch("https://tomnumber.com/api/v1" + path, { ...init, headers: { Authorization: "Bearer " + process.env.API_KEY, "Content-Type": "application/json" }, }).then((r) => r.json()); const n = await api("/numbers", { method: "POST", body: JSON.stringify({ service: "telegram", country: "gb" }) });console.log(n.number); // enter this number in the app let codes = [];while (!codes.length) { await new Promise((r) => setTimeout(r, 5000)); const s = await api("/numbers/" + n.id); if (s.status === "refunded" || s.status === "canceled") break; codes = s.codes;}console.log(codes.map((c) => c.code));import os, time, requests API = "https://tomnumber.com/api/v1"H = {"Authorization": "Bearer " + os.environ["API_KEY"]} n = requests.post(API + "/numbers", json={"service": "telegram", "country": "gb"}, headers=H).json()print(n["number"]) # enter this number in the app while True: time.sleep(5) s = requests.get(API + "/numbers/" + n["id"], headers=H).json() if s["codes"] or s["status"] in ("refunded", "canceled"): breakprint([c["code"] for c in s["codes"]])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.