Inbox Placement Testby Live Direct Marketing

Өз тіліңізді таңдаңыз

Кіру

Inbox Check сервисіне қосылу

Жария API арқылы тегін бастаңыз немесе SDK жүктеңіз. Тіркелгі де, API кілті де қажет емес.

Тегін API — жүйеге кірмей бастау

Жіберушінің пошта мекенжайы тексеруге арналған техникалық дерек. Бұл тіркелу немесе растау қадамы емес. you@example.com орнына хат жіберетін мекенжайыңызды қойыңыз.

JavaScript / Python SDK пайдалану · Браузерде іске қосу

1. Тегін тексеру жасаңыз

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}'

Жауапта token, send_to, results_url және expires_at бар. Терминалды жаппас бұрын сақтаңыз. Мысалдар еске салу мен есеп хаттарын өшіреді; жүйеге кіру хатын сұратпайды.

2. Хатыңызды өзіңіз жіберіңіз

Тексергіңіз келген хатты сол мекенжайдан әдеттегі пошта сервисі арқылы send_to ішіндегі БАРЛЫҚ мекенжайға жіберіңіз. Тексеру жасау сіздің атыңыздан хат жібермейді.

3. Нәтижені оқыңыз

curl https://check.live-direct-marketing.online/api/tests/YOUR_TEST_TOKEN

YOUR_TEST_TOKEN орнына 1-қадамдағы token қойыңыз немесе results_url ашыңыз. Күткенде күйді бірнеше секунд сайын сұраңыз. results, summary және authentication өрістерін тексеріңіз: тек соңғы күй хаттың «Кіріс» қалтасына жеткенін дәлелдемейді. Токенді құпия ұстаңыз. Есепті оқу үшін тіркелгі қажет емес.

400: сұрауды түзетіңіз. 429: resetAt / Retry-After көрсеткен уақытқа дейін күтіңіз. Тексеру жасау кезінде желі үзілсе, нәтиже белгісіз болады: POST сұрауын автоматты қайталамаңыз. Күйді сұрағанда токенді сақтаңыз. Жалпы күту уақыты аяқталса, жауапта токен мен соңғы күй беріледі, солар арқылы жүйеге кірмей жалғастыра аласыз.

Қонақ SDK: JavaScript және Python

Сүйемелденетін клиентті тікелей жүктеп алыңыз. Node.js 18+ немесе Python 3.9+ қажет. Пакет менеджері, тәуелділіктер не API кілті керек емес.

