ইমেইল, ইনবক্স ও ডোমেইনের জন্য
স্প্যাম যাচাই API

দ্রুত শুরু

তিনটি কল। কোনো কী, অ্যাকাউন্ট বা সাইনআপ নয়। দুটি অনুরোধ এবং একটি ইমেইল। তৃতীয় কলটি শুধু এ কারণে প্রয়োজন যে বিশ্লেষণে কয়েক সেকেন্ড সময় লাগে।

1. একটি ঠিকানা সংরক্ষণ করুন

   ইনবক্স এন্ডপয়েন্টে POST করুন। আপনি এমন একটি ঠিকানা পাবেন যা ঠিক একটি বার্তা গ্রহণ করে এবং এক ঘণ্টার মধ্যে মেয়াদোত্তীর্ণ হয়, সঙ্গে পাবেন সেই স্লাগ যার ভিত্তিতে বাকি সবকিছু নির্ধারিত হয়।

   অনুরোধ

   # 1. reserve a single-use address
   curl -sX POST 'https://email-spam-tester.com/api/v1/inbox?lang=en'

   প্রতিক্রিয়া

   {
     "address": "test-<slug>@t.email-spam-tester.com",
     "slug": "<slug>",
     "expires_at": "2026-01-01T12:00:00Z"
   }

2. এতে আসল বার্তাটি পাঠান

   SMTP-এর মাধ্যমে, যে প্ল্যাটফর্ম থেকে ক্যাম্পেইনটি পাঠানো হবে সেখান থেকে। পরীক্ষাগুলোর অর্ধেক আপনার পাঠানোর প্ল্যাটফর্মের যোগ করা হেডার পড়ে, তাই হাতে তৈরি করা বার্তা ভুল বিষয় পরিমাপ করে।

   অনুরোধ

   # 2. send your message to that address, from your own platform
   To: test-<slug>@t.email-spam-tester.com

3. স্ট্যাটাস পোল করুন, তারপর প্রতিবেদনটি পড়ুন

   স্ট্যাটাস এন্ডপয়েন্টের আকার কয়েকশ বাইট এবং এটি আপনাকে জানায় পূর্ণ প্রতিবেদনটি এখন সংগ্রহ করা উপযুক্ত কি না। প্রতিবেদনটি নিজেই কয়েক হাজার লাইন দীর্ঘ।

   অনুরোধ

   # 3. poll
   curl -s 'https://email-spam-tester.com/api/v1/tests/<slug>/status'

   প্রতিক্রিয়া

   {
     "slug": "<slug>",
     "analysis_status": "checks_ready",
     "ai_status": "running",
     "checks_done": 42,
     "checks_total": 42
   }

   অনুরোধ

   # 4. read the report once analysis_status is checks_ready
   curl -s 'https://email-spam-tester.com/api/v1/tests/<slug>'

   প্রতিক্রিয়া

   {
     "report_url": "https://email-spam-tester.com/t/<slug>",
     "score_ours": 86.4,
     "score_compat": 9.2,
     "subscores": {"auth": 100.0, "infra_spam": 78.1, "content": 92.0, "compliance": 75.0},
     "complete": true,
     "checks": [
       {
         "id": "auth.dmarc",
         "status": "warn",
         "title": "DMARC result",
         "summary": "DMARC passes, but the policy is p=none.",
         "weight_ours": -4.0,
         "evidence": {"policy": "none", "aligned": "dkim"},
         "citations": {"standards": [{"title": "RFC 9989 §4.7", "quote": "..."}]}
       }
     ],
     "fixes": [
       {"id": "dmarc-enforce", "gain_ours": 4.0, "gain_compat": 0.0,
        "fix": {"title": "Move DMARC to quarantine", "severity": "medium"}}
     ]
   }

একটি ঠিকানা সংরক্ষণ করুন, আপনার তালিকায় যে বার্তাটি পাঠাতে যাচ্ছিলেন সেটি পাঠান, প্রতিবেদনটি পড়ুন। পৃষ্ঠায় দেখানো সবকিছু JSON-এ রয়েছে, যার মধ্যে আছে স্কোর, প্রমাণসহ ৪২টি পরীক্ষা এবং প্রতিটি ফলাফল যে মানদণ্ডের অনুচ্ছেদের ওপর ভিত্তি করে তার উল্লেখ।

