Быстрый старт

Что вам понадобится

API-ключ — запросите у администратора Taimly (подробнее)
Возможность отправить email с вашего домена/сервиса

Запуск проверки

Шаг 1: Создайте проверку

curl -X POST https://taimly.net/api/spam-check/start \
  -H "Authorization: Bearer YOUR_API_KEY"

import requests

API_KEY = "YOUR_API_KEY"
BASE_URL = "https://taimly.net"

response = requests.post(
    f"{BASE_URL}/api/spam-check/start",
    headers={"Authorization": f"Bearer {API_KEY}"}
)

data = response.json()
check_id = data["check_id"]
accounts = data["accounts"]

print(f"Check ID: {check_id}")
print(f"Отправьте письмо на: {', '.join(accounts)}")

const API_KEY = "YOUR_API_KEY";
const BASE_URL = "https://taimly.net";

const response = await fetch(`${BASE_URL}/api/spam-check/start`, {
  method: "POST",
  headers: { "Authorization": `Bearer ${API_KEY}` }
});

const { check_id, accounts } = await response.json();

console.log(`Check ID: ${check_id}`);
console.log(`Отправьте письмо на: ${accounts.join(", ")}`);

Ответ:

{
  "check_id": "a1b2c3d4e5f6",
  "accounts": [
    "inbox1+tc_a1b2c3d4e5f6@gmail.com",
    "inbox2+tc_a1b2c3d4e5f6@gmail.com",
    "inbox3+tc_a1b2c3d4e5f6@gmail.com"
  ]
}

Проверка на конкретных почтах

По умолчанию проверка идёт по всем доступным почтам. Чтобы проверить письмо только на некоторых, передайте их в поле accounts — одной строкой или списком:

curl -X POST https://taimly.net/api/spam-check/start \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"accounts": "inbox1@gmail.com"}'

{
  "check_id": "a1b2c3d4e5f6",
  "accounts": ["inbox1+tc_a1b2c3d4e5f6@gmail.com"]
}

Результаты такой проверки содержат только выбранные почты, total равен их числу. Если почты нет среди доступных вашему ключу, вернётся ошибка 404.

Шаг 2: Отправьте тестовое письмо

Отправьте одно письмо на все адреса из массива accounts. Добавьте их в поле To или BCC.

Не изменяйте адреса — теги +tc_... привязывают письмо к проверке. Без тега система не сможет определить результат.

Шаг 3: Получите результаты

Опрашивайте эндпоинт результатов каждые 5–15 секунд:

curl https://taimly.net/api/spam-check/a1b2c3d4e5f6 \
  -H "Authorization: Bearer YOUR_API_KEY"

import time

while True:
    response = requests.get(
        f"{BASE_URL}/api/spam-check/{check_id}",
        headers={"Authorization": f"Bearer {API_KEY}"}
    )
    result = response.json()

    if result["status"] != "pending":
        break

    print(f"Ожидание... ({result['received']}/{result['total']})")
    time.sleep(10)

print(f"Статус: {result['status']}")
for r in result["results"]:
    print(f"  {r['email']}: {r['category']}")

const poll = async () => {
  while (true) {
    const res = await fetch(`${BASE_URL}/api/spam-check/${check_id}`, {
      headers: { "Authorization": `Bearer ${API_KEY}` }
    });
    const result = await res.json();

    if (result.status !== "pending") {
      return result;
    }

    console.log(`Ожидание... (${result.received}/${result.total})`);
    await new Promise(r => setTimeout(r, 10000));
  }
};

const result = await poll();

console.log(`Статус: ${result.status}`);
result.results.forEach(r => {
  console.log(`  ${r.email}: ${r.category}`);
});

Ответ после завершения:

{
  "check_id": "a1b2c3d4e5f6",
  "status": "complete",
  "received": 3,
  "total": 3,
  "results": [
    { "email": "inbox1@gmail.com", "category": "primary" },
    { "email": "inbox2@gmail.com", "category": "primary" },
    { "email": "inbox3@gmail.com", "category": "promotions" }
  ]
}

Шаг 4 (по желанию): данные письма

Добавьте параметр fields, чтобы получить отправителя, тему, SMTP, SPF/DKIM/DMARC, IP, PTR, тело или оригинал письма:

curl "https://taimly.net/api/spam-check/a1b2c3d4e5f6?fields=smtp,spf,dkim,dmarc,sender_ip,ptr,ip_type" \
  -H "Authorization: Bearer YOUR_API_KEY"

Все поля и советы по большим ответам — в разделе Данные письма.

Полный пример

import requests
import time

API_KEY = "YOUR_API_KEY"
BASE_URL = "https://taimly.net"
HEADERS = {"Authorization": f"Bearer {API_KEY}"}

start = requests.post(f"{BASE_URL}/api/spam-check/start", headers=HEADERS)
start.raise_for_status()
data = start.json()

check_id = data["check_id"]
print(f"Check ID: {check_id}")
print(f"Отправьте письмо на:")
for addr in data["accounts"]:
    print(f"  {addr}")

input("\nНажмите Enter после отправки письма...")

while True:
    result = requests.get(
        f"{BASE_URL}/api/spam-check/{check_id}",
        headers=HEADERS
    ).json()

    if result["status"] != "pending":
        break

    print(f"Ожидание... ({result['received']}/{result['total']})")
    time.sleep(10)

print(f"\nРезультат: {result['status']}")

inbox_count = 0
total = len(result["results"])

for r in result["results"]:
    cat = r["category"]
    is_inbox = cat in ("primary", "updates")
    inbox_count += int(is_inbox)

    icon = "✅" if is_inbox else "❌" if cat == "spam" else "⚠️"
    print(f"  {icon} {r['email']}: {cat}")

print(f"\nInbox Rate: {inbox_count}/{total} ({inbox_count/total*100:.0f}%)")

Важные ограничения

Если за 5 минут письмо пришло не на все адреса, статус становится timeout (результаты при этом остаются доступны)
Проверка и данные писем доступны 30 минут после старта
Отправляйте письмо сразу после получения адресов — чем быстрее, тем точнее результат

Начало работы

Справочник

Временные почты

Быстрый старт

Что вам понадобится

Запуск проверки

Шаг 1: Создайте проверку

Проверка на конкретных почтах

Шаг 2: Отправьте тестовое письмо

Шаг 3: Получите результаты

Шаг 4 (по желанию): данные письма

Полный пример

Важные ограничения

​Что вам понадобится

​Запуск проверки

​Шаг 1: Создайте проверку

​Проверка на конкретных почтах

​Шаг 2: Отправьте тестовое письмо

​Шаг 3: Получите результаты

​Шаг 4 (по желанию): данные письма

​Полный пример

​Важные ограничения

Что вам понадобится

Запуск проверки

Шаг 1: Создайте проверку

Проверка на конкретных почтах

Шаг 2: Отправьте тестовое письмо

Шаг 3: Получите результаты

Шаг 4 (по желанию): данные письма

Полный пример

Важные ограничения