Inbox Placement Testby Live Direct Marketing

Elige tu idioma

Iniciar sesión

Conectarse a la bandeja de entrada Verificar

Comience gratis con la API pública o descargue el SDK. No se requiere cuenta ni clave API.

API gratuita: comience sin iniciar sesión

El correo electrónico de su remitente es una entrada técnica para la prueba, no un paso de registro o verificación. Reemplace you@example.com con la dirección desde la que enviará.

Utilice el SDK de JavaScript/Python · Ejecutar en el navegador

1. Crea una prueba gratuita

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}'

La respuesta contiene token, send_to, results_url y expires_at. Guárdalos antes de cerrar tu terminal. Los ejemplos desactivan los correos electrónicos de recordatorios/informes; no solicitan correos electrónicos de inicio de sesión.

2. Envía tu propio correo electrónico

Envía el mensaje que deseas consultar desde esa dirección a través de tu servicio de correo electrónico habitual a TODAS las direcciones en send_to. Crear una prueba no la envía por usted.

3. Lee el resultado

curl https://check.live-direct-marketing.online/api/tests/YOUR_TEST_TOKEN

Reemplace YOUR_TEST_TOKEN con el token del paso 1 o abra results_url. Mientras espera, siga sondeando cada pocos segundos. Inspeccionar resultados, resumen y autenticación: el estado de una terminal por sí solo no prueba la entrega a la bandeja de entrada. Mantenga su token privado; no se necesita ninguna cuenta para leer su informe.

400: arregla la solicitud. 429: espere hasta restablecer en / reintentar después. Una falla de red mientras se crea una prueba tiene un resultado desconocido: no repetir la POST automáticamente. Conserve el token al realizar la encuesta. Un tiempo de espera general incluye el token y la última instantánea para que puedas continuar sin iniciar sesión.

SDK invitado: JavaScript y Python

Descargue el cliente mantenido directamente. Node.js 18+ o Python 3.9+; no se necesita administrador de paquetes, dependencias ni clave API.