প্রথম 100,000টি রিপোর্ট বিনামূল্যে, কোনো key বা account ছাড়াই। আপনি যদি script-এর বদলে agent সংযুক্ত করেন, তাহলে polling-এর চেয়ে MCP server বেশি উপযুক্ত।

এন্ডপয়েন্ট

মূল ঠিকানা https://email-spam-tester.com। সবকিছু JSON-এ উত্তর দেয়।

দ্রুত শুরু

1. একটি পরীক্ষা তৈরি করুন

   প্লেসমেন্ট এন্ডপয়েন্টে POST করুন। আপনি একটি মার্কার এবং পরীক্ষামূলক ইনবক্সগুলো ফেরত পাবেন।

   অনুরোধ

   # 1. create a test
   curl -sX POST 'https://email-spam-tester.com/api/v1/placement' \
     -H 'Content-Type: application/json' \
     -d '{"public_results_accepted":true}'

   প্রতিক্রিয়া

   {
     "slug": "<slug>",
     "marker": "est-3f9a1c7e2b4d6a80c5e1f2d3",
     "status": "waiting",
     "deadline": "2026-10-31T12:30:00Z",
     "poll_after_seconds": 60,
     "results": [
       {"address": "<seed>", "provider": "gmail", "kind": "Gmail",
        "placement": "pending", "observed_at": null}
     ],
     "fleet": {
       "status": "observing",
       "results": [
         {"address": "<mailbox>", "provider": "yahoo", "available": true,
          "placement": "pending", "coverage": "pending"}
       ]
     }
   }

2. প্রতিটি ইনবক্সে একটি বার্তা পাঠান

   বিষয়ে মার্কারটি রাখুন এবং আপনার স্বাভাবিক প্ল্যাটফর্ম থেকে সব ঠিকানায় একবারে পাঠান।

   অনুরোধ

   # 2. one message to every address, with the marker in the subject
   Subject: October invoice est-3f9a1c7e2b4d6a80c5e1f2d3
   To: <seed>, <mailbox>, ...

3. ফোল্ডারগুলোর জন্য পোল করুন

   প্রতিটি ঠিকানায় তার প্রোভাইডার ও ফোল্ডারের তথ্য পূরণ হয়। স্ট্যাটাস waiting থাকা বন্ধ না হওয়া পর্যন্ত পোল করুন।

   অনুরোধ

   # 3. poll for the folders
   curl -s 'https://email-spam-tester.com/api/v1/placement/<slug>'

   প্রতিক্রিয়া

   {
     "status": "complete",
     "received": 2,
     "total": 2,
     "results": [
       {"address": "<seed>", "provider": "gmail", "kind": "Gmail",
        "placement": "primary", "observed_at": "2026-10-31T12:04:11Z"},
       {"address": "<seed>", "provider": "gmail", "kind": "Google Workspace",
        "placement": "promotions", "observed_at": "2026-10-31T12:04:11Z"}
     ],
     "fleet": {
       "status": "finished",
       "results": [
         {"address": "<mailbox>", "provider": "yahoo", "available": true,
          "placement": "inbox", "coverage": "ok"},
         {"address": "<mailbox>", "provider": "outlook", "available": true,
          "placement": "spam", "coverage": "ok"}
       ]
     }
   }

এন্ডপয়েন্ট

দ্রুত শুরু

1. একটি GET করুন

   ডোমেইনটি দিন। ip আপনার প্রেরণকারী ঠিকানাগুলো যোগ করে, এবং selector যে DKIM সিলেক্টরগুলো পড়তে হবে সেগুলোর নাম দেয়।

   অনুরোধ

   curl -s 'https://email-spam-tester.com/api/v1/infra/check?domain=example.com&selector=mail&diff=true'

