API λήψης SMS

Αγοράστε αριθμούς και διαβάστε κωδικούς επαλήθευσης μέσω ενός API JSON. Χωρίς έλεγχο ταυτότητας, πληρωμή με κρυπτονόμισμα.

REST · JSONOpenAPI 3.1 Προδιαγραφή OpenAPI →

Κάθε λειτουργία εδώ είναι επίσης εργαλείο MCP. Τα σημεία πρόσβασης REST είναι η μετάφραση των ίδιων εργαλείων που εκθέτει ο διακομιστής MCP: ένας αυτόνομος πράκτορας και μια συνηθισμένη ενσωμάτωση συμπεριφέρονται λοιπόν πανομοιότυπα. Αν κατευθύνετε έναν πράκτορα ΤΝ στο OTPDrop, ξεκινήστε από την ενότητα για τους πράκτορες.

Πώς είναι οργανωμένο το API;

  1. Δημιουργήστε λογαριασμό και φυλάξτε τη φράση που επιστρέφεται. Είναι η μόνη πρόσβαση, και δεν επαναφέρεται.
  2. Δημιουργήστε κατάθεση, στείλτε το κρυπτονόμισμα και περιμένετε την πίστωση.
  3. Αγοράστε αριθμό για την υπηρεσία και τη χώρα που θέλετε — το υπόλοιπο χρεώνεται αμέσως.
  4. Ζητήστε το SMS με τον κωδικό. Αν δεν έρθει κωδικός πριν λήξει η παραγγελία, τα χρήματα επιστρέφονται αυτόματα.

Καταθέστε μία φορά, αγοράστε πολλές: μια κατάθεση καλύπτει όσους αριθμούς επιτρέπει το υπόλοιπο, οπότε μόνο η πρώτη αγορά περιμένει επιβεβαίωση.

Αυθεντικοποίηση

Στείλτε τη φράση του λογαριασμού ως διακριτικό bearer. Δεν υπάρχει ξεχωριστό κλειδί API ούτε κλήση σύνδεσης — η φράση είναι το διαπιστευτήριο.

Authorization: Bearer YOUR-SEED-PHRASE

Τα σημεία πρόσβασης του καταλόγου δεν ζητούν καμία αυθεντικοποίηση: υπηρεσίες, χώρες και τιμές είναι λοιπόν ορατές πριν καν υπάρξει λογαριασμός. Ό,τι αφορά χρήματα και παραγγελίες απαιτεί την κεφαλίδα.

Η φράση δεν ανακτάται. Κρατάμε μόνο το αποτύπωμά της. Αν τη χάσετε, ο λογαριασμός και το υπόλοιπό του εξαφανίζονται, χωρίς επαναφορά και χωρίς προσφυγή στην υποστήριξη.

Βασική διεύθυνση

Όλα τα σημεία πρόσβασης είναι σχετικά ως προς:

https://otpdrop.com/api/v1

Οι αποκρίσεις είναι σε JSON. Τα σώματα POST γίνονται δεκτά σε application/json ή σε application/x-www-form-urlencoded.

Σφάλματα

Σε περίπτωση αποτυχίας επιστρέφεται κατάσταση εκτός 2xx μαζί με ένα μοναδικό αντικείμενο σφάλματος.

{
  "error": {
    "code": "invalid_request",
    "message": "unknown service: \"whatsap\""
  }
}
ΚατάστασηΣημασία
200Επιτυχία
201Δημιουργήθηκε — ο λογαριασμός, η κατάθεση ή η παραγγελία υπάρχει πλέον
401Φράση απούσα ή εσφαλμένη στην κεφαλίδα Authorization
422Το αίτημα έγινε κατανοητό, αλλά δεν μπορεί να εκτελεστεί
500Αστοχία από τη δική μας πλευρά

Συχνά μηνύματα σε 422:

ΜήνυμαΑιτία
insufficient_fundsΤο υπόλοιπο είναι μικρότερο από την τιμή — δημιουργήστε πρώτα κατάθεση
unknown serviceΑυτός ο κωδικός υπηρεσίας δεν υπάρχει· δείτε τον κατάλογο υπηρεσιών
unknown countryΑυτός ο κωδικός χώρας δεν υπάρχει· δείτε τον κατάλογο χωρών
unknown coinΜη αποδεκτό νόμισμα· δείτε το σημείο πρόσβασης κατάθεσης
amount_usd must be between…Οι καταθέσεις περιορίζονται σε $25–$1000

Υπάρχουν όρια ρυθμού;

Δεν δημοσιεύεται καμία ποσόστωση, και δεν υπάρχει κλειδί API προς περιορισμό — αλλά η κλήση των σημείων πρόσβασης σε βρόχο δεν είναι δωρεάν. Δύο από αυτά είναι φτιαγμένα για επαναλαμβανόμενες κλήσεις και απαιτούν ιδιαίτερη προσοχή.

