Errores

Los errores devuelven application/problem+json. Decide por status y code; el texto de title no es un identificador de programa. Conserva requestId, operación y hora, sin registrar secretos ni contenido personal innecesario.

{
  "type": "urn:sendiro:problem:precondition_failed",
  "title": "precondition_failed",
  "status": 412,
  "code": "precondition_failed",
  "requestId": "REQUEST_ID"
}

Corrige la causa

400 invalid_request: revisa cuerpo, tipos, fechas, query y cabeceras. Repetirlo sin cambios no corrige la entrada.
401 unauthenticated: verifica clave y workspace de ruta.
403 forbidden: comprueba permisos y estado de clave e integración. Otros códigos de acceso pueden indicar una capacidad comercial no habilitada.
404 not_found: revisa recurso y superficie permitida; las rutas administrativas no se ofrecen a claves.
409: lee code. Puede ser conflicto de identidad, dependencia, estado o idempotencia.
412 precondition_failed: lee la revisión actual y reconcilia tu edición.
428 precondition_required: añade el If-Match obtenido del recurso.
422: revisa referencias y elegibilidad; por ejemplo recipient_ineligible o email_design_invalid.
423 sending_admission_required: el workspace necesita una solicitud aprobada para ese uso (Marketing o Transaccional). Un owner o administrador puede gestionarla desde Activa tus envíos. Un dominio verificado o un plan activo no sustituyen esta aprobación.
429: diferencia límite de frecuencia y cuota mediante code y, si está presente, quota. Respeta Retry-After cuando se devuelva.
503: un servicio o dato necesario puede estar indisponible; conserva el diagnóstico para el operador.

Reintenta sin duplicar

Si una mutación pierde su respuesta, repite cuerpo, revisión y clave de idempotencia. No generes otra clave para el mismo envío por un timeout. Ante idempotency_conflict, recupera la entrada original o inicia explícitamente otra operación si eso era lo que buscabas.

Un error HTTP al consultar estado no demuestra que el correo fallara. Si la consulta muestra submission_unknown, conserva el ID y solicita reconciliación: reenviar puede duplicar un mensaje ya aceptado por el proveedor.

Los errores de cuota pueden incluir producto, métrica y capacidad en quota. Revisa planes y consumo. Si hay corrupción de datos o referencias inconsistentes, solicita revisión administrativa; no repares contadores ni estados desde el cliente.