2. ফলাফল পড়ুন

   ok হলো একটি স্ক্রিপ্টের জন্য উত্তর, এবং sections দেখায় কোন অংশটি ব্যর্থ হয়েছে।

   প্রতিক্রিয়া

   {
     "id": "ir_01JB8Y4T2M6K9QZ7H3V5N1XWDA",
     "domain": "example.com",
     "checked_at": "2026-10-31T12:00:00Z",
     "ok": false,
     "status": "fail",
     "score": 78,
     "coverage": {"answered": 7, "total": 8},
     "ips": [{"ip": "203.0.113.5", "sources": ["mx", "spf"], "managed": false}],
     "sections": {
       "dkim": {"status": "pass", "core": true, "findings": [], "data": {}},
       "ptr": {"status": "fail", "core": true, "findings": [], "data": {}}
     },
     "not_checked": [
       {"check": "dkim_signature", "reason": "needs_a_message"},
       {"check": "alignment", "reason": "needs_a_message"}
     ],
     "diff": {
       "baseline": {"id": "ir_01JB2...", "checked_at": "2026-10-24T12:00:00Z"},
       "first_run": false,
       "changed": true,
       "worsened": true,
       "status_from": "pass",
       "score_from": 100,
       "changes": [
         {"path": "dkim.key.mail.sha256", "section": "dkim", "kind": "removed",
          "severity": "critical", "effect": "worsened", "from": "9f2c...", "to": null}
       ],
       "not_compared": [
         {"path": "blocklist_ip.203.0.113.5.bl.spamcop.net.listed", "reason": "lookup_failed"}
       ]
     }
   }

3. এটি cron-এ রাখুন

   diff=true ব্যবহার করলে প্রতিটি রান আপনার সর্বশেষ রানের সঙ্গে তুলনা করা হয়, এবং jq উত্তরটিকে একটি এক্সিট কোডে রূপান্তর করে।

   অনুরোধ

   # exits non-zero if the domain is broken or its setup changed
   curl -s 'https://email-spam-tester.com/api/v1/infra/check?domain=example.com&selector=mail&diff=true' \
     | jq -e '.ok and (.diff.changed | not)'

উত্তর পড়া

শেষ হওয়া একটি পরীক্ষা 200 দিয়ে উত্তর দেয়, এবং verdict body-তে থাকে। status হলো প্রয়োজনীয় সেকশনগুলোর মধ্যে সবচেয়ে খারাপটি: spf, dkim, dmarc, ptr, blocklist_ip, blocklist_domain, mx এবং smtp। প্রয়োজনীয় কোনো সেকশনে unknown থাকলে তা warn হিসেবে গণ্য হয়। status pass বা warn হলে ok true হয়। উত্তর দেওয়া প্রয়োজনীয় সেকশনগুলোর ওপর score 0 থেকে 100 পর্যন্ত হয়, এবং error ও unknown-এর কারণে প্রযোজ্য weight-এর অর্ধেকের কম অবশিষ্ট থাকলে এটি null হয়। mta_sts, tls_rpt, bimi, dnssec, dane, ns এবং registration রিপোর্ট ও তুলনা করা হয়, কিন্তু এগুলো ok বা score-কে প্রভাবিত করে না।

একটি সেকশন pass, warn, fail, error (আমরা পরীক্ষা করতে পারিনি), unknown (সিদ্ধান্ত নেওয়ার মতো তথ্য খুব কম) বা skipped (প্রযোজ্য নয়) হতে পারে। skipped ফলাফলে কোনো প্রভাব ফেলে না, এবং কারণটি not_checked-এ থাকে। dkim_signature এবং alignment সবসময় থাকে, কারণ এগুলোর জন্য একটি বাস্তব message প্রয়োজন।

ip ও selector কী পরিবর্তন করে

PTR এবং blocklist ঠিকানাসংক্রান্ত, তাই একটি run-এর জন্য কিছু ঠিকানা প্রয়োজন। এটি আপনার দেওয়া ip মানগুলো ব্যবহার করে। কোনোটি না দিলে, এটি আপনার MX host এবং root SPF record-এর একক-ঠিকানার ip4: ও ip6: term থেকে সর্বোচ্চ চারটি নেয়। পরিচিত mail provider-এর ঠিকানাগুলো managed হিসেবে তালিকাভুক্ত হয় এবং পরীক্ষা না করেই রাখা হয়, আর কিছু অবশিষ্ট না থাকলে ptr ও blocklist_ip skipped উত্তর দেয়। DNS থেকে selector পড়া যায় না, তাই একটি run আপনার দেওয়া selector, আপনার আগের run-গুলোতে পাওয়া selector এবং প্রচলিত নামের একটি তালিকা চেষ্টা করে। কিছু না পাওয়া কোনো কিছু প্রমাণ করে না, এবং dkim unknown উত্তর দেয়। আপনি নিজের server থেকে পাঠালে, দুটিই দিন।

কী পরিবর্তিত হয়েছে