Σημείο πρόσβασηςΛογικός ρυθμόςΓιατί
Κατάλογος και υπολογισμός τιμήςΑποθηκεύστε τα τοπικάΟι τιμές αλλάζουν σπάνια· η επαναφόρτωση του καταλόγου σε κάθε αίτημα δεν χρησιμεύει σε τίποτα.
/topups/{id}Κάθε 10 με 15 δευτερόλεπταΜια επιβεβαίωση δικτύου παίρνει λεπτά, όχι χιλιοστά του δευτερολέπτου. Το συχνότερο ερώτημα δεν μαθαίνει τίποτα νωρίτερα.
/orders/{id}/smsΚάθε 3 με 5 δευτερόλεπταΟι κωδικοί έρχονται συνήθως σε δευτερόλεπτα· ένας πιο σφιχτός βρόχος προσθέτει μόνο φόρτο.
ΑγοράΌποτε χρειάζεταιΚάθε αγορά χρεώνει πραγματικά χρήματα, οπότε ένας βρόχος χωρίς φρένο θα κοστίσει περισσότερο σε εσάς παρά σε εμάς.

Κίνηση που μοιάζει με επίθεση θα μπλοκαριστεί ανάντη, χωρίς ένα ευγενικό 429. Αν έχετε βάσιμο λόγο να κάνετε συχνότερα ερωτήματα, γράψτε μας πρώτα μέσω της σελίδας επικοινωνίας.

Κατάλογος υπηρεσιών

GET/api/v1/services

Όλες οι υπηρεσίες με τον κωδικό, την κατηγορία και την ελάχιστη τιμή τους. Δεν απαιτείται αυθεντικοποίηση.

Αίτημα

curl -s https://otpdrop.com/api/v1/services

Απόκριση

{
  "services": [
    {
      "code": "binance",
      "name": "Binance",
      "category": "Finance",
      "from_price_cents": 85,
      "color": "#F0B90B",
      "icon": "binance"
    }
  ],
  "count": 133
}

Κατάλογος χωρών

GET/api/v1/countries

Every country with its dial code and how many services are available there. No authentication required.

Αίτημα

curl -s https://otpdrop.com/api/v1/countries

Απόκριση

{
  "countries": [
    {
      "code": "us",
      "name": "United States",
      "dial_code": "+1",
      "service_count": 133
    }
  ],
  "count": 197
}

Πίνακας τιμών

GET/api/v1/catalog

The most useful service and country combinations with their prices, cheapest first. No authentication required.

Παράμετροι

ΌνομαΤύποςΠεριγραφή
limitintegerπροαιρετικόHow many rows to return, 1 to 500. Defaults to 12.

Αίτημα

curl -s 'https://otpdrop.com/api/v1/catalog?limit=2'

Απόκριση

{
  "items": [
    {
      "service": "badoo",
      "country": "us",
      "price_cents": 35
    }
  ],
  "count": 2
}

Υπολογισμός τιμής

GET/api/v1/quote

The exact price for one service and country before you commit to buying. No authentication required.

Παράμετροι

ΌνομαΤύποςΠεριγραφή
servicestringυποχρεωτικόService code, e.g. telegram
countrystringυποχρεωτικόCountry code, e.g. us

Αίτημα

curl -s 'https://otpdrop.com/api/v1/quote?service=telegram&country=us'

Απόκριση

{
  "service": "telegram",
  "country": "us",
  "price_cents": 111,
  "price_usd": "1.11",
  "currency": "USD",
  "purchasable": true
}

Δημιουργία λογαριασμού

POST/api/v1/accounts

Generates an account and returns its seed. This is the only time the seed is ever shown. No authentication required.

Αίτημα

curl -s -X POST https://otpdrop.com/api/v1/accounts

Απόκριση

{
  "public_id": "acc_7f3c1a92",
  "seed": "PABh-ZbRt-9xKm-Lq4V",
  "seed_prefix": "PABh",
  "balance_cents": 0,
  "warning": "This seed is shown exactly once, right now..."
}

Δημιουργία κατάθεσης

POST/api/v1/topups

Claims a deposit address and returns the exact amount to send, as coin_amount, at the rate in rate_usd. Each top-up gets its own address, and it expires at expires_at. Send only the named coin, on the named network, before then.

Παράμετροι

ΌνομαΤύποςΠεριγραφή
amount_usdnumberυποχρεωτικόHow much to add to the balance, in USD. Minimum 25, maximum 1000.
coinstringυποχρεωτικόBTC, LTC, ETH, XMR, SOL, TRX, BNB, USDT, USDC and more

