# Verificação por SMS em Python

Um script completo com a biblioteca requests: compra um número temporário, espera o código e encerra o pedido. Não precisa de SDK.

## Como receber um código de verificação por SMS em Python?

Use requests com o cabeçalho X-Api-Key: POST /v1/orders para receber o número, consulte GET /v1/orders/{id} a cada 4 segundos até messages trazer o SMS, leia messages[-1]["code"] e chame POST finish. Se nada chegar no prazo, chame POST cancel para liberar o valor reservado.

## Preparação

- Python 3.8 ou mais recente.
- pip install requests
- Exporte a chave: export SMSNITRO_API_KEY=...

## Script completo

**activation.py**

```python
import os
import time
import requests

API = "https://smsnitro.com/api/v1"
session = requests.Session()
session.headers["X-Api-Key"] = os.environ["SMSNITRO_API_KEY"]


def api(method, path, **kw):
    r = session.request(method, API + path, timeout=30, **kw)
    if r.status_code >= 400:
        raise RuntimeError(f"{r.status_code}: {r.json().get('detail')}")
    return r.json()


print("Balance:", api("GET", "/balance")["balance"], "USD")

order = api("POST", "/orders", json={"product": "telegram", "country": "usa"})
print("Number:", order["phone"], "order", order["id"])

deadline = time.time() + 600  # numbers stay reserved for up to 20 minutes
while time.time() < deadline:
    order = api("GET", f"/orders/{order['id']}")
    if order["messages"]:
        print("Code:", order["messages"][-1]["code"])
        api("POST", f"/orders/{order['id']}/finish")
        break
    if order["status"] in ("CANCELED", "TIMEOUT", "BANNED", "FINISHED"):
        print("Ended without SMS:", order["status"], "(not charged)")
        break
    time.sleep(4)  # poll every 3 to 5 seconds
else:
    api("POST", f"/orders/{order['id']}/cancel")  # refund the frozen amount
    print("No SMS: cancelled and refunded")
```

## Como o script funciona

- Uma requests.Session mantém a conexão e o cabeçalho da chave em todas as chamadas.
- Qualquer resposta 4xx ou 5xx gera exceção com a mensagem de detail da API.
- Ele consulta a cada 4 segundos por até 10 minutos e depois cancela, então um SMS que não chega não custa nada.
- Troque product e country pelo app e país que você precisa; GET /v1/services lista as opções.

Fonte: https://smsnitro.com/pt/desenvolvedores/python