Temp Number API - Telefon Numarası, SMS ve OTP
Sanal telefon numaraları edinin, SMS'leri gerçek zamanlı alın ve OTP doğrulamasını otomatikleştirin - sade bir REST API'den veya doğrudan yapay zeka asistanınızdan.
https://api.temp-number.com/v1
Ana Sayfa / Geliştiriciler
Giriş
Temp Number API, öngörülebilir kaynaklar etrafında düzenlenmiştir, standart HTTP fiillerini kullanır ve her yanıtı JSON olarak döndürür. Tek bir anahtar yalnızca kendi hesabınıza okuma ve yazma erişimi verir - hesaplar arası erişim yoktur.
Hızlı başlangıç
Sıfırdan doğrulama koduna. Dilinizi bir kez seçin - sayfadaki tüm örnekler ona göre gösterilir.
-
API anahtarı oluşturun
Panel → API Erişimi bölümünde bir anahtar oluşturun. Yalnızca bir kez gösterilir: onu
TEMP_NUMBER_API_KEYortam değişkeni olarak saklayın. -
Bakiyenizi kontrol edin
Her çağrı anahtarınızı Authorization başlığında taşır. Zararsız bir şeyle başlayın: cüzdan bakiyeniz.
curl --request GET "https://api.temp-number.com/v1/account" \ --header "Authorization: Bearer $TEMP_NUMBER_API_KEY" \ --header "Accept: application/json"const response = await fetch("https://api.temp-number.com/v1/account", { headers: { Authorization: `Bearer ${process.env.TEMP_NUMBER_API_KEY}`, Accept: "application/json", }, }); const result = await response.json(); console.log(response.status, result);import os import requests response = requests.get( "https://api.temp-number.com/v1/account", headers={ "Authorization": f"Bearer {os.environ['TEMP_NUMBER_API_KEY']}", "Accept": "application/json", }, timeout=30, ) print(response.status_code, response.json())use Illuminate\Support\Facades\Http; // config/services.php: 'temp_number' => ['key' => env('TEMP_NUMBER_API_KEY')] $response = Http::withToken(config('services.temp_number.key')) ->acceptJson() ->get('https://api.temp-number.com/v1/account'); $result = $response->json(); -
Bir ülke seçin ve stoku kontrol edin
GET /pricing her ülkeyi süre başına kesin fiyatla listeler. Ardından istediğiniz ülke için stoku doğrulayın.
curl --request GET "https://api.temp-number.com/v1/inventory?country_code=US&duration=oneMonth" \ --header "Authorization: Bearer $TEMP_NUMBER_API_KEY" \ --header "Accept: application/json"const response = await fetch("https://api.temp-number.com/v1/inventory?country_code=US&duration=oneMonth", { headers: { Authorization: `Bearer ${process.env.TEMP_NUMBER_API_KEY}`, Accept: "application/json", }, }); const result = await response.json(); console.log(response.status, result);import os import requests response = requests.get( "https://api.temp-number.com/v1/inventory", headers={ "Authorization": f"Bearer {os.environ['TEMP_NUMBER_API_KEY']}", "Accept": "application/json", }, params={"country_code": "US", "duration": "oneMonth"}, timeout=30, ) print(response.status_code, response.json())use Illuminate\Support\Facades\Http; // config/services.php: 'temp_number' => ['key' => env('TEMP_NUMBER_API_KEY')] $response = Http::withToken(config('services.temp_number.key')) ->acceptJson() ->get('https://api.temp-number.com/v1/inventory', [ 'country_code' => 'US', 'duration' => 'oneMonth', ]); $result = $response->json(); -
Numara satın al
Her satın almada yeni bir Idempotency-Key gönderin. Ağ bağlantısı koparsa aynı anahtarla tekrar deneyin: asla iki kez ücretlendirilmezsiniz. Yanıttaki data.id değerini saklayın.
curl --request POST "https://api.temp-number.com/v1/numbers/buy" \ --header "Authorization: Bearer $TEMP_NUMBER_API_KEY" \ --header "Accept: application/json" \ --header "Content-Type: application/json" \ --header "Idempotency-Key: $(uuidgen)" \ --data '{"country_code":"US","duration":"oneMonth"}'import { randomUUID } from "node:crypto"; const response = await fetch("https://api.temp-number.com/v1/numbers/buy", { method: "POST", headers: { Authorization: `Bearer ${process.env.TEMP_NUMBER_API_KEY}`, Accept: "application/json", "Content-Type": "application/json", "Idempotency-Key": randomUUID(), }, body: JSON.stringify({ country_code: "US", duration: "oneMonth" }), }); const result = await response.json(); console.log(response.status, result);import os import uuid import requests response = requests.post( "https://api.temp-number.com/v1/numbers/buy", headers={ "Authorization": f"Bearer {os.environ['TEMP_NUMBER_API_KEY']}", "Accept": "application/json", "Idempotency-Key": str(uuid.uuid4()), }, json={"country_code": "US", "duration": "oneMonth"}, timeout=60, ) print(response.status_code, response.json())use Illuminate\Support\Facades\Http; use Illuminate\Support\Str; // config/services.php: 'temp_number' => ['key' => env('TEMP_NUMBER_API_KEY')] $response = Http::withToken(config('services.temp_number.key')) ->acceptJson() ->withHeaders(['Idempotency-Key' => (string) Str::uuid()]) ->timeout(60) ->post('https://api.temp-number.com/v1/numbers/buy', [ 'country_code' => 'US', 'duration' => 'oneMonth', ]); $result = $response->json(); -
SMS'i okuyun
Mesaj gelene kadar numarayı birkaç saniyede bir yoklayın. Ham metni alırsınız; kodu kendi tarafınızda ayıklayın.
curl --request GET "https://api.temp-number.com/v1/numbers/1482/sms" \ --header "Authorization: Bearer $TEMP_NUMBER_API_KEY" \ --header "Accept: application/json"const response = await fetch("https://api.temp-number.com/v1/numbers/1482/sms", { headers: { Authorization: `Bearer ${process.env.TEMP_NUMBER_API_KEY}`, Accept: "application/json", }, }); const result = await response.json(); console.log(response.status, result);import os import requests response = requests.get( "https://api.temp-number.com/v1/numbers/1482/sms", headers={ "Authorization": f"Bearer {os.environ['TEMP_NUMBER_API_KEY']}", "Accept": "application/json", }, timeout=30, ) print(response.status_code, response.json())use Illuminate\Support\Facades\Http; // config/services.php: 'temp_number' => ['key' => env('TEMP_NUMBER_API_KEY')] $response = Http::withToken(config('services.temp_number.key')) ->acceptJson() ->get('https://api.temp-number.com/v1/numbers/1482/sms'); $result = $response->json(); -
SMS gelmedi mi? İade için iptal edin
Satın almadan 15 ila 120 dakika sonra, SMS almamış bir numara iptal edilerek tutarın tamamı cüzdanınıza iade edilebilir.
curl --request POST "https://api.temp-number.com/v1/numbers/1482/cancel" \ --header "Authorization: Bearer $TEMP_NUMBER_API_KEY" \ --header "Accept: application/json" \ --header "Idempotency-Key: $(uuidgen)"import { randomUUID } from "node:crypto"; const response = await fetch("https://api.temp-number.com/v1/numbers/1482/cancel", { method: "POST", headers: { Authorization: `Bearer ${process.env.TEMP_NUMBER_API_KEY}`, Accept: "application/json", "Idempotency-Key": randomUUID(), }, }); const result = await response.json(); console.log(response.status, result);import os import uuid import requests response = requests.post( "https://api.temp-number.com/v1/numbers/1482/cancel", headers={ "Authorization": f"Bearer {os.environ['TEMP_NUMBER_API_KEY']}", "Accept": "application/json", "Idempotency-Key": str(uuid.uuid4()), }, timeout=60, ) print(response.status_code, response.json())use Illuminate\Support\Facades\Http; use Illuminate\Support\Str; // config/services.php: 'temp_number' => ['key' => env('TEMP_NUMBER_API_KEY')] $response = Http::withToken(config('services.temp_number.key')) ->acceptJson() ->withHeaders(['Idempotency-Key' => (string) Str::uuid()]) ->timeout(60) ->post('https://api.temp-number.com/v1/numbers/1482/cancel'); $result = $response->json();
Kimlik doğrulama
API anahtarınızı her istekte standart Authorization başlığında gönderin:
Authorization: Bearer YOUR_API_KEY
- Anahtarları API Erişimi bölümünde oluşturun. Anahtar, oluşturulduğu anda yalnızca bir kez tam olarak gösterilir.
- Her entegrasyon için ayrı bir anahtar kullanın; böylece diğerlerini bozmadan birini iptal edebilirsiniz. Şifrenizi değiştirmek tüm anahtarları iptal eder.
- Eksik, hatalı biçimlendirilmiş veya iptal edilmiş bir anahtar
401döndürür. E-postasını doğrulamamış veya askıya alınmış bir hesap,codedeğeriemail_unverifiedya daaccount_suspendedolan403döndürür. - REST anahtarları yalnızca
/v1üzerinde çalışır. MCP sunucusu kendi oturum açma yöntemini veya MCP anahtarlarını kullanır - bkz. MCP sunucusu.
Temel URL ve sürümleme
Tüm uç noktalar kalıcı /v1 öneki altındadır:
https://api.temp-number.com/v1
Ekleme niteliğindeki değişiklikler - yeni alanlar, uç noktalar veya isteğe bağlı parametreler - sürüm artırılmadan yayınlanır; bu yüzden tanımadığınız alanları yok sayın. Geriye dönük uyumsuz bir değişiklik /v2 altında yayınlanır; entegrasyonunuz asla sessizce taşınmaz. Makine tarafından okunabilir sözleşme OpenAPI spesifikasyonudur.
İstekler ve yanıtlar
- JSON gövdelerini
Content-Type: application/jsonile gönderin ve her istekteAccept: application/jsonkullanın. - Başarılı:
{ "success": true, "data": …, "meta": {…} }.metasayıları, sayfalama ve tutar özetlerini içerir. - Hatalar:
{ "success": false, "message": "…", "code": "…" }. Mantığınızıcodedeğerine göre kurun; mesaj insanlar içindir. Bkz. Hatalar. - Zamanlar ISO 8601 biçimindedir. Tutarlar iki ondalık basamaklı USD cinsindendir ve her zaman ödediğiniz fiyattır.
- Bazı nesneler, mevcut entegrasyonlar için hâlâ eski alan adlarını taşır (referansta kullanımdan kaldırıldı olarak işaretlidir). Yeni kod bunları yok saymalıdır.
Hatalar
Hatalar standart HTTP durum kodlarını kullanır. İş kuralı hataları sabit, makine tarafından okunabilir bir code içerir; bazıları ek bağlam sunan details alanı da taşır.
{
"success": false,
"message": "Insufficient wallet balance.",
"code": "insufficient_funds"
}
{
"message": "The country code field is required.",
"errors": {
"country_code": ["The country code field is required."]
}
}
| Durum | code | Anlamı | Ne yapmalı |
|---|---|---|---|
| 400 | - | Satın alma, yenileme veya iptalde Idempotency-Key başlığı eksik ya da hatalı biçimlendirilmiş. Gövde: {"error": "Missing Idempotency-Key header."} | Idempotency-Key içinde bir UUID gönderin. |
| 401 | - | Bearer token yok, hatalı biçimlendirilmiş veya iptal edilmiş bir anahtar. | Authorization başlığını kontrol edin; anahtar iptal edildiyse yeni bir anahtar oluşturun. |
| 403 | email_unverified |
Hesap henüz e-posta adresini doğrulamadı. | E-postayı web sitesinde doğrulayın, ardından tekrar deneyin. |
| 403 | account_suspended |
Hesap askıya alındı. | Destek ekibiyle iletişime geçin. |
| 403 | kyc_required |
Hesabın yeni numara satın almadan önce kimliğini doğrulaması gerekiyor. Ücret alınmadı; yenilemeler çalışmaya devam ediyor. | Hesap ayarlarında kimlik doğrulamasını tamamlayın, ardından tekrar deneyin. |
| 403 | - | Anahtarın API erişimi yok (örneğin bir MCP anahtarı) veya GET /receive-sms başka bir hesaptaki numara için çağrıldı. | Bir REST API anahtarı kullanın; yalnızca kendi numaralarınızı sorgulayın. |
| 404 | - | Numara, mesaj veya ülke hesabınızda değil ya da şu anda satışta değil. Diğer hesaplara ait kimlikler de 404 yanıtı verir. | GET /numbers veya GET /pricing ile yeniden listeleyin. |
| 404 | private_email_closed |
Numarası iptal edildiği veya iade edildiği için özel gelen kutusu kapatıldı. | Yeniden denenecek bir şey yok. |
| 409 | - | Idempotency-Key farklı bir gövdeyle zaten kullanıldı veya bu anahtarla yapılan ilk istek hâlâ çalışıyor. | Yeni bir istek için yeni bir anahtar kullanın; devam eden istek için bekleyip tekrar deneyin. |
| 422 | insufficient_funds |
Cüzdan bakiyesi fiyatı karşılamıyor. | Cüzdanınıza bakiye yükleyin ve tekrar deneyin. |
| 422 | out_of_stock |
Pazar, fiyat kontrolünüz ile satın alma arasında tükendi. | GET /inventory'yi yeniden kontrol edin ve başka bir süre veya tür seçin. |
| 422 | invalid_duration |
Bu süre, o ülke ve numara türü için satılmıyor. | GET /pricing/{countryCode}'u yeniden çağırın. |
| 422 | - | Doğrulama başarısız oldu (bir `errors` nesnesi her alanı belirtir) veya bir kural işlemi reddetti; örneğin iade süresi dışında iptal. | `message` alanını okuyun; isteği yeniden denemek yerine düzeltin. |
| 429 | - | Hız sınırına ulaşıldı. | Retry-After başlığını bekleyin, ardından artan bekleme süreleriyle tekrar deneyin. |
| 503 | purchases_paused |
Yeni satın alımlar tüm platformda duraklatıldı. Ücret alınmadı; yenilemeler ve iptaller çalışmaya devam ediyor. | Retry-After süresinden (60 sn) sonra tekrar deneyin. |
| 5xx | - | Bizim tarafımızda bir hata oluştu. | AYNI Idempotency-Key ile tekrar deneyin - asla iki kez ücretlendirilmezsiniz. |
İstek limitleri
Limitler anahtar başına uygulanır; para hareketi içeren çağrılara ayrıca hesap başına daha sıkı bir limit uygulanır:
| Geçerli olduğu yer | Limit | Sayılan |
|---|---|---|
| Tüm uç noktalar | 60 / dakika | API anahtarı başına |
| Satın al, yenile, iptal et | 10 / dakika | hesap başına, yukarıdakilere ek olarak |
| GET /receive-sms | 60 / dakika | API anahtarı başına |
| GET /receive-sms | 30 / dakika | API anahtarı ve telefon numarası başına |
| GET /receive-sms | 30 / dakika | IP adresi başına |
Limiti aşarsanız Retry-After başlığıyla (saniye) birlikte 429 alırsınız. En az bu süre kadar bekleyin, ardından jitter ile geri çekilin. Yanıtlar ayrıca X-RateLimit-Limit ve X-RateLimit-Remaining başlıklarını taşır.
Idempotency
POST /numbers/buy, /renew ve /cancel bir Idempotency-Key başlığı gerektirir: her yeni işlem için oluşturduğunuz bir UUID. Ağ bağlantısı koparsa aynı isteği aynı anahtarla gönderin - orijinal yanıtı geri alırsınız (X-Idempotency-Replayed: true olarak işaretli) ve asla iki kez ücretlendirilmezsiniz.
- Eksik anahtar:
400. Anahtarlar harf, rakam ve- _ . :karakterlerinden oluşan en fazla 128 karakterdir - Aynı anahtar, farklı gövde:
409. İlk istek hâlâ çalışırken aynı anahtar:409- biraz bekleyip tekrar deneyin. - Anahtarlar hesap ve uç nokta başına hatırlanır. Bir anahtarı asla farklı bir satın alma için tekrar kullanmayın.
Sayfalama
GET /receive-sms, en yeniden eskiye doğru cursor sayfalaması kullanır. meta.hasMore değerini okuyun; true olduğu sürece meta.nextCursor değerini aynı phoneNumber ile cursor olarak geri gönderin. Cursor'lar opaktır - bunları kendiniz oluşturmayın veya düzenlemeyin.
GET https://api.temp-number.com/v1/receive-sms?phoneNumber=%2B14035551234&limit=50&cursor=eyJkYXRlIjoiMjAyNi0wNS0xMyJ9
Doğası gereği küçük olan listeler (/numbers, /pricing) her şeyi tek bir yanıtta döndürür; özel gelen kutusu page ve per_page kullanır.
Kabul edilebilir kullanım
API geliştiriciler için tasarlandı: doğrulama ve OTP akışları, otomatik kayıt süreçleri, QA ve sistem testleri ile gelen SMS veya geniş ölçekte telefon numarası gerektiren her ürün.
- Yalnızca meşru doğrulama, geliştirme ve test amaçlı kullanın.
- Dolandırıcılık, spam veya aldatma yasaktır. Dolandırıcılık veya diğer kötüye kullanım amaçlı kullanılan numaralar, hesabın derhal ve bildirimsiz olarak yasaklanmasına, ilgili numaraların iptal edilmesine yol açar ve herhangi bir iade yapılmaz.
- Düzenlemeye tabi veya kimliğe bağlı hesaplar için uygun değildir. Paylaşımlı, geçici numaralarımız; bankacılık, ödeme, kripto para, kamu hizmetleri veya yasal kimliğinizi doğrulayan diğer hizmetler (KYC/AML) için SMS doğrulamasını desteklemez - bunlar için kendi kişisel cep telefonu numaranızı kullanın.
API referansı
Tüm aktif /v1 uç noktaları. İstekler sağda sizin dilinizde yer alır; yanıtlar gerçek yapılardır.
Hesap
Cüzdan bakiyenizi ve hesap para birimini okuyun.
/v1/account
Hesap bakiyesini alın
Kullanılabilir cüzdan bakiyesini ve para birimini döndürür. Açık bir "bakiye yükleyin" mesajıyla erkenden durabilmek için satın almadan önce kontrol edin.
Yanıt alanları-
balancenumberKullanılabilir cüzdan bakiyesi.
-
currencystringHesap para birimi, USD.
- 401Eksik veya geçersiz anahtar.
curl --request GET "https://api.temp-number.com/v1/account" \
--header "Authorization: Bearer $TEMP_NUMBER_API_KEY" \
--header "Accept: application/json"
const response = await fetch("https://api.temp-number.com/v1/account", {
headers: {
Authorization: `Bearer ${process.env.TEMP_NUMBER_API_KEY}`,
Accept: "application/json",
},
});
const result = await response.json();
console.log(response.status, result);
import os
import requests
response = requests.get(
"https://api.temp-number.com/v1/account",
headers={
"Authorization": f"Bearer {os.environ['TEMP_NUMBER_API_KEY']}",
"Accept": "application/json",
},
timeout=30,
)
print(response.status_code, response.json())
use Illuminate\Support\Facades\Http;
// config/services.php: 'temp_number' => ['key' => env('TEMP_NUMBER_API_KEY')]
$response = Http::withToken(config('services.temp_number.key'))
->acceptJson()
->get('https://api.temp-number.com/v1/account');
$result = $response->json();
{
"success": true,
"balance": 124.50,
"currency": "USD"
}
Fiyatlandırma ve stok
Canlı pazarlara, her süre için ödeyeceğiniz kesin fiyata ve anlık stoka göz atın.
Ülke fiyatlandırma nesnesi
Bir ülke ve orada satın alabileceğiniz tüm paketler. price, cüzdanınızdan alınan nihai tutardır; tedarik maliyeti asla gösterilmez.
Alanlar-
country_codestringISO 3166-1 alpha-2 kodu, ör. US.
-
country_namestringGörünen ad.
-
packages[].number_typeenumvoip veya non_voip.
-
packages[].durationenumSatın almak için gönderdiğiniz anahtar: halfDay, oneDay, oneWeek, oneMonth, threeMonths, sixMonths veya oneYear. Her ülkenin kendi seçenekleri vardır.
-
packages[].duration_labelstringOkunabilir etiket, ör. "1 Ay".
-
packages[].pricenumberUSD cinsinden nihai fiyat.
-
packages[].original_pricenumber | nullBir indirim uygulandığında indirimden önceki fiyat.
-
packages[].updated_atnullAyrılmış.
{
"country_code": "US",
"country_name": "United States",
"packages": [
{
"number_type": "voip",
"duration": "oneMonth",
"duration_label": "1 Month",
"price": 4.99,
"original_price": 5.99,
"updated_at": null
}
]
}
/v1/pricing
Tüm ülkelerin fiyatlarını listeleyin
Tam canlı katalog: ülke fiyatlandırma nesnelerinin listesi. price alanı, USD cinsinden kullanıcıya gösterilen nihai fiyattır; cüzdanınızdan tam olarak bu tutar alınır.
Döndürürdata içinde ülke fiyatlandırma nesnelerinin listesi, meta.count ile birlikte.
Hatalar- 401Eksik veya geçersiz anahtar.
curl --request GET "https://api.temp-number.com/v1/pricing" \
--header "Authorization: Bearer $TEMP_NUMBER_API_KEY" \
--header "Accept: application/json"
const response = await fetch("https://api.temp-number.com/v1/pricing", {
headers: {
Authorization: `Bearer ${process.env.TEMP_NUMBER_API_KEY}`,
Accept: "application/json",
},
});
const result = await response.json();
console.log(response.status, result);
import os
import requests
response = requests.get(
"https://api.temp-number.com/v1/pricing",
headers={
"Authorization": f"Bearer {os.environ['TEMP_NUMBER_API_KEY']}",
"Accept": "application/json",
},
timeout=30,
)
print(response.status_code, response.json())
use Illuminate\Support\Facades\Http;
// config/services.php: 'temp_number' => ['key' => env('TEMP_NUMBER_API_KEY')]
$response = Http::withToken(config('services.temp_number.key'))
->acceptJson()
->get('https://api.temp-number.com/v1/pricing');
$result = $response->json();
{
"success": true,
"data": [
{
"country_code": "US",
"country_name": "United States",
"packages": [
{
"number_type": "voip",
"duration": "oneMonth",
"duration_label": "1 Month",
"price": 4.99,
"original_price": 5.99,
"updated_at": null
},
{
"number_type": "voip",
"duration": "threeMonths",
"duration_label": "3 Months",
"price": 12.99,
"original_price": null,
"updated_at": null
}
]
}
],
"meta": { "count": 1 }
}
/v1/pricing/{countryCode}
Tek bir ülkenin fiyatlarını alın
Tek bir ülke için canlı fiyatlandırma. 404, ülkenin şu anda aktif bir rotası olmadığı anlamına gelir: bunu "hiç satılmıyor" olarak değil, geçici bir "stokta yok" olarak değerlendirin.
Parametreler-
countryCodestring path ZorunluISO 3166-1 alpha-2 ülke kodu, ör. US, GB, CA.
data içinde bir ülke fiyatlandırma nesnesi.
Hatalar- 404Bu ülke için şu anda aktif bir rota yok.
curl --request GET "https://api.temp-number.com/v1/pricing/GB" \
--header "Authorization: Bearer $TEMP_NUMBER_API_KEY" \
--header "Accept: application/json"
const response = await fetch("https://api.temp-number.com/v1/pricing/GB", {
headers: {
Authorization: `Bearer ${process.env.TEMP_NUMBER_API_KEY}`,
Accept: "application/json",
},
});
const result = await response.json();
console.log(response.status, result);
import os
import requests
response = requests.get(
"https://api.temp-number.com/v1/pricing/GB",
headers={
"Authorization": f"Bearer {os.environ['TEMP_NUMBER_API_KEY']}",
"Accept": "application/json",
},
timeout=30,
)
print(response.status_code, response.json())
use Illuminate\Support\Facades\Http;
// config/services.php: 'temp_number' => ['key' => env('TEMP_NUMBER_API_KEY')]
$response = Http::withToken(config('services.temp_number.key'))
->acceptJson()
->get('https://api.temp-number.com/v1/pricing/GB');
$result = $response->json();
{
"success": true,
"data": {
"country_code": "GB",
"country_name": "United Kingdom",
"packages": [
{
"number_type": "voip",
"duration": "oneMonth",
"duration_label": "1 Month",
"price": 5.49,
"original_price": null,
"updated_at": null
}
]
}
}
/v1/inventory
Stoku kontrol edin
Bir ülke ve süre için anlık stok; böylece kimse tıklamadan önce Satın Al düğmesini devre dışı bırakabilirsiniz. Tüm türleri types[] içinde yan yana görmek için number_type'ı boş bırakın. Yeşil sonuç güçlü bir işarettir, ancak son kontrol satın almanın kendisidir.
Parametreler-
country_codestring query ZorunluISO 3166-1 alpha-2 ülke kodu.
-
durationenum query İsteğe bağlıGET /pricing/{countryCode}'dan bir süre anahtarı. Rotanın varsayılanı için boş bırakın.
Şunlardan birihalfDayoneDayoneWeekoneMonththreeMonthssixMonthsoneYear -
number_typeenum query İsteğe bağlıKontrolü tek bir türle sınırlayın. Tüm türleri görmek için boş bırakın.
Şunlardan birivoipnon_voip
-
stockinteger | nullKullanılabilir numaralar (number_type boş bırakıldığında types[] üzerinden toplanır).
-
availablebooleanEn az bir numara satın alınabiliyorsa true.
-
statusstringOkunabilir etiket: Stokta, Stokta Yok, Yakında…
-
types[]arrayYalnızca number_type boş bırakıldığında: pazarın sattığı her tür için number_type, stock, available, status.
- 422Bu seçim için satışta bir şey yok; details stok alanlarını içerir.
curl --request GET "https://api.temp-number.com/v1/inventory?country_code=US&duration=oneMonth" \
--header "Authorization: Bearer $TEMP_NUMBER_API_KEY" \
--header "Accept: application/json"
const response = await fetch("https://api.temp-number.com/v1/inventory?country_code=US&duration=oneMonth", {
headers: {
Authorization: `Bearer ${process.env.TEMP_NUMBER_API_KEY}`,
Accept: "application/json",
},
});
const result = await response.json();
console.log(response.status, result);
import os
import requests
response = requests.get(
"https://api.temp-number.com/v1/inventory",
headers={
"Authorization": f"Bearer {os.environ['TEMP_NUMBER_API_KEY']}",
"Accept": "application/json",
},
params={"country_code": "US", "duration": "oneMonth"},
timeout=30,
)
print(response.status_code, response.json())
use Illuminate\Support\Facades\Http;
// config/services.php: 'temp_number' => ['key' => env('TEMP_NUMBER_API_KEY')]
$response = Http::withToken(config('services.temp_number.key'))
->acceptJson()
->get('https://api.temp-number.com/v1/inventory', [
'country_code' => 'US',
'duration' => 'oneMonth',
]);
$result = $response->json();
{
"success": true,
"data": {
"country_code": "US",
"duration": "oneMonth",
"number_type": null,
"stock": 47,
"available": true,
"status": "In Stock",
"types": [
{ "number_type": "voip", "stock": 0, "available": false, "status": "Out of Stock" },
{ "number_type": "non_voip", "stock": 47, "available": true, "status": "In Stock" }
]
}
}
Numaralar
Özel numaralarınızı listeleyin, satın alın, yenileyin ve iptal edin. Para hareketi içeren çağrılar idempotent'tir ve tekrar oynatmaya karşı güvenlidir.
Numara nesnesi
Hesabınızdaki bir numara. Satın alma, yenileme ve iptal ayrıca meta içinde bir para özeti döndürür: charged (veya refunded), currency ve wallet_balance_after.
Alanlar-
idinteger/numbers/{id}/… çağrılarında kullanın. Webhook'lar bunu number.rentalId olarak gönderir.
-
phone_numberstringE.164, ör. +14035551234.
-
country_codestring | nullISO 3166-1 alpha-2.
-
country_namestringGörünen ad.
-
number_typeenumvoip veya non_voip.
-
statusenumactive, expired, cancelled veya refunded.
-
purchase_datestringISO 8601, UTC.
-
expire_datestringISO 8601, UTC. Bu tarihten sonra numara SMS almayı bırakır ve yenilenemez.
Eski entegrasyonlar için hâlâ gönderilen kullanımdan kaldırılmış takma adlar: country, provider, purchased_at ve expires_at (epoch milisaniye). Bunlara dayanarak geliştirme yapmayın.
{
"id": 1482,
"phone_number": "+14035551234",
"country_code": "US",
"country_name": "United States",
"number_type": "voip",
"status": "active",
"purchase_date": "2026-05-13T17:42:09Z",
"expire_date": "2026-06-13T17:42:09Z"
}
/v1/numbers
Numaralarınızı listeleyin
Hesabınızdaki tüm numaralar, en yeniden eskiye. Yenileme hatırlatmaları için status=expiring_soon (süresinin dolmasına 10 gün kalan aktif numaralar) kullanın.
Parametreler-
statusenum query İsteğe bağlıYaşam döngüsü filtresi. Varsayılan all.
Şunlardan biriallactiveexpiring_soonexpiredcancelled
data içinde numara nesnelerinin listesi; meta.count ve meta.status.
Hatalar- 401Eksik veya geçersiz anahtar.
curl --request GET "https://api.temp-number.com/v1/numbers?status=expiring_soon" \
--header "Authorization: Bearer $TEMP_NUMBER_API_KEY" \
--header "Accept: application/json"
const response = await fetch("https://api.temp-number.com/v1/numbers?status=expiring_soon", {
headers: {
Authorization: `Bearer ${process.env.TEMP_NUMBER_API_KEY}`,
Accept: "application/json",
},
});
const result = await response.json();
console.log(response.status, result);
import os
import requests
response = requests.get(
"https://api.temp-number.com/v1/numbers",
headers={
"Authorization": f"Bearer {os.environ['TEMP_NUMBER_API_KEY']}",
"Accept": "application/json",
},
params={"status": "expiring_soon"},
timeout=30,
)
print(response.status_code, response.json())
use Illuminate\Support\Facades\Http;
// config/services.php: 'temp_number' => ['key' => env('TEMP_NUMBER_API_KEY')]
$response = Http::withToken(config('services.temp_number.key'))
->acceptJson()
->get('https://api.temp-number.com/v1/numbers', [
'status' => 'expiring_soon',
]);
$result = $response->json();
{
"success": true,
"data": [
{
"id": 1482,
"phone_number": "+14035551234",
"country_code": "US",
"country_name": "United States",
"number_type": "voip",
"status": "active",
"purchase_date": "2026-05-13T17:42:09Z",
"expire_date": "2026-06-13T17:42:09Z"
}
],
"meta": { "count": 1, "status": "expiring_soon" }
}
/v1/numbers/buy
Idempotency-Key gerekli Numara satın al
Yeni bir özel numara tahsis eder ve cüzdanınızdan tek bir atomik adımda ücret alır. Ücret alındıktan sonra teslimat başarısız olursa ücret geri alınır: asla ödeme yapıp eli boş kalmazsınız. Yanıt, alınan tutarı ve sonraki bakiyenizi gösterir.
Parametreler-
country_codestring body ZorunluGET /pricing'den bir ülke.
-
durationenum body ZorunluO ülkenin packages[] listesinden bir süre anahtarı - her ülkenin kendi seçenekleri vardır.
Şunlardan birihalfDayoneDayoneWeekoneMonththreeMonthssixMonthsoneYear -
number_typeenum body İsteğe bağlıRotanın varsayılanını kullanmak için boş bırakın.
Şunlardan birivoipnon_voip -
Idempotency-Keystring header ZorunluHer satın alma için yeni, yeniden denemelerde tekrar kullanılan bir UUID.
data içinde yeni numara nesnesi; meta.charged, meta.currency, meta.wallet_balance_after.
Hatalar- 422
insufficient_fundsCüzdan bakiyesi fiyatı karşılamıyor. - 422
out_of_stockStok kontrolünüzden bu yana tükendi. - 422
invalid_durationBu ülke/tür için bu süre satılmıyor. - 403
kyc_requiredÖnce kimlik doğrulaması gerekiyor. Ücret alınmadı. - 503
purchases_pausedSatın alımlar tüm platformda duraklatıldı. Retry-After: 60.
curl --request POST "https://api.temp-number.com/v1/numbers/buy" \
--header "Authorization: Bearer $TEMP_NUMBER_API_KEY" \
--header "Accept: application/json" \
--header "Content-Type: application/json" \
--header "Idempotency-Key: $(uuidgen)" \
--data '{"country_code":"US","duration":"oneMonth","number_type":"voip"}'
import { randomUUID } from "node:crypto";
const response = await fetch("https://api.temp-number.com/v1/numbers/buy", {
method: "POST",
headers: {
Authorization: `Bearer ${process.env.TEMP_NUMBER_API_KEY}`,
Accept: "application/json",
"Content-Type": "application/json",
"Idempotency-Key": randomUUID(),
},
body: JSON.stringify({ country_code: "US", duration: "oneMonth", number_type: "voip" }),
});
const result = await response.json();
console.log(response.status, result);
import os
import uuid
import requests
response = requests.post(
"https://api.temp-number.com/v1/numbers/buy",
headers={
"Authorization": f"Bearer {os.environ['TEMP_NUMBER_API_KEY']}",
"Accept": "application/json",
"Idempotency-Key": str(uuid.uuid4()),
},
json={"country_code": "US", "duration": "oneMonth", "number_type": "voip"},
timeout=60,
)
print(response.status_code, response.json())
use Illuminate\Support\Facades\Http;
use Illuminate\Support\Str;
// config/services.php: 'temp_number' => ['key' => env('TEMP_NUMBER_API_KEY')]
$response = Http::withToken(config('services.temp_number.key'))
->acceptJson()
->withHeaders(['Idempotency-Key' => (string) Str::uuid()])
->timeout(60)
->post('https://api.temp-number.com/v1/numbers/buy', [
'country_code' => 'US',
'duration' => 'oneMonth',
'number_type' => 'voip',
]);
$result = $response->json();
{
"success": true,
"data": {
"id": 1482,
"phone_number": "+14035551234",
"country_code": "US",
"country_name": "United States",
"number_type": "voip",
"status": "active",
"purchase_date": "2026-05-13T17:42:09Z",
"expire_date": "2026-06-13T17:42:09Z"
},
"meta": {
"charged": 4.99,
"currency": "USD",
"wallet_balance_after": 119.51
}
}
/v1/numbers/{id}/renew
Idempotency-Key gerekli Numarayı yenile
Bir numarayı seçilen paket kadar uzatır. Yeni süre mevcut bitiş tarihine eklenir, bu yüzden erken yenilemek hiçbir şey kaybettirmez. Fiyat, bizim tarafımızda hesaplanan güncel site fiyatıdır. Süresi dolmuş numaralar yenilenemez: yeni bir numara satın alın.
Parametreler-
idinteger path ZorunluGET /numbers'tan numara kimliği.
-
packageenum body İsteğe bağlıYenileme süresi. Varsayılan oneMonth. (duration eski takma ad olarak kabul edilir.)
Şunlardan birioneMonththreeMonthssixMonthsoneYear -
Idempotency-Keystring header ZorunluHer yenileme için yeni, yeniden denemelerde tekrar kullanılan bir UUID.
data içinde güncellenmiş numara nesnesi; meta.charged, meta.currency, meta.wallet_balance_after.
Hatalar- 404Hesabınızdaki bir numara değil.
- 422
insufficient_fundsCüzdan bakiyesi yenilemeyi karşılamıyor. - 422Süresi dolmuş, iptal edilmiş veya yenilenemez.
curl --request POST "https://api.temp-number.com/v1/numbers/1482/renew" \
--header "Authorization: Bearer $TEMP_NUMBER_API_KEY" \
--header "Accept: application/json" \
--header "Content-Type: application/json" \
--header "Idempotency-Key: $(uuidgen)" \
--data '{"package":"threeMonths"}'
import { randomUUID } from "node:crypto";
const response = await fetch("https://api.temp-number.com/v1/numbers/1482/renew", {
method: "POST",
headers: {
Authorization: `Bearer ${process.env.TEMP_NUMBER_API_KEY}`,
Accept: "application/json",
"Content-Type": "application/json",
"Idempotency-Key": randomUUID(),
},
body: JSON.stringify({ package: "threeMonths" }),
});
const result = await response.json();
console.log(response.status, result);
import os
import uuid
import requests
response = requests.post(
"https://api.temp-number.com/v1/numbers/1482/renew",
headers={
"Authorization": f"Bearer {os.environ['TEMP_NUMBER_API_KEY']}",
"Accept": "application/json",
"Idempotency-Key": str(uuid.uuid4()),
},
json={"package": "threeMonths"},
timeout=60,
)
print(response.status_code, response.json())
use Illuminate\Support\Facades\Http;
use Illuminate\Support\Str;
// config/services.php: 'temp_number' => ['key' => env('TEMP_NUMBER_API_KEY')]
$response = Http::withToken(config('services.temp_number.key'))
->acceptJson()
->withHeaders(['Idempotency-Key' => (string) Str::uuid()])
->timeout(60)
->post('https://api.temp-number.com/v1/numbers/1482/renew', [
'package' => 'threeMonths',
]);
$result = $response->json();
{
"success": true,
"data": {
"id": 1482,
"phone_number": "+14035551234",
"country_code": "US",
"country_name": "United States",
"number_type": "voip",
"status": "active",
"purchase_date": "2026-05-13T17:42:09Z",
"expire_date": "2026-09-13T17:42:09Z"
},
"meta": {
"charged": 12.99,
"currency": "USD",
"wallet_balance_after": 106.52
}
}
/v1/numbers/{id}/cancel
Idempotency-Key gerekli İade için numarayı iptal edin
Bir numarayı serbest bırakır ve tam fiyatını cüzdanınıza iade eder. Yalnızca satın almadan 15 ila 120 dakika sonra, numara aktifken ve henüz hiç SMS almamışken izin verilir. Bu kuralların dışında çağrı 422 ile reddedilir ve hiçbir şey değişmez; çok erkense details.seconds_until_open ne kadar beklemeniz gerektiğini söyler.
Parametreler-
idinteger path ZorunluGET /numbers'tan numara kimliği.
-
Idempotency-Keystring header ZorunluYeniden denemelerde tekrar kullanılan bir UUID.
data içinde numara nesnesi (status cancelled); meta.refunded, meta.currency, meta.wallet_balance_after.
Hatalar- 404Hesabınızdaki bir numara değil.
- 422Çok erken (15 dk'dan az), çok geç (120 dk'dan fazla), zaten SMS almış veya aktif değil.
curl --request POST "https://api.temp-number.com/v1/numbers/1482/cancel" \
--header "Authorization: Bearer $TEMP_NUMBER_API_KEY" \
--header "Accept: application/json" \
--header "Idempotency-Key: $(uuidgen)"
import { randomUUID } from "node:crypto";
const response = await fetch("https://api.temp-number.com/v1/numbers/1482/cancel", {
method: "POST",
headers: {
Authorization: `Bearer ${process.env.TEMP_NUMBER_API_KEY}`,
Accept: "application/json",
"Idempotency-Key": randomUUID(),
},
});
const result = await response.json();
console.log(response.status, result);
import os
import uuid
import requests
response = requests.post(
"https://api.temp-number.com/v1/numbers/1482/cancel",
headers={
"Authorization": f"Bearer {os.environ['TEMP_NUMBER_API_KEY']}",
"Accept": "application/json",
"Idempotency-Key": str(uuid.uuid4()),
},
timeout=60,
)
print(response.status_code, response.json())
use Illuminate\Support\Facades\Http;
use Illuminate\Support\Str;
// config/services.php: 'temp_number' => ['key' => env('TEMP_NUMBER_API_KEY')]
$response = Http::withToken(config('services.temp_number.key'))
->acceptJson()
->withHeaders(['Idempotency-Key' => (string) Str::uuid()])
->timeout(60)
->post('https://api.temp-number.com/v1/numbers/1482/cancel');
$result = $response->json();
{
"success": true,
"data": {
"id": 1482,
"phone_number": "+14035551234",
"country_code": "US",
"country_name": "United States",
"number_type": "voip",
"status": "cancelled",
"purchase_date": "2026-05-13T17:42:09Z",
"expire_date": "2026-06-13T17:42:09Z"
},
"meta": {
"refunded": 4.99,
"currency": "USD",
"wallet_balance_after": 124.50
}
}
SMS
Numaralarınıza gelen SMS'leri okuyun. Ham metni alırsınız; kodu ayıklamak size kalmıştır.
SMS mesaj nesnesi
GET /numbers/{id}/sms tarafından döndürülen şekliyle alınan bir SMS. (GET /receive-sms, o uç noktada gösterilen camelCase bir varyant kullanır.)
Alanlar-
idintegerMesaj kimliği.
-
fromstringGönderen: bir telefon numarası veya WhatsApp gibi bir ad.
-
bodystringMesajın tam metni.
-
received_atstringISO 8601, UTC.
Hâlâ gönderilen kullanımdan kaldırılmış takma adlar: sender (= from) ve message (= body).
{
"id": 9912,
"from": "+18005550199",
"body": "Your code is 432901",
"received_at": "2026-05-13T17:43:14Z"
}
/v1/numbers/{id}/sms
Bir numarayı ve SMS'lerini alın
Bir numara ve aldığı tüm SMS'ler, en yeniden eskiye. "Bu numaranın ayrıntılarına in" görünümü ve bir kod beklerken tek bir numarayı yoklamak için en iyisidir. Size ait olmayan kimlikler 404 yanıtı verir.
Parametreler-
idinteger path ZorunluGET /numbers'tan numara kimliği.
data.number (bir numara nesnesi) ve data.messages (SMS mesajı nesneleri); meta.count.
Hatalar- 404Hesabınızdaki bir numara değil.
curl --request GET "https://api.temp-number.com/v1/numbers/1482/sms" \
--header "Authorization: Bearer $TEMP_NUMBER_API_KEY" \
--header "Accept: application/json"
const response = await fetch("https://api.temp-number.com/v1/numbers/1482/sms", {
headers: {
Authorization: `Bearer ${process.env.TEMP_NUMBER_API_KEY}`,
Accept: "application/json",
},
});
const result = await response.json();
console.log(response.status, result);
import os
import requests
response = requests.get(
"https://api.temp-number.com/v1/numbers/1482/sms",
headers={
"Authorization": f"Bearer {os.environ['TEMP_NUMBER_API_KEY']}",
"Accept": "application/json",
},
timeout=30,
)
print(response.status_code, response.json())
use Illuminate\Support\Facades\Http;
// config/services.php: 'temp_number' => ['key' => env('TEMP_NUMBER_API_KEY')]
$response = Http::withToken(config('services.temp_number.key'))
->acceptJson()
->get('https://api.temp-number.com/v1/numbers/1482/sms');
$result = $response->json();
{
"success": true,
"data": {
"number": {
"id": 1482,
"phone_number": "+14035551234",
"country_code": "US",
"country_name": "United States",
"number_type": "voip",
"status": "active",
"purchase_date": "2026-05-13T17:42:09Z",
"expire_date": "2026-06-13T17:42:09Z"
},
"messages": [
{
"id": 9912,
"from": "+18005550199",
"body": "Your code is 432901",
"received_at": "2026-05-13T17:43:14Z"
}
]
},
"meta": { "count": 1 }
}
/v1/receive-sms
Telefon numarasıyla SMS alın
Sahibi olduğunuz bir numara için imleç tabanlı sayfalanmış SMS'ler; numara kimliği yerine telefon numarasıyla adreslenir. Yüksek hacimli gelen kutuları için en iyisidir. Size ait olmayan bir numara 403 yanıtı verir.
Parametreler-
phoneNumberstring query ZorunluE.164 veya yalnızca rakam, ör. +14035551234. + işaretini URL kodlamasıyla gönderin.
-
limitinteger query İsteğe bağlıSayfa boyutu 1-100. Varsayılan 50.
-
cursorstring query İsteğe bağlıÖnceki sayfadan gelen meta.nextCursor.
-
data.messages[].idintegerMesaj kimliği.
-
data.messages[].fromstringGönderen.
-
data.messages[].tostringNumaranız.
-
data.messages[].messagestringTam metin.
-
data.messages[].receivedAtstringISO 8601.
-
meta.hasMore / nextCursorboolean / string | nullSonraki sayfa için nextCursor değerini cursor olarak gönderin.
- 403Numara hesabınızda değil.
- 422phoneNumber eksik veya geçersiz.
curl --request GET "https://api.temp-number.com/v1/receive-sms?phoneNumber=%2B14035551234&limit=50" \
--header "Authorization: Bearer $TEMP_NUMBER_API_KEY" \
--header "Accept: application/json"
const response = await fetch("https://api.temp-number.com/v1/receive-sms?phoneNumber=%2B14035551234&limit=50", {
headers: {
Authorization: `Bearer ${process.env.TEMP_NUMBER_API_KEY}`,
Accept: "application/json",
},
});
const result = await response.json();
console.log(response.status, result);
import os
import requests
response = requests.get(
"https://api.temp-number.com/v1/receive-sms",
headers={
"Authorization": f"Bearer {os.environ['TEMP_NUMBER_API_KEY']}",
"Accept": "application/json",
},
params={"phoneNumber": "+14035551234", "limit": 50},
timeout=30,
)
print(response.status_code, response.json())
use Illuminate\Support\Facades\Http;
// config/services.php: 'temp_number' => ['key' => env('TEMP_NUMBER_API_KEY')]
$response = Http::withToken(config('services.temp_number.key'))
->acceptJson()
->get('https://api.temp-number.com/v1/receive-sms', [
'phoneNumber' => '+14035551234',
'limit' => 50,
]);
$result = $response->json();
{
"success": true,
"data": {
"phoneNumber": "+14035551234",
"purchaseStatus": "active",
"messages": [
{
"id": 1842,
"from": "WhatsApp",
"to": "+14035551234",
"message": "Your verification code is 483920.",
"receivedAt": "2026-05-13T17:43:14+00:00"
}
]
},
"meta": {
"count": 1,
"pageSize": 50,
"hasMore": false,
"nextCursor": null,
"prevCursor": null,
"requestedAt": "2026-05-13T17:43:20+00:00"
}
}
Özel e-posta
Her özel numara için ücretsiz, yalnızca alım yapan bir [email protected] gelen kutusu. Numara başına bir adres.
Özel e-posta nesnesi
Bir numaraya bağlı gelen kutusu.
Alanlar-
addressstring | nullAdres; alınmadan önce null.
-
statusenumactive veya none.
-
unread_countintegerOkunmamış e-postalar.
-
created_atstring | nullAdresin alındığı zaman.
-
eligiblebooleanNumara şimdi adres alabiliyorsa true.
-
linked_numberstringAit olduğu telefon numarası.
-
domainstringprivnum.com
-
suggestionsstring[]Uygunken ad önerileri.
{
"address": "[email protected]",
"status": "active",
"unread_count": 2,
"created_at": "2026-07-03T10:15:00+00:00",
"eligible": false,
"linked_number": "+14035551234",
"domain": "privnum.com",
"suggestions": []
}
/v1/numbers/{id}/private-email
Özel e-postayı alın
Bir numaranın adresi ya da adres alınmadan önce, adres alıp alamayacağı ve bazı ad önerileri.
Parametreler-
idinteger path ZorunluGET /numbers'tan numara kimliği.
data içinde bir özel e-posta nesnesi.
Hatalar- 404Hesabınızdaki bir numara değil.
curl --request GET "https://api.temp-number.com/v1/numbers/1482/private-email" \
--header "Authorization: Bearer $TEMP_NUMBER_API_KEY" \
--header "Accept: application/json"
const response = await fetch("https://api.temp-number.com/v1/numbers/1482/private-email", {
headers: {
Authorization: `Bearer ${process.env.TEMP_NUMBER_API_KEY}`,
Accept: "application/json",
},
});
const result = await response.json();
console.log(response.status, result);
import os
import requests
response = requests.get(
"https://api.temp-number.com/v1/numbers/1482/private-email",
headers={
"Authorization": f"Bearer {os.environ['TEMP_NUMBER_API_KEY']}",
"Accept": "application/json",
},
timeout=30,
)
print(response.status_code, response.json())
use Illuminate\Support\Facades\Http;
// config/services.php: 'temp_number' => ['key' => env('TEMP_NUMBER_API_KEY')]
$response = Http::withToken(config('services.temp_number.key'))
->acceptJson()
->get('https://api.temp-number.com/v1/numbers/1482/private-email');
$result = $response->json();
{
"success": true,
"data": {
"address": null,
"status": "none",
"unread_count": 0,
"created_at": null,
"eligible": true,
"linked_number": "+14035551234",
"domain": "privnum.com",
"suggestions": ["alex.smith", "alex.smith42"]
}
}
/v1/numbers/{id}/private-email/availability
Bir adı kontrol edin
Bir adı almadan önce geçerli ve boş olduğunu canlı olarak kontrol edin.
Parametreler-
idinteger path ZorunluGET /numbers'tan numara kimliği.
-
local_partstring query Zorunlu@ işaretinden önceki kısım: 3-64 harf, rakam, nokta, tire veya alt çizgi.
-
availablebooleanAdresi alabiliyorsanız true.
-
reasonenum | nulltoo_short, too_long, invalid, reserved veya taken.
- 404Hesabınızdaki bir numara değil.
curl --request GET "https://api.temp-number.com/v1/numbers/1482/private-email/availability?local_part=alex.smith" \
--header "Authorization: Bearer $TEMP_NUMBER_API_KEY" \
--header "Accept: application/json"
const response = await fetch("https://api.temp-number.com/v1/numbers/1482/private-email/availability?local_part=alex.smith", {
headers: {
Authorization: `Bearer ${process.env.TEMP_NUMBER_API_KEY}`,
Accept: "application/json",
},
});
const result = await response.json();
console.log(response.status, result);
import os
import requests
response = requests.get(
"https://api.temp-number.com/v1/numbers/1482/private-email/availability",
headers={
"Authorization": f"Bearer {os.environ['TEMP_NUMBER_API_KEY']}",
"Accept": "application/json",
},
params={"local_part": "alex.smith"},
timeout=30,
)
print(response.status_code, response.json())
use Illuminate\Support\Facades\Http;
// config/services.php: 'temp_number' => ['key' => env('TEMP_NUMBER_API_KEY')]
$response = Http::withToken(config('services.temp_number.key'))
->acceptJson()
->get('https://api.temp-number.com/v1/numbers/1482/private-email/availability', [
'local_part' => 'alex.smith',
]);
$result = $response->json();
{
"success": true,
"data": {
"local_part": "alex.smith",
"address": "[email protected]",
"available": true,
"reason": null,
"message": "Available"
}
}
/v1/numbers/{id}/private-email
Adres alın
Aktif bir numaraya adresini verir. Ücretsizdir, numara başına bir tanedir ve alınan bir adres asla başka birine verilmez.
Parametreler-
idinteger path ZorunluGET /numbers'tan numara kimliği.
-
local_partstring body ZorunluKontrol ettiğiniz ad.
data içinde özel e-posta nesnesi.
Hatalar- 404Numara sizin değil veya henüz adresi yok.
- 422Ad alınmış veya geçersiz (details.reason), numaranın zaten bir adresi var ya da numara aktif değil.
curl --request POST "https://api.temp-number.com/v1/numbers/1482/private-email" \
--header "Authorization: Bearer $TEMP_NUMBER_API_KEY" \
--header "Accept: application/json" \
--header "Content-Type: application/json" \
--data '{"local_part":"alex.smith"}'
const response = await fetch("https://api.temp-number.com/v1/numbers/1482/private-email", {
method: "POST",
headers: {
Authorization: `Bearer ${process.env.TEMP_NUMBER_API_KEY}`,
Accept: "application/json",
"Content-Type": "application/json",
},
body: JSON.stringify({ local_part: "alex.smith" }),
});
const result = await response.json();
console.log(response.status, result);
import os
import requests
response = requests.post(
"https://api.temp-number.com/v1/numbers/1482/private-email",
headers={
"Authorization": f"Bearer {os.environ['TEMP_NUMBER_API_KEY']}",
"Accept": "application/json",
},
json={"local_part": "alex.smith"},
timeout=60,
)
print(response.status_code, response.json())
use Illuminate\Support\Facades\Http;
// config/services.php: 'temp_number' => ['key' => env('TEMP_NUMBER_API_KEY')]
$response = Http::withToken(config('services.temp_number.key'))
->acceptJson()
->timeout(60)
->post('https://api.temp-number.com/v1/numbers/1482/private-email', [
'local_part' => 'alex.smith',
]);
$result = $response->json();
{
"success": true,
"data": {
"address": "[email protected]",
"status": "active",
"unread_count": 0,
"created_at": "2026-07-03T10:15:00+00:00",
"eligible": false,
"linked_number": "+14035551234",
"domain": "privnum.com",
"suggestions": []
}
}
/v1/numbers/{id}/private-email/inbox
E-postaları listeleyin
En yeniden eskiye e-posta özetleri; sayfa tabanlı sayfalama ve en üst düzeyde okunmamış sayısı ile.
Parametreler-
idinteger path ZorunluGET /numbers'tan numara kimliği.
-
pageinteger query İsteğe bağlıSayfa numarası. Varsayılan 1.
-
per_pageinteger query İsteğe bağlı1-100. Varsayılan 25.
-
data[]arrayid, from_email, from_name, subject, preview, attachment_count, is_read, received_at.
-
metaobjectcurrent_page, per_page, total, last_page.
-
unread_countintegerEn üst düzeyde, data'nın yanında.
- 404Numara sizin değil veya henüz adresi yok.
- 404
private_email_closedNumara iptal edildi veya iade edildi.
curl --request GET "https://api.temp-number.com/v1/numbers/1482/private-email/inbox?page=1&per_page=25" \
--header "Authorization: Bearer $TEMP_NUMBER_API_KEY" \
--header "Accept: application/json"
const response = await fetch("https://api.temp-number.com/v1/numbers/1482/private-email/inbox?page=1&per_page=25", {
headers: {
Authorization: `Bearer ${process.env.TEMP_NUMBER_API_KEY}`,
Accept: "application/json",
},
});
const result = await response.json();
console.log(response.status, result);
import os
import requests
response = requests.get(
"https://api.temp-number.com/v1/numbers/1482/private-email/inbox",
headers={
"Authorization": f"Bearer {os.environ['TEMP_NUMBER_API_KEY']}",
"Accept": "application/json",
},
params={"page": 1, "per_page": 25},
timeout=30,
)
print(response.status_code, response.json())
use Illuminate\Support\Facades\Http;
// config/services.php: 'temp_number' => ['key' => env('TEMP_NUMBER_API_KEY')]
$response = Http::withToken(config('services.temp_number.key'))
->acceptJson()
->get('https://api.temp-number.com/v1/numbers/1482/private-email/inbox', [
'page' => 1,
'per_page' => 25,
]);
$result = $response->json();
{
"success": true,
"data": [
{
"id": 77,
"from_email": "[email protected]",
"from_name": "Example Billing",
"subject": "Your receipt",
"preview": "Thanks for your order…",
"attachment_count": 1,
"is_read": false,
"received_at": "2026-07-04T08:01:12+00:00"
}
],
"meta": { "current_page": 1, "per_page": 25, "total": 1, "last_page": 1 },
"unread_count": 1
}
/v1/numbers/{id}/private-email/inbox/{messageId}/body
E-postayı okuyun
Ek listesiyle birlikte e-postanın tamamı (HTML ve metin). Okumak e-postayı okundu olarak işaretler.
Parametreler-
idinteger path ZorunluGET /numbers'tan numara kimliği.
-
messageIdinteger path ZorunluGelen kutusu listesindeki e-posta kimliği.
- 404Numara sizin değil veya henüz adresi yok.
- 404
private_email_closedNumara iptal edildi veya iade edildi.
curl --request GET "https://api.temp-number.com/v1/numbers/1482/private-email/inbox/77/body" \
--header "Authorization: Bearer $TEMP_NUMBER_API_KEY" \
--header "Accept: application/json"
const response = await fetch("https://api.temp-number.com/v1/numbers/1482/private-email/inbox/77/body", {
headers: {
Authorization: `Bearer ${process.env.TEMP_NUMBER_API_KEY}`,
Accept: "application/json",
},
});
const result = await response.json();
console.log(response.status, result);
import os
import requests
response = requests.get(
"https://api.temp-number.com/v1/numbers/1482/private-email/inbox/77/body",
headers={
"Authorization": f"Bearer {os.environ['TEMP_NUMBER_API_KEY']}",
"Accept": "application/json",
},
timeout=30,
)
print(response.status_code, response.json())
use Illuminate\Support\Facades\Http;
// config/services.php: 'temp_number' => ['key' => env('TEMP_NUMBER_API_KEY')]
$response = Http::withToken(config('services.temp_number.key'))
->acceptJson()
->get('https://api.temp-number.com/v1/numbers/1482/private-email/inbox/77/body');
$result = $response->json();
{
"success": true,
"data": {
"id": 77,
"subject": "Your receipt",
"from_email": "[email protected]",
"from_name": "Example Billing",
"received_at": "2026-07-04T08:01:12+00:00",
"html": "<p>Thanks for your order…</p>",
"text": "Thanks for your order…",
"attachments": [
{ "index": 0, "filename": "receipt.pdf", "content_type": "application/pdf", "size_bytes": 48211 }
]
}
}
/v1/numbers/{id}/private-email/inbox/{messageId}/attachments/{index}
Eki indirin
Kendi Content-Type'ı ve dosya adıyla ham dosya. index, e-postanın attachments[] listesinden gelir.
Parametreler-
idinteger path ZorunluGET /numbers'tan numara kimliği.
-
messageIdinteger path ZorunluGelen kutusu listesindeki e-posta kimliği.
-
indexinteger path ZorunluE-postayı okuma isteğinden gelen attachments[].index.
- 404Numara sizin değil veya henüz adresi yok.
- 404
private_email_closedNumara iptal edildi veya iade edildi. - 404Bu dizinde ek yok.
curl --request GET "https://api.temp-number.com/v1/numbers/1482/private-email/inbox/77/attachments/0" \
--header "Authorization: Bearer $TEMP_NUMBER_API_KEY" \
--output receipt.pdf
import { writeFile } from "node:fs/promises";
const response = await fetch("https://api.temp-number.com/v1/numbers/1482/private-email/inbox/77/attachments/0", {
headers: {
Authorization: `Bearer ${process.env.TEMP_NUMBER_API_KEY}`,
},
});
await writeFile("receipt.pdf", Buffer.from(await response.arrayBuffer()));
import os
import requests
response = requests.get(
"https://api.temp-number.com/v1/numbers/1482/private-email/inbox/77/attachments/0",
headers={
"Authorization": f"Bearer {os.environ['TEMP_NUMBER_API_KEY']}",
},
timeout=30,
)
with open("receipt.pdf", "wb") as file:
file.write(response.content)
use Illuminate\Support\Facades\Http;
// config/services.php: 'temp_number' => ['key' => env('TEMP_NUMBER_API_KEY')]
$response = Http::withToken(config('services.temp_number.key'))
->sink(storage_path('receipt.pdf'))
->get('https://api.temp-number.com/v1/numbers/1482/private-email/inbox/77/attachments/0');
HTTP/1.1 200 OK
Content-Type: application/pdf
Content-Disposition: attachment; filename=receipt.pdf
<binary file>
/v1/numbers/{id}/private-email/inbox/{messageId}
E-postayı silin
E-postayı ve eklerini siler.
Parametreler-
idinteger path ZorunluGET /numbers'tan numara kimliği.
-
messageIdinteger path ZorunluGelen kutusu listesindeki e-posta kimliği.
- 404Numara sizin değil veya henüz adresi yok.
- 404
private_email_closedNumara iptal edildi veya iade edildi.
curl --request DELETE "https://api.temp-number.com/v1/numbers/1482/private-email/inbox/77" \
--header "Authorization: Bearer $TEMP_NUMBER_API_KEY" \
--header "Accept: application/json"
const response = await fetch("https://api.temp-number.com/v1/numbers/1482/private-email/inbox/77", {
method: "DELETE",
headers: {
Authorization: `Bearer ${process.env.TEMP_NUMBER_API_KEY}`,
Accept: "application/json",
},
});
const result = await response.json();
console.log(response.status, result);
import os
import requests
response = requests.delete(
"https://api.temp-number.com/v1/numbers/1482/private-email/inbox/77",
headers={
"Authorization": f"Bearer {os.environ['TEMP_NUMBER_API_KEY']}",
"Accept": "application/json",
},
timeout=30,
)
print(response.status_code, response.json())
use Illuminate\Support\Facades\Http;
// config/services.php: 'temp_number' => ['key' => env('TEMP_NUMBER_API_KEY')]
$response = Http::withToken(config('services.temp_number.key'))
->acceptJson()
->delete('https://api.temp-number.com/v1/numbers/1482/private-email/inbox/77');
$result = $response->json();
{
"success": true,
"data": null
}
Yapay Zekâ ve MCP
Bir yapay zekâ asistanının hesabınızı doğrudan kullanmasına izin verin ya da bir kodlama ajanına API üzerinde geliştirme yapmak için gereken her şeyi verin.
MCP sunucusu
REST API'nin yanı sıra bir Model Context Protocol sunucusu da çalıştırıyoruz. Bunu Claude, ChatGPT veya düzenleyicinize bağlayın; asistan fiyatları ve stoğu kontrol edebilir, numara satın alabilir ve SMS'lerini yerel araçlar olarak okuyabilir - sizin tarafınızda hiç kod gerekmez. MCP'de yeni misiniz? MCP sunucusuna genel bakış ile başlayın.
Uç noktahttps://mcp.temp-number.com/mcp
Giriş nasıl çalışır
- URL'yi yapay zekâ uygulamanıza ekleyin. Uygulama sizi kendi hesabınızla giriş yapmanız için Temp Number'a yönlendirir (PKCE ile OAuth 2.1) - kopyalanacak anahtar yok.
- Onay ekranında asistanın neler yapabileceğini siz seçersiniz. Bakiye, fiyatlar, numaralarınız ve SMS'lerini okumak her zaman dahildir. Satın almalara izin ver - cüzdanınızla satın alma, yenileme ve iptal etme - siz işaretlemedikçe kapalıdır.
- Her bağlantı Panel → MCP Sunucusu → Bağlı uygulamalar altında listelenir ve buradan istediğiniz zaman bağlantıyı kesebilirsiniz.
- Anahtar mı tercih edersiniz (CI, betikler, arayüzsüz ajanlar)? Aynı sayfada bir MCP anahtarı oluşturun ve
Authorization: Bearer <key>olarak gönderin. MCP anahtarları ile REST API anahtarları birbirinin yerine kullanılamaz.
Araçlar
| Araç | Ne yapar | "Satın almalara izin ver" gerekir |
|---|---|---|
get-balance | Kimliği doğrulanmış hesabın cüzdan bakiyesini ve fatura para birimini getirin. | Hayır |
get-pricing | Tüm ülkeler veya tek bir ISO ülke kodu için etkin fiyat kataloğunu döndürün. | Hayır |
get-inventory | Bir ülke, süre ve isteğe bağlı numara türü için canlı stok durumunu inceleyin. | Hayır |
purchase-number | Cüzdan bakiyesini kullanarak kimliği doğrulanmış hesap için bir özel numara satın alın. | Evet |
list-active-numbers | Kimliği doğrulanmış hesaba ait numaraları, isteğe bağlı olarak duruma göre filtrelenmiş şekilde döndürün. | Hayır |
check-sms | Kimliği doğrulanmış hesaba ait satın alınmış bir numara ID'si için SMS mesajlarını getirin. | Hayır |
renew-number | İsteğe bağlı bir süre paketiyle satın alınmış bir numarayı ID ile yenileyin. | Evet |
cancel-number | Satın alınmış bir numarayı ID ile iptal edin ve uygun cüzdan iadesini yapın. | Evet |
Yapay zekâ aracınızı bağlayın
Uygulamanızı seçin. Çoğu tek tıkla bağlanır: Temp Number'a giriş yapar, asistanın neler yapabileceğini işaretler ve Allow'a tıklarsınız.
Claude - claude.ai, Masaüstü ve mobil
Kurulacak bir şey yok. Tarayıcıda, masaüstü uygulamasında ve mobilde çalışır.
- Add to Claude'a tıklayın. Claude, Temp Number ve URL'si önceden doldurulmuş olarak açılır. Add'e tıklayın.
- Connect'e tıklayın, Temp Number'a giriş yapın, Claude'un satın alma yapıp yapamayacağını seçin ve Allow'a tıklayın.
- Herhangi bir sohbette + menüsünü → Connectors'ı açın ve Temp Number'ı etkinleştirin. Deneyin: "ABD numarasının aylık ücreti ne kadar?"
Düğme yok mu? Claude'da Customize → Connectors → Add custom connector yolunu izleyin ve MCP uç noktasını yapıştırın. Claude'un istek başlığı seçeneğine sahip kuruluşlar, giriş yapmak yerine MCP anahtarını Authorization: Bearer <key> olarak gönderebilir.
ChatGPT
Web'de ChatGPT Business, Enterprise veya Edu gerekir. Business planında bir yönetici ya da sahip ekler.
- Aşağıdaki sunucu URL'sini kopyalayın, ardından Plugins sayfasına gitmek için ChatGPT'yi aç'a tıklayın. ChatGPT'de bunu sizin yerinize dolduran bir bağlantı yoktur.
- + → Add custom MCP server'a tıklayın. Adını Temp Number koyun ve URL'yi Connection altına yapıştırın.
- Kimlik doğrulamayı OAuth olarak ayarlayın, risk uyarısını kabul edin ve Create as a plugin'e tıklayın.
- ChatGPT sorduğunda Temp Number'a giriş yapın, ChatGPT'nin satın alma yapıp yapamayacağını seçin ve Allow'a tıklayın.
- Yeni bir sohbette @ yazın ve Temp Number'ı seçin. Deneyin: "ABD numarasının aylık ücreti ne kadar?"
https://mcp.temp-number.com/mcp
Claude Code
Sunucuyu bir kez ekleyin, ardından Claude Code içinden giriş yapın.
claude mcp add --transport http temp-number https://mcp.temp-number.com/mcp
- Claude Code'u başlatın ve
/mcpyazın. - temp-number → Authenticate seçin. Tarayıcınız açılır: giriş yapın ve Allow'a tıklayın.
Bunun yerine MCP anahtarı kullanma (CI / arayüzsüz)
export TEMPNUMBER_MCP_KEY=your-mcp-key
claude mcp add --transport http temp-number \
https://mcp.temp-number.com/mcp \
--header "Authorization: Bearer $TEMPNUMBER_MCP_KEY"
Codex CLI
Sunucuyu ekleyin, ardından giriş yapın. Codex oturumu sizin için saklar.
codex mcp add temp-number --url https://mcp.temp-number.com/mcp
codex mcp login temp-number
Bunun yerine MCP anahtarı kullanma (CI / arayüzsüz)
~/.codex/config.toml dosyasında. Anahtar ortam değişkeninden okunur, bu yüzden dosyayı paylaşmak güvenlidir.
[mcp_servers.temp-number]
url = "https://mcp.temp-number.com/mcp"
bearer_token_env_var = "TEMPNUMBER_MCP_KEY"
Cursor
Tek tıklayın, ardından Cursor sorduğunda giriş yapın.
Ya da .cursor/mcp.json (veya ~/.cursor/mcp.json) dosyasına ekleyin. Cursor ardından sunucunun yanında Needs login gösterir: üzerine tıklayın, giriş yapın ve Allow'a tıklayın.
{
"mcpServers": {
"temp-number": {
"url": "https://mcp.temp-number.com/mcp"
}
}
}
Bunun yerine MCP anahtarı kullanma
{
"mcpServers": {
"temp-number": {
"url": "https://mcp.temp-number.com/mcp",
"headers": {
"Authorization": "Bearer ${env:TEMPNUMBER_MCP_KEY}"
}
}
}
}
VS Code (GitHub Copilot)
Tek tıklayın, ardından bir araç ilk kez çalıştığında giriş yapın.
Ya da .vscode/mcp.json dosyasına ekleyin - anahtarın mcpServers değil, servers olduğuna dikkat edin.
{
"servers": {
"temp-number": {
"type": "http",
"url": "https://mcp.temp-number.com/mcp"
}
}
}
Bunun yerine MCP anahtarı kullanma
VS Code anahtarı bir kez sorar ve gizli depolama alanında saklar.
{
"servers": {
"temp-number": {
"type": "http",
"url": "https://mcp.temp-number.com/mcp",
"headers": {
"Authorization": "Bearer ${input:tempnumber-mcp-key}"
}
}
},
"inputs": [
{
"type": "promptString",
"id": "tempnumber-mcp-key",
"description": "Temp Number MCP key",
"password": true
}
]
}
Diğer MCP uygulamaları
Windsurf, Zed, LibreChat, kendi ajanınız…
- MCP uç noktasını uzak (streamable HTTP) sunucu olarak ekleyin. Girişi destekleyen uygulamalar onu
https://mcp.temp-number.com/.well-known/oauth-protected-resourceadresinde kendiliğinden bulur ve Temp Number onay ekranını açar. - Girişi desteklemeyen uygulamalar MCP anahtarını
Authorization: Bearer <key>olarak gönderebilir.
https://mcp.temp-number.com/mcp
llms.txt ve ajan istemi
Yapay zekâ kodlama asistanıyla mı geliştiriyorsunuz? Ona aşağıdaki bağlamı verin; API'yi kimlik doğrulama, idempotency ve hız sınırları dahil tek seferde doğru şekilde entegre edebilir.
You are integrating the Temp Number REST API. Read the full, machine-readable reference before writing any code:
- API reference (llms.txt): https://temp-number.com/developers/llms.txt
- OpenAPI spec: https://api.temp-number.com/api.json
- Base URL: https://api.temp-number.com/v1
- MCP server (for AI agents that call tools directly): https://mcp.temp-number.com/mcp - sign in with OAuth, or send an MCP key as a Bearer token.
Rules: authenticate every request with `Authorization: Bearer <YOUR_API_KEY>` (created in the dashboard → API Access) and keep the key in an environment variable, never in code; send and accept JSON over HTTPS; send a unique `Idempotency-Key` (UUID) header on every POST that buys, renews or cancels - it is required, and retries must reuse the same key; branch on the `code` field of error responses, not on the message text; on HTTP 429 or 503, wait for the `Retry-After` header. All prices are final USD.
Task: <describe what you want to build - e.g. "buy a US number, wait for the verification SMS, then cancel it if it never arrives">.
https://temp-number.com/developers/llms.txt, tüm uç noktaların her zaman güncel, düz metin özetidir; OpenAPI belirtimi ise tipli sözleşmedir. Her ikisi de API ile birlikte güncellenir.Kaynaklar
Neler değişti ve nereden yardım alabilirsiniz.
Değişiklik günlüğü
Yalnızca ekleme niteliğinde değişiklikler - /v1 üzerinden hiçbir şey kaldırılmadı.
-
NewMCP: Temp Number hesabınızla giriş yapın
Tek tıkla "Add to Claude"; ayrıca anahtar kopyalamadan ChatGPT, Claude Code, Codex, Cursor ve VS Code. Yapay zekânın harcama yapıp yapamayacağını onay ekranında siz seçersiniz.
-
DocsDokümanlar için yeni bir yuva
Hızlı başlangıç, arama ve cURL, Node.js, Python ve PHP ile tüm örnekler. Hatalar, hız sınırları ve iadeler artık canlı API ile birebir eşleşiyor.
-
NewTüm site için llms.txt
Hizmetin yapay zekâ asistanları için düz metin haritası; ajan uyumlu API referansına bağlantı verir.
-
NewYapay zekâ aracınızı bağlayın
Claude Code, Codex, Cursor ve VS Code için kurulum; Cursor ve VS Code için tek tıkla kurulum bağlantılarıyla.
-
NewOpenAPI spesifikasyonu
Makine tarafından okunabilir sözleşme https://api.temp-number.com/api.json adresinde sunulur.
-
ImprovedNesneler referansla eşleşir
Numaralar ve SMS'ler ISO 8601 tarihleri ve from/body kullanır. Hatalar makine tarafından okunabilir bir kod taşır (out_of_stock, insufficient_funds, invalid_duration). number_type boş bırakıldığında /inventory tüm numara türlerini raporlar. Eski alan adları kullanımdan kaldırılmış takma adlar olarak hâlâ çalışır.
-
NewÖzel e-posta uç noktaları
Bir numara için ücretsiz bir [email protected] gelen kutusu alın, API üzerinden e-postaları okuyun ve ekleri indirin.
-
NewMCP sunucusu
Yapay zekâ ajanları bir MCP anahtarıyla fiyatları kontrol edebilir, numara satın alabilir ve SMS'leri araç olarak okuyabilir.
-
LaunchHerkese Açık REST API v1
Hesap, fiyatlandırma, stok, numara yaşam döngüsü ve SMS; Bearer token kimlik doğrulamasıyla.
Destek
Takıldınız mı veya bu belgelerde API'nin davranışıyla uyuşmayan bir şey mi buldunuz? Bize ulaşın - uç noktayı, isteğin zamanını ve yanıt gövdesini ekleyin (API anahtarınızı asla eklemeyin).
Geliştirmeye hazır mısınız?
Bir dakikadan kısa sürede anahtar oluşturun ve ilk çağrınızı yapın.