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 кабыл алуучу дарегиңизди коюңуз. Configure жаңы купуя файлга кокус түзүлгөн кол ачкычын жазат. Мурдагы файлдын үстүнө жазбайт.

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

Жаңы демейки ачкычтар өз көзөмөлүңүз үчүн чектелген уруксаттарды берет. Администратор мүмкүнчүлүгү берилбейт. Мурунку ачкычтардын уруксаттары сакталат. Аккаунт жөндөөлөрүнөн чектелген ачкычты өзүнчө тандаса болот.

Толук маалымат: API даректери, тарифтер жана код

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’ни толуктайт.