diff.changes-এর প্রতিটি এন্ট্রিতে একটি path, একটি kind (added, removed, changed), একটি severity (critical, warning, info) এবং একটি effect (worsened, improved, neutral) থাকে। শুধু critical এবং warning diff.changed সেট করে, তাই একই দৈর্ঘ্যের একটি পরিবর্তিত DKIM কী, একটি নতুন MX ঠিকানা অথবা একটি নবায়ন করা সার্টিফিকেট cron লাইনকে ব্যর্থ করে না। যেকোনো পরিবর্তনের effect অনুযায়ী diff.worsened নির্ধারিত হয়। প্রথম রানে তুলনা করার মতো কিছু থাকে না, এবং diff.first_run তা জানায়।

একটি baseline সবসময় আপনার নিজের একটি run, তাই আপনার দুটি run-এর মাঝখানে অন্য কেউ domain পরীক্ষা করলেও কিছু আড়াল হয় না। এবার আমরা যা পড়তে পারিনি, তার সর্বশেষ জানা মান রেখে সেটি diff.not_compared-এ যায়, যার অর্থ outage-এর সময় করা কোনো পরিবর্তন lookup আবার কাজ করলে দেখা যায়। ভিন্ন ip বা selector-সহ একটি run একই series-এ থাকে, এবং সেটি যা সম্পর্কে জানতে চায়নি সেটিও তুলনা করা হয় না।

নির্ধারিত পরীক্ষায় কেন key ব্যবহার করা উচিত

key ছাড়া আপনার history আপনার IP address-এর keyed hash-এর অধীনে থাকে, তাই address পরিবর্তিত হলে সেটি শেষ হয়ে যায়, এবং একই address-এর পেছনের লোকেরা এটি ভাগ করে: কোনো সহকর্মীর run আপনার baseline সরিয়ে দেয়। Authorization: Bearer-এ personal API key দিলে history key-টিকে অনুসরণ করে। key-সহ run 365 দিন রাখা হয় এবং শুধু সেই key দিয়েই খোলা যায়। key ছাড়া run 30 দিন রাখা হয় এবং যার কাছে সেগুলোর id আছে সে-ই খুলতে পারে।

প্রতি IP-তে মিনিটে 6টি এবং দিনে 50টি request, অথবা প্রতি key-তে 30টি এবং 500টি। এর বেশি হলে Retry-After-সহ উত্তর 429 হয়। 60 সেকেন্ডের মধ্যে একই request cache থেকে আসে, cached: true হিসেবে চিহ্নিত হয়, কোনো run লেখে না এবং গণনায় ধরা হয় না। সংরক্ষিত run পড়ার ক্ষেত্রে প্রতি client-কে মিনিটে 120টি request করার অনুমতি দেওয়া হয়। Retry-After-সহ 503-এর অর্থ অনেক বেশি পরীক্ষা চলছে, অথবা সংরক্ষিত run পড়ার সময় storage unavailable। 401-এর অর্থ ভুল key। 422-এ detail.code থাকে: invalid_domain, invalid_ip, invalid_selector, invalid_check, invalid_since, unknown_baseline অথবা account_required।

এন্ডপয়েন্ট

দ্রুত শুরু

1. একটি পরীক্ষা বেছে নিন

   নিচের তালিকা থেকে টুলটি বেছে নিন এবং সেটি যে ডোমেইন, ঠিকানা বা IP চায় তা দিন।

   অনুরোধ

   curl -s 'https://email-spam-tester.com/api/v1/tools/spf?domain=example.com'

2. স্ট্যাটাস ও ফলাফল পড়ুন

   প্রতিটি টুল একটি স্ট্যাটাস ও তার ফলাফল দেয়। এর পরের ফিল্ডগুলো টুলের ওপর নির্ভর করে।

   প্রতিক্রিয়া

   {
     "tool": "spf",
     "query": {"domain": "example.com"},
     "checked_at": "2026-10-31T12:00:00Z",
     "duration_ms": 412,
     "status": "fail",
     "findings": [
       {"code": "spf.too_many_lookups", "level": "fail",
        "params": {"limit": 10, "count": 12},
        "message": "RFC 7208 §4.6.4 allows at most 10 DNS lookups, and this record needs 12, so receivers return permerror."}
     ],
     "record": "v=spf1 include:_spf.example.net ~all",
     "lookups": {"count": 12, "limit": 10, "void": 0}
   }

এন্ডপয়েন্ট