Gelen Kutusu Kontrolüne Bağlan
Genel API ile ücretsiz başlayın veya SDK'yı indirin. Hesap veya API anahtarı gerekmez.
Ücretsiz API — oturum açmadan başlayın
Gönderenin e-postası, bir kayıt veya doğrulama adımı değil, test için teknik bir girdidir. you@example.com adresini göndereceğiniz adresle değiştirin.
JavaScript / Python SDK'sını kullanın · Tarayıcıda çalıştır
1. Ücretsiz bir test oluşturun
curl -X POST https://check.live-direct-marketing.online/api/tests -H "Content-Type: application/json" -d '{"email":"you@example.com","senderLinkReports":false,"placementChangeAlertsEnabled":false,"finalReportEnabled":false}'Yanıt, token, send_to, results_url ve expures_at öğelerini içerir. Terminalinizi kapatmadan önce bunları saklayın. Örnekler hatırlatma/rapor e-postalarını devre dışı bırakır; giriş e-postası istemezler.
2. Kendi e-postanızı gönderin
Bu adresten kontrol etmek istediğiniz mesajı normal e-posta hizmetiniz aracılığıyla send_to'daki TÜM adreslere gönderin. Test oluşturmak onu sizin için göndermez.
3. Sonucu okuyun
curl https://check.live-direct-marketing.online/api/tests/YOUR_TEST_TOKEN
YOUR_TEST_TOKEN'i 1. adımdaki jetonla değiştirin veya results_url'yi açın. Beklerken birkaç saniyede bir oylamaya devam edin. Sonuçları, özeti ve kimlik doğrulamayı inceleyin: Terminal durumu tek başına gelen kutusunun teslim edildiğini kanıtlamaz. Jetonunuzu gizli tutun; raporunuzu okumak için hesaba gerek yoktur.
400: isteği düzeltin. 429: resetAt / Retry-After'a kadar bekleyin. Test oluştururken oluşan ağ hatasının bilinmeyen bir sonucu var: POST'u otomatik olarak tekrarlamayın. Oy verirken jetonu saklayın. Genel bekleme zaman aşımı, belirteci ve son anlık görüntüyü içerir; böylece oturum açmadan devam edebilirsiniz.
Konuk SDK'sı: JavaScript ve Python
Bakımı yapılan istemciyi doğrudan indirin. Node.js 18+ veya Python 3.9+; paket yöneticisine, bağımlılığa veya API anahtarına gerek yoktur.
JavaScript SDK'sı (.mjs) · Python SDK'sı (.py)
JavaScript
curl -fsS https://check.live-direct-marketing.online/sdk/inbox-check.mjs -o inbox-check.mjs
// Save as check.mjs, replace the sender address, then run: node check.mjs
import { InboxCheck } from './inbox-check.mjs';
const client = new InboxCheck();
const test = await client.createTest({ email: 'you@example.com' });
console.log(test); // Keep token, send_to and results_url.
// Send your own email to ALL send_to addresses before waiting.
// Save the returned token; use the separate read script below.Python
curl -fsS https://check.live-direct-marketing.online/sdk/inbox_check.py -o inbox_check.py
# Save as check.py, replace the sender address, then run: python3 check.py
from inbox_check import InboxCheck
client = InboxCheck()
test = client.create_test('you@example.com')
print(test) # Keep token, send_to and results_url.
# Send your own email to ALL send_to addresses before waiting.
# Save the returned token; use the separate read script below.Kaydedilen jetonla devam edin; başka bir test oluşturmayın
Mesajı gönderdikten sonra SAME jetonunu kullanarak ayrı bir komut dosyası çalıştırın. Create betiğini yeniden çalıştırmak, farklı tohum adresleriyle başka bir test oluşturur.
// Save as read.mjs, replace YOUR_TEST_TOKEN, then: node read.mjs
import { InboxCheck } from './inbox-check.mjs';
const client = new InboxCheck();
const report = await client.waitForResult('YOUR_TEST_TOKEN');
console.log(report);# Save as read.py, replace YOUR_TEST_TOKEN, then: python3 read.py
from inbox_check import InboxCheck
client = InboxCheck()
report = client.wait_for_result('YOUR_TEST_TOKEN')
print(report)waitForResult / wait_for_result, ölçülen ilk sağlayıcı anlık görüntüsünü veya bir terminal sonucunu döndürür. Kısmi olabilir: durumu ve sonuçları inceleyin ve nihai raporun tamamına ihtiyacınız varsa durum tamamlanana veya süresi dolana kadar getTest / get_test'i aynı belirteçle çağırmaya devam edin. Bu jetonla zaman aşımı devam ettirilebilir.
Bu istemciler public /api/tests kullanıyor. Uzak MCP konuk araçları da anahtar olmadan çalışır: MCP talimatlarını kullanın. Mevcut tüm kurulum seçenekleri /sdk/integration.json'da listelenmiştir.
Kayıt gerektirmeyen web kancaları: yerel SDK geçişi
Yapay zekanız bu aktarıcıyı kendi Node.js ortamınıza indirip yapılandırabilir. SAVED test jetonunu okur, son yapılan/süresi dolan anlık görüntüyü bekler ve ardından alıcınıza imzalı bir check.completed olayı gönderir. Süreci çalışır durumda tutun. Bu, barındırılan bir Check webhook aboneliği değildir.
Webhook geçişini ve imza doğrulayıcıyı indirincurl -fsS https://check.live-direct-marketing.online/sdk/inbox-check.mjs -o inbox-check.mjs curl -fsS https://check.live-direct-marketing.online/sdk/inbox-check-webhooks.mjs -o inbox-check-webhooks.mjs
SAVED_TEST_TOKEN ve YOUR_RECEIVER'ı önceden oluşturulmuş belirteçle ve kendi HTTPS alıcınızla değiştirin. Yapılandır, rastgele imzalama sırrına sahip yeni bir özel dosya yazar; mevcut bir dosyanın üzerine yazmayı reddeder.
node inbox-check-webhooks.mjs configure --token SAVED_TEST_TOKEN --url https://YOUR_RECEIVER/hook --config ./inbox-check-webhook.json node inbox-check-webhooks.mjs run --config ./inbox-check-webhook.json
Çalıştırmadan önce alıcınızı aynı özel sır ile yapılandırın. Ham istek gövdesini, X-Inbox-Check-Timestamp ve X-Inbox-Check-Signature'ı doğrulayın. İmza şu şekildedir: sha256=HMAC-SHA256(secret, timestamp + "." + rawBody). Eski zaman damgalarını reddedin ve event.id'yi tekilleştirin.
import { verifyWebhook } from './inbox-check-webhooks.mjs';
// Receiver: use your privately configured shared secret and RAW request body.
const valid = verifyWebhook({
body: rawBody, secret: privateSharedSecret,
timestamp: request.headers['x-inbox-check-timestamp'],
signature: request.headers['x-inbox-check-signature']
});
// Reject invalid signatures before parsing/acting on the event.
// Deduplicate JSON.parse(rawBody).id before processing a valid event.Aktarıcı hiçbir zaman test oluşturmaz veya test e-postası göndermez. POST'ları geri çağırmayı yeniden denemez veya yönlendirmeleri takip etmez. Geri aramanın teslimi belirsizse hata, eventId'yi içerir: yeniden çalıştırmadan önce alıcınızı kontrol edin. Yoklama zaman aşımına uğrarsa belirteci/yapılandırmayı saklayın ve aynı testi sürdürün. Hiçbir mesajın alınmadığı, süresi dolmuş bir sonuç, süresi dolmuş bir sonuç olarak kalır.
İsteğe bağlı hesap, daha yüksek limitler ve yönetilen entegrasyonlar
Bağlantı anahtarınız
Bir e-posta bağlantısıyla oturum açın. Onaylanan ilk oturum açma işleminiz, hesabınızı oluşturur ve Hesap'ta otomatik olarak anahtarınızı oluşturur.
Hesap oluşturOturum açHesap Aç
Temel: Varsayılan olarak ekran görüntüleri olmadan günde 100 ve ayda 1.000 kontrol. Account ve me_get kesin sınırları ve kullanımı gösterir. Hesapta ücretsiz 500/5.000 paketini talep edin; onaylandıktan sonra başlar.
Oturum açtıktan sonra yeni anahtarlar tekrar gösterilebilir ve kopyalanabilir. Eski anahtarlar hâlâ çalışır ancak kurtarılamaz: Yeni bir anahtar oluşturun, entegrasyonunuzu güncelleyin ve ardından eski anahtarı iptal edin. Anahtarınızı gizli tutun.
1. Bağlantıyı kontrol edin
YOUR_API_KEY'inizi anahtarınızla değiştirin. GET /api/v1/me bu anahtarın sınırlarını ve kalan kontrolleri gösterir. Kontrol tüketmez.
curl https://check.live-direct-marketing.online/api/v1/me \ -H "Authorization: Bearer YOUR_API_KEY"
2. Bir test oluşturun
Başarılı bir şekilde oluşturulan bir test, bir kontrol kullanır. GET /api/v1/providers ile anahtarınızın kullanabileceği sağlayıcıları seçin.
curl -X POST https://check.live-direct-marketing.online/api/v1/tests \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{"providers":["gmail","outlook"],"recipient_email":"you@example.com"}'3. Kendi e-postanızı gönderin
Yanıt send_to adreslerini ve results_url'yi içerir. E-postanızı kendi posta servisinizden geri gönderilen TÜM adreslere gönderin. Test oluşturmak size e-posta göndermez.
4. Raporu açın
Results_url'yi açın veya GET /api/v1/tests/:token'ı okuyun. Sonuçların okunması kontrol tüketmez. Teslimat süreleri değişiklik gösterir; Eksik bir mesaj başarılı teslimatın kanıtı değildir.
Sınırlar ve tarih
Basic varsayılan olarak günde 100, ayda 1.000 kontrol içerir. Kesin sınırlar değişebilir: geçerli anahtar için /api/v1/me, tüm anahtarlarınız için hesap sayfasını kullanın. Kullanılabilir kontrol sayısı, günlük sınırdan kalan kontrol sayısı ile aylık sınırdan kalan kontrol sayısının küçük olanıdır.
Dönemler her gün 00:00 UTC'de ve ayın ilk gününde sıfırlanır. Hesap, sıfırlamaları yerel saatinize göre gösterir. API istekleri ve başarısız istekler, kontrollerden ayrı olarak sayılır.
Hesap geçmişi, filtreler ve 20/50 satırlık sayfalarla istek ayrıntılarını 30 gün boyunca tutar. Kapsam burada gösterilen tarihte başlar; daha önceki kayıtlar eksik olabilir. İstek organları, çerezler ve sırlar dahil değildir.
Daha büyük bir ücretsiz paket isteyin
Hesapta Ücretsiz paket iste seçeneğini kullanın. Onaylandıktan sonra seçilen anahtarın limitleri günlük 500, aylık 5.000 olur. Bu onun sınırlarının yerini alır; kontrol eklemez veya kullanımı temizlemez. Onaylanana kadar mevcut sınırlar geçerlidir. Karar e-postayla geliyor.
account:read özelliğine sahip kullanıcıya bağlı bir anahtar, GET /api/v1/account/promo-requests adresindeki kendi isteklerini okuyabilir. Okuma erişimi, isteklerin oluşturulmasına veya onaylanmasına izin vermez; Bir paket istemek için oturum açmış olduğunuz hesabı kullanın.
Bir istek başarısız olursa
Yalnızca yönetilen API: 401, Taşıyıcı anahtarını kontrol etmek anlamına gelir; 403, izinlerini kontrol etmek anlamına gelir. quota_exceeded için her iki sınırı da kontrol edin. Saygı429/Sonra Yeniden Dene. Sunucu hataları için, POST oluşturma işlemini tekrarlamadan önce sonucu inceleyin. Destek ekibiyle iletişime geçtiğinizde requestId'yi saklayın ancak anahtarınızı asla göndermeyin.
Eksiksiz API referansı ve entegrasyonları
Yeni varsayılan anahtarlar, yönetici erişimi olmadan kendi izlemeniz için kapsamlı izinler içerir. Mevcut anahtar izinleri değişmeden kalır. Kısıtlanmış anahtarlar, Hesap ayarlarında açık bir seçenek olmaya devam ediyor.
Gelişmiş referans: uç noktalar, katmanlar ve kod
OpenAPI rotaları ve mevcut istek şemalarını listeler. Bazı yanıt şemaları bildirilmemiştir; örnekleri ve gerçek yanıt alanlarını kullanın. Yönetilen çağrılar Yetkilendirmeyi kullanır: Taşıyıcı YOUR_API_KEY. Mutasyonların izlenmesi izleme gerektirir:yazma; okumalar izleme gerektirir:okuma ve kullanıcıya bağlı bir anahtar.
- GET /api/v1/me
- Önemli meta veriler, özellikler, izin verilen sağlayıcılar, kota ve UTC sıfırlama süreleri.
- GET /api/v1/providers
- Sağlayıcılar bu anahtar için kullanılabilir.
- POST /api/v1/tests
- Bir test oluşturun. 202 yanıtı token, send_to ve results_url'yi içerir.
- GET /api/v1/tests
- Testlerinizi imleç ve sınır sayfalandırması ile listeleyin.
- GET /api/v1/tests/:token
- Yerleşimleri, kimlik doğrulamayı, teşhisleri ve mevcut ekran görüntüsü URL'lerini okuyun.
- DELETE /api/v1/tests/:token
- Testinizi, sonuçlarınızı ve ekran görüntülerinizi kalıcı olarak silin.
- GET /api/v1/monitoring/domains
- Web sitesi ve Telegram ile paylaşılan, izlenen alan adlarınızı listeleyin.
- POST /api/v1/monitoring/domains
- Alanınızı ekleyin: {"domain":"example.com"}.
- POST /api/v1/monitoring/domains/:id/pause
- Etki alanı izlemenizi duraklatın.
- POST /api/v1/monitoring/domains/:id/resume
- Etki alanı izlemenize devam edin.
- DELETE /api/v1/monitoring/domains/:id
- İzlenen alanınızı kaldırın.
- GET /api/v1/account/promo-requests
- account:read ile kendi ücretsiz paket taleplerinizi okuyun.
Varsayılan katmanlar
Operatörler bireysel tuşları geçersiz kılabilir. Gerçek sınırlar için her zaman API değerlerini kullanın.
| Seviye | Günlük | Aylık | Ekran görüntüleri |
|---|---|---|---|
| basic | 100 | 1,000 | — |
| pro | 500 | 10,000 | Dahil |
| enterprise | 5,000 | 100,000 | Dahil |
Düğüm / Python
Ayrı bir SDK gerekmez. Anahtarı asla kaynak kontrolünde değil, gizli bir ortam değişkeninde tutun.
Düğüm (getir)
const response = await fetch('https://check.live-direct-marketing.online/api/v1/me', {
headers: { Authorization: 'Bearer ' + process.env.ICP_KEY }
});
if (!response.ok) throw new Error('HTTP ' + response.status);
console.log(await response.json());Python (istekler)
import os, requests
response = requests.get(
'https://check.live-direct-marketing.online/api/v1/me',
headers={'Authorization': 'Bearer ' + os.environ['ICP_KEY']},
timeout=30,
)
response.raise_for_status()
print(response.json())Uyumluluk
Mevcut v1 test CRUD'u, sağlayıcı izin verilenler listeleri, ekran görüntüsü özellikleri ve anahtar başına kotalar desteklenmeye devam edecektir. Hesapta oturum açma, kurtarılabilir yeni anahtarlar, istek geçmişi ve ücretsiz paket istekleri, mevcut anahtarları değiştirmeden bu API'yi genişletir.