SDK de JavaScript (.mjs) · SDK de Python (.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.

pitón

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.

Continúe con el token guardado; no cree otra prueba

Después de enviar el mensaje, ejecute un script independiente utilizando el MISMO token. Al volver a ejecutar el script de creación se crea otra prueba con diferentes direcciones semilla.

// 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 devuelve la primera instantánea del proveedor medida o un resultado de terminal. Puede ser parcial: inspeccione el estado y los resultados, y siga llamando a getTest/get_test con el mismo token hasta que el estado finalice o caduque si necesita el informe final completo. Un tiempo de espera se puede reanudar con ese token.

Estos clientes utilizan /api/tests públicos. Las herramientas remotas para invitados de MCP también funcionan sin clave: utilice las instrucciones de MCP. Todas las opciones de configuración actuales se enumeran en /sdk/integration.json.

Webhooks sin registro: retransmisión SDK local

Su IA puede descargar y configurar este relé en su propio entorno Node.js. Lee un token de prueba GUARDADO, espera la instantánea final realizada/caducada y luego envía un evento check.completed firmado a su receptor. Mantenga el proceso en marcha. Esta no es una suscripción de webhook Check alojada.

Descargar retransmisión de webhook y verificador de firmas
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

Reemplace SAVED_TEST_TOKEN y YOUR_RECEIVER con el token ya creado y su propio receptor HTTPS. Configure escribe un nuevo archivo privado con un secreto de firma aleatorio; se niega a sobrescribir un archivo existente.

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

Configure su receptor con el mismo secreto privado antes de ejecutarlo. Verifique el cuerpo de la solicitud sin formato, X-Inbox-Check-Timestamp y X-Inbox-Check-Signature. La firma es sha256=HMAC-SHA256(secreto, marca de tiempo + "." + rawBody). Rechace marcas de tiempo obsoletas y deduplica 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.

El relé nunca crea una prueba ni envía un correo electrónico de prueba. No vuelve a intentar realizar POST de devolución de llamada ni sigue redirecciones. Si la entrega de la devolución de llamada es incierta, el error incluye eventId: verifique su receptor antes de volver a ejecutarlo. Si el tiempo de sondeo se agota, conserve el token/configuración y reanude la misma prueba. Un resultado caducado sin mensajes recibidos sigue siendo un resultado caducado.

Cuenta opcional, límites más altos e integraciones administradas

Tu clave de conexión

Inicie sesión con un enlace de correo electrónico. Su primer inicio de sesión confirmado crea su cuenta y ingresa automáticamente en Cuenta.

Crea una cuentaIniciar sesiónAbrir cuenta

Básico: por defecto 100 análisis por día y 1.000 por mes, sin capturas de pantalla. Account y me_get muestran límites y uso exactos. Solicita el paquete gratuito 500/5000 en Cuenta; comienza después de la aprobación.

Las nuevas claves se pueden mostrar y copiar nuevamente después de iniciar sesión. Las claves más antiguas aún funcionan, pero no se pueden recuperar: cree un reemplazo, actualice su integración y luego revoque la clave anterior. Mantenga su clave privada.

1. Verifique la conexión

Reemplace YOUR_API_KEY con su clave. GET /api/v1/me muestra los límites de esta clave y las comprobaciones restantes. No consume análisis.

curl https://check.live-direct-marketing.online/api/v1/me \
  -H "Authorization: Bearer YOUR_API_KEY"

2. Crea una prueba

Una prueba creada con éxito utiliza una verificación. Elija los proveedores disponibles para su clave con 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. Envía tu propio correo electrónico

La respuesta contiene direcciones de envío_a y URL_resultados. Envíe su correo electrónico desde su propio servicio de correo a TODAS las direcciones devueltas. Crear una prueba no le envía un correo electrónico.

4. Abra el informe

Abra results_url o lea GET /api/v1/tests/:token. La lectura de los resultados no consume un análisis. Los plazos de entrega varían; un mensaje faltante no es evidencia de una entrega exitosa.

Límites e historia

Basic incluye por defecto 100 análisis al día y 1.000 al mes. Los límites exactos pueden variar: consulte /api/v1/me para la clave actual y Cuenta para todas sus claves. El número de análisis disponibles es el menor de los números restantes del límite diario y del mensual.

Los períodos se reinician a las 00:00 UTC cada día y el primer día del mes. La cuenta muestra reinicios en su hora local. Las solicitudes de API y las solicitudes fallidas se cuentan por separado de las comprobaciones.

El historial de la cuenta mantiene los detalles de la solicitud durante 30 días con filtros y páginas de 20/50 filas. La cobertura comienza en la fecha que allí se muestra; los registros anteriores pueden estar incompletos. Los cuerpos de solicitud, las cookies y los secretos no están incluidos.

Solicite un paquete gratuito más grande

Utilice Solicitar paquete gratuito en Cuenta. Después de la aprobación, los límites de la clave seleccionada pasan a ser 500 por día y 5000 por mes. Esto reemplaza sus límites; no agrega controles ni borra el uso. Hasta la aprobación, los límites actuales se mantienen. La decisión llega por correo electrónico.

Una clave vinculada al usuario con cuenta: lectura puede leer sus propias solicitudes en GET /api/v1/account/promo-requests. El acceso de lectura no permite crear ni aprobar solicitudes; utilice la cuenta iniciada para solicitar un paquete.

Si una solicitud falla

Solo API administrada: 401 significa verificar la clave del portador; 403 significa verificar sus permisos. Para cuota_excedida, verifique ambos límites. Respect429/Reintentar-Después. Para errores del servidor, inspeccione el resultado antes de repetir una POST de creación. Mantenga el requestId cuando se comunique con el soporte, pero nunca envíe su clave.

Referencia e integraciones API completas

API abierta · MCP · A2A

Las nuevas claves predeterminadas incluyen permisos específicos para su propio monitoreo, sin acceso de administrador. Los permisos clave existentes permanecen sin cambios. Las claves restringidas siguen siendo una opción explícita en la configuración de la cuenta.

Referencia avanzada: puntos finales, niveles y código

OpenAPI enumera rutas y esquemas de solicitud disponibles. Algunos esquemas de respuesta no se declaran; Utilice los ejemplos y los campos de respuesta reales. Las llamadas administradas utilizan Autorización: Portador YOUR_API_KEY. El seguimiento de las mutaciones requiere seguimiento:escribir; las lecturas requieren monitoreo: lectura y una clave vinculada al usuario.

GET /api/v1/me
Metadatos clave, funciones, proveedores permitidos, cuotas y tiempos de reinicio de UTC.
GET /api/v1/providers
Proveedores disponibles para esta clave.
POST /api/v1/tests
Crea una prueba. La respuesta 202 contiene token, send_to y results_url.
GET /api/v1/tests
Enumere sus pruebas con cursor y limite la paginación.
GET /api/v1/tests/:token
Lea ubicaciones, autenticación, diagnósticos y URL de capturas de pantalla disponibles.
DELETE /api/v1/tests/:token
Elimina permanentemente tu prueba, resultados y capturas de pantalla.
GET /api/v1/monitoring/domains
Enumere sus dominios monitoreados, compartidos con el sitio web y Telegram.
POST /api/v1/monitoring/domains
Añade tu dominio: {"dominio":"ejemplo.com"}.
POST /api/v1/monitoring/domains/:id/pause
Pausa la supervisión de tu dominio.
POST /api/v1/monitoring/domains/:id/resume
Reanude la supervisión de su dominio.
DELETE /api/v1/monitoring/domains/:id
Elimina tu dominio monitoreado.
GET /api/v1/account/promo-requests
Lea sus propias solicitudes de paquetes gratuitos con cuenta: leer.

Niveles predeterminados

Los operadores pueden anular claves individuales. Utilice siempre los valores API para los límites reales.

Nivelpor diaPor mesCapturas de pantalla
basic1001,000—
pro50010,000Incluido
enterprise5,000100,000Incluido

Nodo/Python

No se requiere ningún SDK independiente. Mantenga la clave en una variable de entorno secreta, nunca en el control de código fuente.

Nodo (buscar)

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 (solicitudes)

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())

Compatibilidad

Los CRUD de prueba v1 existentes, las listas permitidas de proveedores, las funciones de captura de pantalla y las cuotas por clave siguen siendo compatibles. El inicio de sesión de cuenta, las nuevas claves recuperables, el historial de solicitudes y las solicitudes de paquetes gratuitos amplían esta API sin cambiar las claves existentes.