SMSBulk
Dokümana dön
REST API · E-posta

E-posta Doğrulama API'si

OTP doğrulaması için tek kullanımlık e-posta adreslerini temiz bir REST API üzerinden alın. SMS uç noktalarıyla aynı JSON düzeni ve aynı API anahtarı, /v1/email-activations altında.

Temel URL

https://smsbulk.net/api/v1/email-activations

Tek API anahtarı hem SMS hem e-posta için geçerli. SMS API'sini zaten entegre ettiyseniz e-posta aynı anahtarla çalışır.

Kimlik Doğrulama

API anahtarınızı her istekle gönderin. Birbirinin yerine geçen iki yöntem kabul edilir:

# 1. Header (recommended)
curl https://smsbulk.net/api/v1/email-activations \
  -H "x-api-key: YOUR_KEY"

# 2. Bearer token
curl https://smsbulk.net/api/v1/email-activations \
  -H "Authorization: Bearer YOUR_KEY"

Anahtarı header (x-api-key) veya Bearer token ile gönderin. URL query parametresi olarak göndermek güvenlik açısından önerilmez, çünkü query string'ler genellikle sunucu ve proxy loglarına kaydedilir.

SMS API anahtarınız burada da kullanılan anahtarın aynısıdır. Ayrı bir e-posta anahtarı yoktur.

Uç Noktalar

/api/v1/email-activations altında altı uç nokta. Fiyatlar kullanıcıya yöneliktir; toptan maliyet asla döndürülmez.

GET/api/v1/email-activations/domains?site=telegram.com

Bir hedef site için kullanılabilir e-posta sağlayıcı alan adlarını, kullanıcı fiyatı ve stok ile listeler.

İstek
curl "https://smsbulk.net/api/v1/email-activations/domains?site=telegram.com" \
  -H "x-api-key: YOUR_KEY"
Yanıt
[
  { "name": "gmx.com", "price": 0.04, "count": 12, "currency": "USD" }
]
POST/api/v1/email-activations

Bir site/alan adı çifti için e-posta adresi ayırır. Cüzdanınızdan anında ücret alır ve aktivasyonu WAITING durumunda döndürür.

İstek
curl -X POST https://smsbulk.net/api/v1/email-activations \
  -H "x-api-key: YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "site": "telegram.com", "domain": "gmx.com" }'
Yanıt
{
  "id": "cmox8h7pmicm3mkczzwhdz0yd",
  "site": "telegram.com",
  "domain": "gmx.com",
  "emailAddress": "a1b2c3@gmx.com",
  "status": "WAITING",
  "otpValue": null,
  "userCost": "0.04",
  "currency": "USD",
  "expiresAt": "2026-06-03T14:05:00Z",
  "createdAt": "2026-06-03T13:45:00Z"
}
GET/api/v1/email-activations?limit=50

En yeni önce olmak üzere en son e-posta aktivasyonlarınızı döndürür. Varsayılan 50, en fazla 100, imleç sayfalaması yok.

İstek
curl "https://smsbulk.net/api/v1/email-activations?limit=50" \
  -H "x-api-key: YOUR_KEY"
Yanıt
[
  {
    "id": "cmox8h7pmicm3mkczzwhdz0yd",
    "site": "telegram.com",
    "domain": "gmx.com",
    "emailAddress": "a1b2c3@gmx.com",
    "status": "RECEIVED",
    "otpValue": "595348",
    "userCost": "0.04",
    "currency": "USD",
    "expiresAt": "2026-06-03T14:05:00Z",
    "receivedAt": "2026-06-03T13:47:12Z",
    "createdAt": "2026-06-03T13:45:00Z",
    "reorderBlockedAt": null
  }
]
GET/api/v1/email-activations/:id

Tek bir aktivasyonu getirir. Alındıktan sonra ayrıştırılmış OTP'yi ve ham HTML e-posta gövdesini içerir.

İstek
curl https://smsbulk.net/api/v1/email-activations/cmox8h7pmicm3mkczzwhdz0yd \
  -H "x-api-key: YOUR_KEY"