Αίτημα

curl -s -X POST https://otpdrop.com/api/v1/topups \
  -H 'Authorization: Bearer YOUR-SEED' \
  -H 'content-type: application/json' \
  -d '{"amount_usd": 25, "coin": "XMR"}'

Απόκριση

{
  "topup_id": "top_019195919c80fc8f",
  "status": "awaiting_payment",
  "coin": "XMR",
  "address": "89Rm4XN39m9PCr8Sr3yAFnXvLRRWQVEE...",
  "amount_cents": 2500,
  "amount_usd": "25.00",
  "coin_amount": "0.1337",
  "rate_usd": 187.02,
  "bonus_cents": 0,
  "credited_total_cents": 2500,
  "expires_at": 1788532810
}

Κατάσταση κατάθεσης

GET/api/v1/topups/{id}

Whether a deposit has been credited. Confirmation is not instant — poll this rather than assuming the funds arrived.

Παράμετροι

ΌνομαΤύποςΠεριγραφή
idstringυποχρεωτικόThe top-up id, in the path

Αίτημα

curl -s https://otpdrop.com/api/v1/topups/top_019195919c80fc8f \
  -H 'Authorization: Bearer YOUR-SEED'

Απόκριση

{
  "topup_id": "top_019195919c80fc8f",
  "status": "credited",
  "coin": "XMR",
  "amount_usd": "25.00",
  "coin_amount": "0.1337",
  "credited_total_cents": 2500,
  "expires_at": 1788532810
}

Αγορά αριθμού

POST/api/v1/orders

Debits the balance and issues a number immediately. There is no per-purchase address and no second wait. Fails with insufficient_funds if the balance is short.

Παράμετροι

ΌνομαΤύποςΠεριγραφή
servicestringυποχρεωτικόService code, e.g. telegram
countrystringυποχρεωτικόCountry code, e.g. us

Αίτημα

curl -s -X POST https://otpdrop.com/api/v1/orders \
  -H 'Authorization: Bearer YOUR-SEED' \
  -H 'content-type: application/json' \
  -d '{"service": "telegram", "country": "us"}'

Απόκριση

{
  "order_id": "ord_1ad450bf7a42519c",
  "service": "telegram",
  "country": "us",
  "phone": "+15558329008",
  "status": "paid",
  "price_usd": "1.11"
}

Κατάλογος των παραγγελιών σας

GET/api/v1/orders

Every order on the account, newest first, with status, number and price. Useful for reconciling state after a restart rather than for polling.

Αίτημα

curl -s https://otpdrop.com/api/v1/orders \
  -H 'Authorization: Bearer YOUR-SEED'

Απόκριση

{
  "orders": [
    {
      "order_id": "ord_1ad450bf7a42519c",
      "service": "telegram",
      "country": "us",
      "phone": "+15558329008",
      "status": "paid",
      "price_usd": "1.11"
    }
  ],
  "count": 1
}

Προβολή παραγγελίας

GET/api/v1/orders/{id}

The current state of one order: its number, status and price.

Παράμετροι

ΌνομαΤύποςΠεριγραφή
idstringυποχρεωτικόThe order id, in the path

Αίτημα

curl -s https://otpdrop.com/api/v1/orders/ord_1ad450bf7a42519c \
  -H 'Authorization: Bearer YOUR-SEED'

Απόκριση

{
  "order_id": "ord_1ad450bf7a42519c",
  "service": "telegram",
  "country": "us",
  "phone": "+15558329008",
  "status": "paid",
  "price_usd": "1.11"
}

Ανάκτηση του SMS με τον κωδικό

GET/api/v1/orders/{id}/sms

Poll this until arrived turns true. If the order expires with nothing delivered, the price returns to your balance automatically.

Παράμετροι

ΌνομαΤύποςΠεριγραφή
idstringυποχρεωτικόThe order id, in the path

Αίτημα

curl -s https://otpdrop.com/api/v1/orders/ord_1ad450bf7a42519c/sms \
  -H 'Authorization: Bearer YOUR-SEED'

Απόκριση

{
  "order_id": "ord_1ad450bf7a42519c",
  "status": "paid",
  "arrived": false,
  "code": null
}

Πώς μοιάζει μια πλήρης ενσωμάτωση;

Από τον λογαριασμό ως τον κωδικό, έξι κλήσεις. Όλα όσα ακολουθούν είναι πραγματικά: επικολλήστε και εκτελέστε.

