Το API

Δοκιμάστε το στο sandbox → Κάθε endpoint, με ένα κουμπί που το εκτελεί στην ενεργή υπηρεσία. Τίποτα εδώ δεν χρειάζεται κλειδί, επομένως ένα αίτημα που στέλνετε από αυτή τη σελίδα είναι πραγματικό: δεσμεύει μια πραγματική διεύθυνση και προσμετράται.

Ο κύκλος

Δύο αιτήματα και ένα email. Η τρίτη κλήση υπάρχει μόνο επειδή η ανάλυση διαρκεί λίγα δευτερόλεπτα.

1. Δεσμεύστε μια διεύθυνση

   Στείλτε POST στο endpoint του inbox. Λαμβάνετε μια διεύθυνση που δέχεται ακριβώς ένα μήνυμα και λήγει σε μία ώρα, καθώς και το slug που χρησιμοποιείται ως κλειδί για όλα τα υπόλοιπα.

2. Στείλτε σε αυτή το πραγματικό μήνυμα

   Μέσω SMTP, από την πλατφόρμα που θα στείλει την καμπάνια. Οι μισοί έλεγχοι διαβάζουν κεφαλίδες που προσθέτει η πλατφόρμα αποστολής σας, επομένως ένα μήνυμα που συντάχθηκε χειροκίνητα μετρά το λάθος πράγμα.

3. Ελέγξτε περιοδικά την κατάσταση και μετά διαβάστε την αναφορά

   Το endpoint κατάστασης έχει μέγεθος μερικών εκατοντάδων byte και σας ενημερώνει αν αξίζει να ανακτηθεί ήδη η πλήρης αναφορά. Η ίδια η αναφορά εκτείνεται σε αρκετές χιλιάδες γραμμές.

# 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. send your message to that address, then poll
curl -s 'https://email-spam-tester.com/api/v1/tests/<slug>/status'

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

# 3. 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"}}
  ]
}

Έλεγχος ταυτότητας

Δεν υπάρχει. Δεν χρειάζεται να ζητήσετε κλειδί, να ορίσετε κεφαλίδα ή να δημιουργήσετε λογαριασμό. Το slug που λαμβάνετε είναι η δυνατότητα πρόσβασης: όποιος το κατέχει μπορεί να διαβάσει αυτή την αναφορά και κανείς άλλος δεν μπορεί να το μαντέψει.

Τελικά σημεία

Βασική διεύθυνση https://email-spam-tester.com. Όλα αποκρίνονται με JSON.

Ανάγνωση της αναφοράς

Τα πεδία που περιέχουν την απάντηση, με τη σειρά που πιθανότατα τα χρειάζεστε.

Καταστάσεις

Ένας έλεγχος βρίσκεται σε μία από πέντε καταστάσεις, και η διαφορά μεταξύ δύο από αυτές έχει μεγαλύτερη σημασία από όσο φαίνεται.

Το analysis_status περνά από received, analyzing, checks_ready, failed. Το ai_status περνά από pending, running, ready, fallback, error. Η ντετερμινιστική αναφορά είναι οριστική στο checks_ready· το ai_status προσθέτει μόνο το πλάνο.

Τι μπορεί να επιστραφεί

Τέσσερα πράγματα που αξίζει να γνωρίζετε

Για συστήματα

• /api/openapi.json Η περιγραφή OpenAPI, η οποία δημιουργείται από τον ίδιο κώδικα που εξυπηρετεί το API.
• /llms.txt, /llms-full.txt Ένας σύντομος χάρτης αυτού του ιστότοπου για γλωσσικά μοντέλα, σύμφωνα με τη σύμβαση llms.txt, και μια εκτενέστερη έκδοση με ολόκληρο τον κύκλο και τα πεδία της αναφοράς σε ένα αρχείο.
• /mcp Ένας διακομιστής MCP με την ίδια δυνατότητα και αναμονή με αποκλεισμό, η οποία είναι καλύτερη από την περιοδική υποβολή ερωτημάτων μέσα από ένα μοντέλο.
• For agents Η σελίδα για πράκτορες: πότε να χρησιμοποιήσετε αυτό το εργαλείο, πώς να διακρίνετε έναν έλεγχο που παραλείφθηκε από έναν επιτυχημένο και ποια ευρήματα είναι εγγραφές DNS που πρέπει να αλλάξει κάποιος αντί για κείμενο που μπορεί να επεξεργαστεί ένας πράκτορας.