Միանալ 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-ը փոխարինեք առաջին քայլի տոկենով կամ բացեք 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 դաշտերը։ Ամբողջական հաշվետվության համար նույն տոկենով շարունակեք կանչել getTest / get_test-ը մինչև status-ը դառնա done կամ expired։ Ժամկետի ավարտից հետո կարող եք շարունակել նույն տոկենով։
Այս հաճախորդներն օգտագործում են հանրային /api/tests ճանապարհը։ MCP-ի հյուրերի գործիքները նույնպես աշխատում են առանց բանալու։ Տես MCP-ի հրահանգները։ Միացման բոլոր տարբերակները նշված են /sdk/integration.json ֆայլում։
Webhook-ներ առանց գրանցման՝ տեղային SDK փոխանցիչ
Ձեր ԱԲ օգնականը կարող է ներբեռնել ու կարգավորել փոխանցիչը ձեր Node.js միջավայրում։ Այն կարդում է ՊԱՀՊԱՆՎԱԾ տոկենը, սպասում վերջնական done/expired արդյունքին և մեկ ստորագրված check.completed իրադարձություն ուղարկում ձեր ընդունիչին։ Գործընթացը մի կանգնեցրեք։ Inbox 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 տողով էջեր։ Ընդգրկումը սկսվում է նշված ամսաթվից։ Ավելի հին գրառումները կարող են թերի լինել։ Հարցման մարմինները, թխուկներն ու գաղտնի տվյալները չեն ներառվում։
Դիմել ավելի մեծ անվճար փաթեթի համար
Հաշվում ընտրեք «Դիմել անվճար փաթեթի համար»։ Հաստատումից հետո ընտրված բանալու սահմանները կդառնան 500 օրական և 5 000 ամսական։ Սա փոխարինում է սահմանները, չի ավելացնում ստուգումներ և չի զրոյացնում օգտագործումը։ Մինչև հաստատումը գործում են ընթացիկ սահմանները։ Որոշման մասին կտեղեկացնենք էլփոստով։
Օգտատիրոջ հետ կապված account:read իրավասությամբ բանալին GET /api/v1/account/promo-requests հարցմամբ կարդում է միայն սեփական հայտերը։ Կարդալու իրավասությունը թույլ չի տալիս հայտ ստեղծել կամ հաստատել։ Փաթեթի համար դիմեք ձեր հաշվից։
Եթե հարցումը ձախողվի
Միայն կառավարվող API-ի համար։ 401-ի դեպքում ստուգեք Bearer բանալին, 403-ի դեպքում՝ դրա իրավասությունները։ quota_exceeded-ի դեպքում ստուգեք երկու սահմաններն էլ։ Պահպանեք 429/Retry-After պայմանը։ Սերվերի սխալի դեպքում ստեղծման POST-ը կրկնելուց առաջ պարզեք արդյունքը։ Աջակցության համար պահեք requestId-ը, սակայն մի ուղարկեք բանալին։
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 արժեքները։
| Սակագին | Օրական | Ամսական | Էկրանակադրեր |
|---|---|---|---|
| basic | 100 | 1,000 | — |
| pro | 500 | 10,000 | Ներառված է |
| enterprise | 5,000 | 100,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-ն՝ առանց գործող բանալիները փոխելու։