API λήψης SMS
Αγοράστε αριθμούς και διαβάστε κωδικούς επαλήθευσης μέσω ενός API JSON. Χωρίς έλεγχο ταυτότητας, πληρωμή με κρυπτονόμισμα.
Πώς είναι οργανωμένο το API;
- Δημιουργήστε λογαριασμό και φυλάξτε τη φράση που επιστρέφεται. Είναι η μόνη πρόσβαση, και δεν επαναφέρεται.
- Δημιουργήστε κατάθεση, στείλτε το κρυπτονόμισμα και περιμένετε την πίστωση.
- Αγοράστε αριθμό για την υπηρεσία και τη χώρα που θέλετε — το υπόλοιπο χρεώνεται αμέσως.
- Ζητήστε το 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.
Παράμετροι
| Όνομα | Τύπος | Περιγραφή | |
|---|---|---|---|
limit | integer | προαιρετικό | 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.
Παράμετροι
| Όνομα | Τύπος | Περιγραφή | |
|---|---|---|---|
service | string | υποχρεωτικό | Service code, e.g. telegram |
country | string | υποχρεωτικό | 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_usd | number | υποχρεωτικό | How much to add to the balance, in USD. Minimum 25, maximum 1000. |
coin | string | υποχρεωτικό | 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.
Παράμετροι
| Όνομα | Τύπος | Περιγραφή | |
|---|---|---|---|
id | string | υποχρεωτικό | 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.
Παράμετροι
| Όνομα | Τύπος | Περιγραφή | |
|---|---|---|---|
service | string | υποχρεωτικό | Service code, e.g. telegram |
country | string | υποχρεωτικό | 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.
Παράμετροι
| Όνομα | Τύπος | Περιγραφή | |
|---|---|---|---|
id | string | υποχρεωτικό | 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.
Παράμετροι
| Όνομα | Τύπος | Περιγραφή | |
|---|---|---|---|
id | string | υποχρεωτικό | 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 χωρίς να ξοδέψω τίποτα;
Ο κατάλογος, ο υπολογισμός τιμής και η δημιουργία λογαριασμού είναι δωρεάν: το μεγαλύτερο μέρος μιας ενσωμάτωσης μπορεί λοιπόν να γραφτεί και να ελεγχθεί πριν από οποιαδήποτε κατάθεση. Μόνο η αγορά κοστίζει χρήματα.