API per ricevere SMS

Acquisti numeri e legga i codici di verifica tramite un’API JSON. Senza controlli d’identità, pagamento in criptovaluta.

REST · JSONOpenAPI 3.1 Specifica OpenAPI →

Come è organizzata l’API?

1. Crei un account e conservi la frase restituita. È l’unico accesso, e non è reimpostabile.
2. Crei una ricarica, invii la criptovaluta e attenda l’accredito.
3. Acquisti un numero per il servizio e il paese desiderati — il saldo viene scalato subito.
4. Interroghi l’SMS contenente il codice. Se nessun codice arriva prima della scadenza dell’ordine, il denaro viene rimborsato automaticamente.

Ricarichi una volta, acquisti spesso: una ricarica copre tutti i numeri che il saldo consente, quindi solo il primo acquisto attende una conferma.

Autenticazione

Trasmetta la frase dell’account come token bearer. Non esiste né una chiave API separata né una chiamata di accesso — la frase è l’identificativo.

Authorization: Bearer YOUR-SEED-PHRASE

Gli endpoint del catalogo non richiedono alcuna autenticazione: servizi, paesi e prezzi si consultano quindi anche prima di avere un account. Tutto ciò che riguarda il denaro e gli ordini esige l’intestazione.

Indirizzo di base

Tutti gli endpoint sono relativi a:

https://www.otpdrop.com/api/v1

Le risposte sono in JSON. I corpi POST sono accettati in application/json o in application/x-www-form-urlencoded.

Errori

In caso di fallimento viene restituito uno stato diverso da 2xx con un unico oggetto di errore.

{
  "error": {
    "code": "invalid_request",
    "message": "unknown service: \"whatsap\""
  }
}

Messaggi frequenti con 422:

Ci sono limiti di frequenza?

Non è pubblicata alcuna quota, e non esiste alcuna chiave API da limitare — ma chiamare gli endpoint in ciclo non è gratis. Due di essi sono fatti per essere interrogati ripetutamente e richiedono un’attenzione particolare.

Un traffico che somiglia a un attacco sarà bloccato a monte, senza un cortese 429. Se ha un motivo legittimo per interrogare più spesso, ci scriva prima dalla pagina dei contatti.

Come si presenta un’integrazione completa?

Dall’account al codice, sei chiamate. Tutto ciò che segue è reale: incolli ed esegua.

# 1. Creare un account e conservare la frase
SEED=$(curl -s -X POST https://www.otpdrop.com/api/v1/accounts | jq -r .seed)

# 2. Ricaricare — invii coin_amount all’indirizzo restituito
curl -s -X POST https://www.otpdrop.com/api/v1/topups \
  -H "Authorization: Bearer \$SEED" \
  -H 'content-type: application/json' \
  -d '{"amount_usd": 25, "coin": "USDT"}'

# 3. Interrogare fino all’accredito della ricarica
curl -s https://www.otpdrop.com/api/v1/topups/TOPUP_ID \
  -H "Authorization: Bearer \$SEED" | jq .status

# 4. Verificare il prezzo prima di acquistare
curl -s 'https://www.otpdrop.com/api/v1/quote?service=telegram&country=us'

# 5. Acquistare — il saldo viene scalato, il numero consegnato subito
ORDER=$(curl -s -X POST https://www.otpdrop.com/api/v1/orders \
  -H "Authorization: Bearer \$SEED" \
  -H 'content-type: application/json' \
  -d '{"service": "telegram", "country": "us"}' | jq -r .order_id)

# 6. Interrogare il codice
until curl -s https://www.otpdrop.com/api/v1/orders/\$ORDER/sms \
  -H "Authorization: Bearer \$SEED" | jq -e .code; do sleep 4; done

La stessa sequenza in Python, senza shell:

import time, requests

API = "https://www.otpdrop.com/api/v1"
seed = requests.post(f"{API}/accounts").json()["seed"]
auth = {"Authorization": f"Bearer {seed}"}

topup = requests.post(f"{API}/topups", headers=auth,
                      json={"amount_usd": 25, "coin": "USDT"}).json()
print("send", topup["coin_amount"], topup["coin"], "to", topup["address"])

while requests.get(f"{API}/topups/{topup['topup_id']}",
                   headers=auth).json()["status"] != "credited":
    time.sleep(15)

order = requests.post(f"{API}/orders", headers=auth,
                      json={"service": "telegram", "country": "us"}).json()
print("number:", order["phone"])

while True:
    sms = requests.get(f"{API}/orders/{order['order_id']}/sms",
                       headers=auth).json()
    if sms["arrived"]:
        print("code:", sms["code"])
        break
    time.sleep(4)

Server MCP

Le stesse operazioni sono disponibili tramite il Model Context Protocol su https://www.otpdrop.com/mcp, sotto forma di undici strumenti. Per aggiungerlo a Claude Code:

claude mcp add --transport http otpdrop https://www.otpdrop.com/mcp

La configurazione e l’elenco completo degli strumenti si trovano nella pagina per gli agenti.

File di scoperta

Descrizioni del servizio leggibili dalle macchine, tutte servite senza autenticazione.

Domande frequenti

Serve una chiave per l’API di OTPDrop?

No. Non c’è nulla da richiedere e nessuna approvazione. L’identificativo è la frase dell’account, trasmessa come token bearer — e gli endpoint del catalogo non ne hanno nemmeno bisogno.

Quanto costa l’API di OTPDrop?

Nulla oltre ai numeri stessi. Nessun abbonamento, nessuna fatturazione a chiamata, nessun volume minimo — i prezzi sono quelli del sito.

Con quali linguaggi di programmazione funziona l’API?

Qualsiasi linguaggio in grado di eseguire una richiesta HTTPS. È normale JSON su HTTP con un’intestazione bearer: nessun SDK da installare e nulla da sincronizzare con le nostre versioni.

Cosa succede se l’SMS non arriva?

L’ordine si rimborsa da solo sul saldo alla scadenza; può anche annullarlo prima dal sito. Paga i codici consegnati, non i tentativi.

L’API REST e il server MCP sono la stessa cosa?

Sì, deliberatamente. Ogni endpoint REST è la traduzione di una chiamata di strumento MCP, quindi non possono divergere: modificare l’uno significa modificare l’altro. Scelga quello che si adatta meglio al suo client.

Si può provare l’API senza spendere nulla?

Il catalogo, il calcolo del prezzo e la creazione dell’account sono gratuiti: gran parte di un’integrazione può quindi essere scritta e verificata prima di qualsiasi ricarica. Solo l’acquisto costa denaro.