Yanıt
{
  "id": "cmox8h7pmicm3mkczzwhdz0yd",
  "site": "telegram.com",
  "domain": "gmx.com",
  "emailAddress": "a1b2c3@gmx.com",
  "status": "RECEIVED",
  "otpValue": "595348",
  "htmlMessage": "<html>Your code is 595348</html>",
  "userCost": "0.04",
  "currency": "USD",
  "expiresAt": "2026-06-03T14:05:00Z",
  "receivedAt": "2026-06-03T13:47:12Z",
  "createdAt": "2026-06-03T13:45:00Z",
  "reorderBlockedAt": null
}
POST/api/v1/email-activations/:id/reorder

Aynı adresi başka bir OTP için yeniden açar. Cüzdandan tekrar ücret alır (SMS yeniden gönderiminin e-posta karşılığı).

İstek
curl -X POST https://smsbulk.net/api/v1/email-activations/cmox8h7pmicm3mkczzwhdz0yd/reorder \
  -H "x-api-key: YOUR_KEY"
Yanıt
{
  "id": "cmox8h7pmicm3mkczzwhdz0yd",
  "site": "telegram.com",
  "domain": "gmx.com",
  "emailAddress": "a1b2c3@gmx.com",
  "status": "WAITING",
  "otpValue": null,
  "userCost": "0.04",
  "currency": "USD",
  "expiresAt": "2026-06-03T14:20:00Z",
  "createdAt": "2026-06-03T13:45:00Z",
  "reorderBlockedAt": null
}
Hata yanıtı

E-posta sağlayıcısı adresi engellediyse reorder 502 ve EMAIL_BANNED koduyla başarısız olur, ücret iade edilir. Bundan sonra aktivasyon liste, detay ve reorder yanıtlarında reorderBlockedAt alanını taşır (ISO tarih, aksi halde null) ve her yeni reorder ücret alınmadan 409 ve EMAIL_BANNED koduyla reddedilir. Bunun yerine yeni bir adres satın alın.

HTTP 409 Conflict
{
  "statusCode": 409,
  "code": "EMAIL_BANNED",
  "message": "Email address blocked by the provider; reorder is not possible"
}
DELETE/api/v1/email-activations/:id

Aktivasyonu iptal eder. OTP alınmadıysa cüzdanınıza iade yapar.

İstek
curl -X DELETE https://smsbulk.net/api/v1/email-activations/cmox8h7pmicm3mkczzwhdz0yd \
  -H "x-api-key: YOUR_KEY"
Yanıt
{
  "ok": true
}
Yanıt

Bu aktivasyondaki bir reorder takılı kaldıysa iptal, aktivasyonu iptal etmek yerine reorder ücretini iade eder. Yanıt 200'dür; reorderRefunded: true ve EMAIL_REORDER_REFUNDED kodunu taşır, asıl adres etkin kalır.

HTTP 200 OK
{
  "ok": true,
  "reorderRefunded": true,
  "code": "EMAIL_REORDER_REFUNDED",
  "message": "Reorder failed and was refunded. Your original email address is still active."
}
Hata yanıtı

Bu aktivasyonda bir reorder hâlâ sürüyorsa iptal 409, EMAIL_REORDER_IN_PROGRESS kodu ve retryAfterSec (beklenecek saniye) ile döner. Hiçbir şey iptal edilmez ve ücret alınmaz; bu süreden sonra tekrar deneyin.

HTTP 409 Conflict
{
  "statusCode": 409,
  "code": "EMAIL_REORDER_IN_PROGRESS",
  "message": "A reorder is in progress. Try again in a moment.",
  "retryAfterSec": 90
}

Notlar ve limitler

  • Günlük kota SMS ve e-posta arasında paylaşılır: API anahtarı başına UTC günü başına 10.000 istek.
  • Liste uç noktası tasarım gereği en fazla 100 satır (varsayılan 50) döndürür ve imleç sayfalaması içermez.
  • Sadakat indirimleri alınan ücrete otomatik uygulanır. userCost gerçekte ödediğiniz tutarı yansıtır.

E-posta doğrulamaya başlayın

API anahtarınızı alın ve ilk isteğinizi tek bir curl komutuyla gönderin.

API Anahtarı AlSwagger'ı AçDokümana Dön