# 1. Δημιουργία λογαριασμού και φύλαξη της φράσης
SEED=$(curl -s -X POST https://otpdrop.com/api/v1/accounts | jq -r .seed)

# 2. Κατάθεση — στείλτε το coin_amount στη διεύθυνση που επιστρέφεται
curl -s -X POST https://otpdrop.com/api/v1/topups \
  -H "Authorization: Bearer \$SEED" \
  -H 'content-type: application/json' \
  -d '{"amount_usd": 25, "coin": "USDT"}'

# 3. Ερώτημα μέχρι να πιστωθεί η κατάθεση
curl -s https://otpdrop.com/api/v1/topups/TOPUP_ID \
  -H "Authorization: Bearer \$SEED" | jq .status

# 4. Έλεγχος της τιμής πριν από την αγορά
curl -s 'https://otpdrop.com/api/v1/quote?service=telegram&country=us'

# 5. Αγορά — το υπόλοιπο χρεώνεται, ο αριθμός παραδίδεται αμέσως
ORDER=$(curl -s -X POST https://otpdrop.com/api/v1/orders \
  -H "Authorization: Bearer \$SEED" \
  -H 'content-type: application/json' \
  -d '{"service": "telegram", "country": "us"}' | jq -r .order_id)

# 6. Ερώτημα για τον κωδικό
until curl -s https://otpdrop.com/api/v1/orders/\$ORDER/sms \
  -H "Authorization: Bearer \$SEED" | jq -e .code; do sleep 4; done

Η ίδια ακολουθία σε Python, χωρίς φλοιό:

import time, requests

API = "https://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)

Διακομιστής MCP

Οι ίδιες λειτουργίες διατίθενται μέσω του Model Context Protocol στο https://otpdrop.com/mcp, με τη μορφή έντεκα εργαλείων. Για να τον προσθέσετε στο Claude Code:

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

Η διαμόρφωση και ο πλήρης κατάλογος των εργαλείων βρίσκονται στη σελίδα για τους πράκτορες.

Αρχεία ανακάλυψης

Περιγραφές της υπηρεσίας αναγνώσιμες από μηχανές, όλες διαθέσιμες χωρίς αυθεντικοποίηση.

ΑρχείοΠεριεχόμενο
/openapi.jsonΤο πλήρες σχήμα OpenAPI 3.1
/.well-known/agent.jsonΔυνατότητες, μοντέλο αυθεντικοποίησης και κανόνες λειτουργίας
/llms.txtΈνα σύντομο σημείο αναφοράς για τα γλωσσικά μοντέλα
/llms-full.txtΤο ίδιο, με τον πλήρη κατάλογο

Συχνές ερωτήσεις

Χρειάζεται κλειδί για το API του OTPDrop;

Όχι. Δεν υπάρχει τίποτα να ζητήσετε και καμία έγκριση. Το διαπιστευτήριο είναι η φράση του λογαριασμού, που στέλνεται ως διακριτικό bearer — και τα σημεία πρόσβασης του καταλόγου δεν το χρειάζονται καν.

Πόσο κοστίζει το API του OTPDrop;

Τίποτα πέρα από τους ίδιους τους αριθμούς. Ούτε συνδρομή, ούτε χρέωση ανά κλήση, ούτε ελάχιστος όγκος — οι τιμές είναι αυτές του ιστότοπου.

Με ποιες γλώσσες προγραμματισμού λειτουργεί το API;

Με κάθε γλώσσα ικανή να κάνει ένα αίτημα HTTPS. Είναι απλό JSON μέσω HTTP με μια κεφαλίδα bearer: κανένα SDK προς εγκατάσταση, και τίποτα προς συγχρονισμό με τις εκδόσεις μας.

Τι γίνεται αν δεν έρθει το SMS;

Η παραγγελία επιστρέφεται από μόνη της στο υπόλοιπο όταν λήξει· μπορείτε επίσης να την ακυρώσετε νωρίτερα από τον ιστότοπο. Πληρώνετε τους κωδικούς που παραδόθηκαν, όχι τις απόπειρες.

Είναι το REST API και ο διακομιστής MCP το ίδιο πράγμα;

Ναι, σκόπιμα. Κάθε σημείο πρόσβασης REST είναι μετάφραση μιας κλήσης εργαλείου MCP, οπότε δεν μπορούν να αποκλίνουν: αλλάζοντας το ένα αλλάζει και το άλλο. Επιλέξτε αυτό που ταιριάζει καλύτερα στον πελάτη σας.

Μπορώ να δοκιμάσω το API χωρίς να ξοδέψω τίποτα;

Ο κατάλογος, ο υπολογισμός τιμής και η δημιουργία λογαριασμού είναι δωρεάν: το μεγαλύτερο μέρος μιας ενσωμάτωσης μπορεί λοιπόν να γραφτεί και να ελεγχθεί πριν από οποιαδήποτε κατάθεση. Μόνο η αγορά κοστίζει χρήματα.