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 sadece birkaç dakikanızı 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": null,
  "status": "WAITING",
  "otpValue": null,
  "userCost": "0.04",
  "currency": "USD",
  "expiresAt": "2026-06-03T14:05:00Z",
  "receivedAt": null,
  "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": "[email protected]",
    "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"
  }
]
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": "[email protected]",
  "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"
}
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": null,
  "status": "WAITING",
  "otpValue": null,
  "userCost": "0.04",
  "currency": "USD",
  "expiresAt": "2026-06-03T14:20:00Z",
  "receivedAt": null,
  "createdAt": "2026-06-03T13:45:00Z"
}
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
{
  "id": "cmox8h7pmicm3mkczzwhdz0yd",
  "site": "telegram.com",
  "domain": "gmx.com",
  "emailAddress": null,
  "status": "REFUNDED",
  "otpValue": null,
  "userCost": "0.04",
  "currency": "USD",
  "expiresAt": "2026-06-03T14:05:00Z",
  "receivedAt": null,
  "createdAt": "2026-06-03T13:45:00Z"
}

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