Inbox Placement Testby Live Direct Marketing

Dilinizi seçin

Oturum aç

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ı indirin
curl -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ı

OpenAPI · MCP · A2A

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.

SeviyeGünlükAylıkEkran görüntüleri
basic1001,000—
pro50010,000Dahil
enterprise5,000100,000Dahil

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.