.RED

Puede encontrar el ZeroBounce .NET API Wrapper en nuestro GitHub - repositorio de API .NET .

También puede consumirlo y mantenerlo actualizado fácilmente dentro de su proyecto de Visual Studio con Nuget Package Manager: https://www.nuget.org/packages/ZeroBounceAPIWrapper/

Esta clase de envoltura elimina todo el trabajo de codificación contra la API y le permite establecer fácilmente propiedades y obtener resultados al instante.

.NET API Wrapper toma estos parámetros de entrada.

Parámetros de entrada de API .NET

  • PROPIEDAD
    Valores posibles
  • Clave API
    La clave de API ubicada en el panel de su cuenta.
  • emailtovalidate
    La dirección de correo electrónico que está validando.
  • Dirección IP
    [opcional]: la dirección IP de la que se capturó la dirección de correo electrónico
  • pide tiempo fuera
    Configuración de tiempo de espera en milisegundos, configurar esto le permite controlar cuánto tiempo está dispuesto a esperar para enviar la solicitud a la API. Cuando se agota el tiempo de espera, se devuelve un resultado "Desconocido".
  • tiempo de lectura
    La configuración de tiempo de espera en milisegundos, que le permite controlar cuánto tiempo está dispuesto a esperar a que la API responda a su solicitud. Cuando se agota el tiempo de espera, se devuelve un resultado "Desconocido".

Los Validar correo electrónico y Obtener credito Los métodos devuelven objetos de los que puede recuperar fácilmente las propiedades de las propiedades a continuación.

Propiedades y posibles valores devueltos por los métodos:

Método validateemail

  • PROPIEDAD
    Valores
  • habla a
    La dirección de correo electrónico que está validando.
  • estado
    Válido
    inválido
    Atrapar todo
    desconocido
    trampa de spam
    abuso
    Donotmail
  • subestado
    sistema antispam
    en la lista gris
    mail_server_temporary_error
    desconexión forzada
    mail_server_did_not_respond
    timeout_exceeded
    failure_smtp_connection
    ha superado la cuota de buzón
    ocurrió una excepción
    trampas posibles
    basado en roles
    global_suppression
    buzón_no_encontrado
    no_dns_entries
    fail_syntax_check
    possible_typo
    unroutable_ip_address
    leading_period_removed
    does_not_accept_mail
    dirección_alias
  • cuenta
    La parte de la dirección de correo electrónico antes del símbolo "@".
  • Dominio
    La parte de la dirección de correo electrónico despus del símbolo "@".
  • desechable
    [verdadero / falso] Si el dominio de correo electrónico es desechable, que generalmente son direcciones de correo electrónico temporales.
  • tóxico
    [verdadero / falso] Se sabe que estas direcciones de correo electrónico son abuso, spam o bot creado.
  • nombre de pila
    El primer nombre del propietario del correo electrónico cuando esté disponible o [nulo].
  • apellido
    El apellido del propietario del correo electrónico cuando esté disponible o [nulo].
  • género
    El género del propietario del correo electrónico cuando está disponible o [nulo].
  • fecha de creación
    La fecha de creación o [nulo].
  • ubicación
    La ubicación del propietario del correo electrónico cuando está disponible o [nulo].
  • Procesado en
    La hora UTC en que se validó el correo electrónico.

Estas propiedades adicionales están disponibles cuando configura la propiedad ipAddress.

  • PROPIEDAD
    Valores posibles
  • país
    El país de donde proviene la dirección IP
  • región
    El estado / región de donde proviene la dirección IP
  • ciudad
    La ciudad de donde es la dirección IP
  • código postal
    El código postal de donde proviene la dirección IP

Método GetCredit

  • PROPIEDAD
    Valores posibles
  • créditos
    El número de créditos restantes en la cuenta para la validación del correo electrónico.

Visual básico

      
  Oscuro zeroBounceAPI = NUEVO ZeroBounce.ZeroBounceAPI

  'establecer parámetros de entrada
  zeroBounceAPI.apiKey = "Su clave API" 'Necesario 
  zeroBounceAPI.emailToValidate = "Dirección de correo electrónico su validación" 'Necesario
  zeroBounceAPI.ipAddress = "Dirección IP con la que se registró el correo electrónico" 'Opcional
  
  "Dependiendo de cómo use la API, es posible que desee que se agote el tiempo más rápido,
  'por ejemplo en una pantalla de registro. 
  'Normalmente, la API devolverá resultados muy rápido, pero un pequeño porcentaje de
  'los servidores de correo tardan más de 20 + segundos en responder. 
  'Si la API agota el tiempo de espera, devolverá un estado de "Desconocido" y 
  'un sub_estado de "timeout_exceeded" 
  
  zeroBounceAPI.readTimeOut = 200000 'Cualquier valor entero en milisegundos
  zeroBounceAPI.requestTimeOut = 150000 'Cualquier valor entero en milisegundos
  
  Oscuro apiProperties = zeroBounceAPI.ValidateEmail
  Oscuro apiCredits = zeroBounceAPI.GetCredits
  
  'use las propiedades para tomar decisiones sobre
  Seleccione el caso (apiProperties.estado)
      caso "inválido"
          Console.WriteLine("inválido")
      caso "válido"
          Console.WriteLine("válido")
      caso más
          Console.WriteLine(apiProperties.estado)
  Fin Seleccionar

c#


  var zeroBounceAPI = NUEVO Cero rebote.Zerobounceapi();

  // establecer parámetros de entrada
  zeroBounceAPI.apiKey = "Su clave API"; //necesario
  zeroBounceAPI.emailToValidate = "Dirección de correo electrónico su validación"; //necesario
  zeroBounceAPI.ipAddress = "Dirección IP con la que se registró el correo electrónico"; //Opcional
  
  // Dependiendo de cómo use la API, es posible que desee que se agote el tiempo más rápido,
  // por ejemplo en una pantalla de registro. 
  // Normalmente, la API devolverá resultados muy rápido, pero un pequeño porcentaje de
  // los servidores de correo tardan más de 20 + segundos en responder. 
  // Si la API agota el tiempo de espera, devolverá un estado de "Desconocido" y 
  // un sub_estado de "timeout_exceeded"  
  
  zeroBounceAPI.readTimeOut = 200000; // Opcional: cualquier valor entero en milisegundos
  zeroBounceAPI.requestTimeOut = 150000; // Opcional: cualquier valor entero en milisegundos
  
  // validar correo electrónico y asignar resultados a un objeto
  var apiProperties = zeroBounceAPI.validar correo electrónico();
  
  // verifica créditos y asigna resultados a un objeto
  var apiCredits= zeroBounceAPI.obtener créditos();
  
  // usa las propiedades para tomar decisiones sobre
  cambiar (apiProperties.status)
    {
        caso "inválido":
            Console.Línea de escritura("inválido");
            rotura;
        caso "válido":
            Console.Línea de escritura("válido");
            rotura;
        defecto:
            Console.Línea de escritura(apiProperties.status);
            rotura;
    }