Guía de exclusiones de invitación

La ruta histórica /blacklist/emails se conserva por compatibilidad. Ahora tiene un contrato de cumplimiento deliberadamente restringido: las integraciones pueden consultar exclusiones activas y registrar la oposición expresa de un destinatario. No es una herramienta para elegir quién puede opinar.

Endpoints

Método	Ruta	Uso
GET	/api/2026-04/blacklist/emails	Consultar exclusiones activas, incluidas filas legacy compatibles de email/dominio.
POST	/api/2026-04/blacklist/emails	Registrar la oposición expresa de un destinatario.
DELETE	/api/2026-04/blacklist/emails	Siempre se rechaza con 409; el negocio no puede revocar una oposición.

Registrar la oposición de un destinatario

curl "https://api.revi.io/api/2026-04/blacklist/emails" \
  -X POST \
  -H "Accept: application/json" \
  -H "Content-Type: application/json" \
  -H "X-API-KEY: revi_test_xxxxxxxxx" \
  -d '{"type":"email","value":"buyer@example.com","reason_code":"recipient_optout","attestation":true}'

El email debe pertenecer a un destinatario relacionado con el negocio autenticado y tener un máximo de 50 caracteres. attestation: true confirma que esa persona pidió expresamente no recibir invitaciones. Se acepta un único email exacto por petición. Se rechazan dominios, patrones, arrays, operaciones en bloque y exclusiones basadas en una reclamación, devolución, incidencia o puntuación esperada. Repetir la misma petición válida es idempotente.

Consultar exclusiones

curl "https://api.revi.io/api/2026-04/blacklist/emails?type=email&per_page=25" \
  -H "Accept: application/json" \
  -H "X-API-KEY: revi_test_xxxxxxxxx"

Los filtros admitidos son page, per_page (1–100), type (email o domain) y query. Se omiten las supresiones revocadas. Puede aparecer una fila de dominio procedente del sistema legacy, pero no se pueden crear dominios mediante este endpoint público.

Revocación

DELETE devuelve 409 recipient_optout_revocation_requires_review sin cambiar datos ni reencolar invitaciones. La revocación exige consentimiento renovado documentado del destinatario y revisión de Support.