JavaScript SDK (.mjs) · Python SDK (.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.

Сақталған токенмен жалғастырыңыз — басқа тексеру жасамаңыз

Хатты жіберген соң СОЛ токенмен бөлек скриптті орындаңыз. Жасау скриптін қайта іске қоссаңыз, басқа мекенжайлары бар жаңа тексеру жасалады.

// 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 алғашқы өлшенген провайдер күйін немесе соңғы нәтижені қайтарады. Ол ішінара болуы мүмкін. status пен results өрістерін қараңыз. Толық соңғы есеп керек болса, status мәні done не expired болғанша сол токенмен getTest / get_test шақыруды жалғастырыңыз. Күту уақыты бітсе, сол токенмен қайта жалғастыруға болады.

Бұл клиенттер жария /api/tests пайдаланады. Қашықтағы MCP қонақ құралдары да кілтсіз жұмыс істейді. MCP нұсқаулығын пайдаланыңыз. Қазіргі баптау тәсілдері /sdk/integration.json файлында берілген.

Тіркелусіз webhook: жергілікті SDK ретрансляторы

ЖИ көмекшісі ретрансляторды өз Node.js ортаңызға жүктеп баптай алады. Ол САҚТАЛҒАН тексеру токенін оқып, соңғы done/expired күйін күтеді, содан соң қабылдаушыңызға қол қойылған бір check.completed оқиғасын жібереді. Процесті жұмыс істеп тұрған күйде қалдырыңыз. Бұл Check серверінде орналастырылған webhook жазылымы емес.

Webhook ретрансляторы мен қолтаңба тексергішін жүктеу
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 және YOUR_RECEIVER орнына бұрын жасалған токенді және өз HTTPS қабылдаушыңызды қойыңыз. Баптау кездейсоқ қолтаңба кілті бар жаңа жеке файл жазады. Бар файлдың үстіне жазуға рұқсат бермейді.

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

Іске қоспас бұрын қабылдаушыны сол құпия кілтпен баптаңыз. Сұраудың бастапқы денесін, X-Inbox-Check-Timestamp және X-Inbox-Check-Signature өрістерін тексеріңіз. Қолтаңба: sha256=HMAC-SHA256(secret, timestamp + "." + rawBody). Ескірген уақыт белгілерін қабылдамаңыз және event.id бойынша қайталанған оқиғаларды алып тастаңыз.

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.

Ретранслятор ешқашан тексеру жасамайды және сынақ хатын жібермейді. Ол кері шақырудың POST сұрауын қайталамайды және қайта бағыттауға ермейді. Жеткізілуі белгісіз болса, қатеде eventId болады: қайта іске қоспас бұрын қабылдаушыны тексеріңіз. Күту уақыты бітсе, токен мен баптауды сақтап, сол тексеруді жалғастырыңыз. Мерзімі өтіп, бірде-бір хат алынбаған нәтиже мерзімі өткен күйде қалады.

Қосымша тіркелгі, жоғары шектер және басқарылатын интеграциялар

Қосылу кілтіңіз

Поштадағы сілтеме арқылы кіріңіз. Алғаш расталған кіру кезінде тіркелгі бетінде тіркелгі мен кілт автоматты түрде жасалады.

Тіркелгі жасауКіруТіркелгіні ашу

Basic: әдепкіде күніне 100, айына 1 000 тексеру, экран суреттері кірмейді. Тіркелгі мен me_get нақты шек пен шығынды көрсетеді. Тіркелгіде 500/5 000 тегін пакетін сұратуға болады; ол мақұлданғаннан кейін қосылады.

Жаңа кілттерді жүйеге кірген соң қайта көруге және көшіруге болады. Ескі кілттер жарамды, бірақ мәні қалпына келмейді. Жаңасын жасап, интеграцияңызды жаңартыңыз да, ескі кілтті өшіріңіз. Кілтті құпия сақтаңыз.

1. Қосылымды тексеріңіз

YOUR_API_KEY орнына өз кілтіңізді қойыңыз. GET /api/v1/me осы кілттің шектері мен қалған тексерулерін көрсетеді. Ол тексеру квотасын жұмсамайды.

curl https://check.live-direct-marketing.online/api/v1/me \
  -H "Authorization: Bearer YOUR_API_KEY"

2. Тексеру жасаңыз

Сәтті жасалған әр тексеру квотаның бір бірлігін жұмсайды. Кілтіңізге қолжетімді провайдерлерді GET /api/v1/providers арқылы таңдаңыз.

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. Хатыңызды өзіңіз жіберіңіз

Жауапта send_to мекенжайлары мен results_url бар. Өз пошта сервисіңізден қайтарылған БАРЛЫҚ мекенжайға хат жіберіңіз. Тексеру жасау сіз үшін хат жібермейді.

4. Есепті ашыңыз

results_url ашыңыз немесе GET /api/v1/tests/:token сұрауын оқыңыз. Нәтижені оқу квотаны жұмсамайды. Жеткізу уақыты әртүрлі; хат табылмаса, сәтті жеткізілгені расталмайды.

Шектер мен тарих

Basic тарифі күніне 100, айына 1 000 тексеруден басталады. Нақты шектер өзгеше болуы мүмкін: осы кілт үшін /api/v1/me, ал барлық кілт үшін тіркелгі бетін ашыңыз. Қолжетімді саны — күндік және айлық қалдықтың кішісі.

Күндік кезең күн сайын, айлық кезең айдың бірінші күні 00:00 UTC-де жаңарады. Тіркелгіде уақыт сіздің белдеуіңізде көрсетіледі. API сұраулары мен сәтсіз сұраулар тексерулерден бөлек есептеледі.

Тіркелгі тарихында сұрау мәліметтері 30 күн сақталады. Сүзгілер бар, әр бетте 20 немесе 50 жол көрсетіледі. Толық деректер көрсетілген күннен басталады; одан бұрынғы жазбалар толық болмауы мүмкін. Сұрау мазмұны, cookie файлдары мен құпия деректер сақталмайды.

Кеңейтілген тегін пакет сұрату

Тіркелгіде «Тегін пакетке өтінім беру» тармағын пайдаланыңыз. Мақұлданғаннан кейін таңдалған кілт шектері күніне 500 және айына 5 000 болады. Бұрынғы шектер ауысады; қосымша тексеру үстемеленбейді және шығын есептегіші тазаланбайды. Мақұлданғанша қазіргі шектер сақталады. Шешім поштаға келеді.

Тіркелгіге байланған account:read рұқсаты бар кілт өзінің өтінімдерін GET /api/v1/account/promo-requests арқылы оқи алады. Оқу құқығы өтінім жасауға не мақұлдауға рұқсат бермейді; пакетті сұрату үшін тіркелгіге кіріңіз.

Сұрау сәтсіз аяқталса

Басқарылатын API үшін: 401 болса, Bearer кілтін, 403 болса, оның рұқсаттарын тексеріңіз. quota_exceeded үшін екі шекті де қараңыз. 429/Retry-After нұсқауын орындаңыз. Сервер қатесінен кейін жасауға арналған POST сұрауын қайталамас бұрын нәтижені тексеріңіз. Қолдауға хабарласқанда requestId сақтаңыз, кілтті ешқашан жібермеңіз.

Толық API анықтамалығы мен интеграциялар

OpenAPI · MCP · A2A

Жаңа әдепкі кілттер өз мониторингіңізді басқаруға шектелген құқық береді; әкімші рұқсаты берілмейді. Қолданыстағы кілт құқықтары өзгермейді. Құқығы шектеулі кілтті тіркелгі баптауларынан бөлек таңдауға болады.

Кеңейтілген анықтамалық: endpoint мекенжайлары, тарифтер және код

OpenAPI маршруттар мен қолжетімді сұрау схемаларын тізімдейді. Кей жауап схемалары сипатталмаған; мысалдар мен нақты жауап өрістерін пайдаланыңыз. Басқарылатын сұраулар Authorization: Bearer YOUR_API_KEY қолданады. Мониторингті өзгерту үшін monitoring:write, оқу үшін monitoring:read және қолданушыға байланған кілт қажет.

GET /api/v1/me
Кілт метадеректері, мүмкіндіктер, рұқсат етілген провайдерлер, квота және UTC бойынша жаңару уақыты.
GET /api/v1/providers
Осы кілтке қолжетімді провайдерлер.
POST /api/v1/tests
Тексеру жасаңыз. 202 жауабында token, send_to және results_url беріледі.
GET /api/v1/tests
Тексерулеріңізді cursor және limit параметрлері арқылы беттеп қараңыз.
GET /api/v1/tests/:token
Қалталарды, аутентификацияны, диагностиканы және қолжетімді экран суреттерінің URL мекенжайларын оқыңыз.
DELETE /api/v1/tests/:token
Тексеруді, нәтижелерді және экран суреттерін біржола жойыңыз.
GET /api/v1/monitoring/domains
Сайт пен Telegram-ға ортақ бақылаудағы домендеріңізді тізімдеңіз.
POST /api/v1/monitoring/domains
Доменіңізді қосыңыз: {"domain":"example.com"}.
POST /api/v1/monitoring/domains/:id/pause
Домен мониторингін кідіртіңіз.
POST /api/v1/monitoring/domains/:id/resume
Домен мониторингін жалғастырыңыз.
DELETE /api/v1/monitoring/domains/:id
Бақылаудағы доменіңізді алып тастаңыз.
GET /api/v1/account/promo-requests
account:read арқылы өз тегін пакет өтінімдеріңізді оқыңыз.

Әдепкі тарифтер

Оператор жеке кілттердің шектерін өзгерте алады. Нақты шек үшін әрқашан API қайтарған мәндерді пайдаланыңыз.

ТарифКүнінеАйынаЭкран суреттері
basic1001,000—
pro50010,000Қамтылған
enterprise5,000100,000Қамтылған

Node / Python

Бөлек SDK қажет емес. Кілтті құпия орта айнымалысында сақтаңыз, бастапқы код репозиторийіне қоспаңыз.

Node (fetch)

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 (requests)

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())

Үйлесімділік

Қолданыстағы v1 тексерулерінің CRUD әрекеттері, рұқсат етілген провайдерлер, экран суреттері және әр кілттің квоталары қолданыла береді. Тіркелгіге кіру, қайта көруге болатын жаңа кілттер, сұрау тарихы мен тегін пакет өтінімдері бұрынғы кілттерді өзгертпей API мүмкіндіктерін кеңейтеді.