PANEL DE API

CÓDIGOS DE ERROR DE LA API

Entendemos que las cosas no siempre salen bien al hacer tu primera llamada a la API, especialmente si es la primera vez que integras con nuestra API. Veamos los códigos de estado más comunes que indican una respuesta de error, junto con una breve explicación:

Ten en cuenta: en junio de 2023, ZeroBounce añadió una medida de seguridad llamada API Shield. El API Shield es una función de seguridad dinámica que puede activarse y desactivarse a lo largo del día según los patrones de tráfico, ataques en curso, mantenimiento y otros factores. Si el API Shield está activado, es posible que a veces recibas una respuesta 403 Prohibido, mientras que cuando está desactivado, se mostrarán los códigos de error de la API que aparecen a continuación. Por favor, considera todos estos códigos de error como excepciones.

429 - Demasiadas solicitudes. Cuando ocurre este error, se recomienda limitar la frecuencia de las solicitudes, ya que has alcanzado el límite de tasa. Consulta también la sección Límite de tasa de la API en la documentación.

400 - Solicitud incorrecta. En la mayoría de los casos, esto indica que hay un error en tu solicitud a la API; por favor, revisa nuevamente la documentación.

404 - No encontrado. Es el código de error más común; simplemente significa que el endpoint al que intentas acceder no existe en el servidor de la API. Lo mejor será comprobar si hay errores tipográficos o revisar la documentación.

405 - Método no permitido. Esto indica que estás intentando acceder a un recurso HTTP utilizando un método REST no compatible (por ejemplo, estás intentando hacer un GET en un endpoint que solo admite POST). Por favor, revisa la documentación.

500 - Error interno del servidor. Aunque es poco probable, este error indica un problema en la plataforma y deberás contactar con el soporte técnico.

520 o 524 - Error desconocido inesperado. Aunque poco probable, esto sugiere un error de transporte que puede ocurrir por varias razones. Supervisamos y abordamos constantemente cualquier incidencia 520/524 con nuestros proveedores de tránsito, y estamos disponibles para asistirte. Por favor, inténtalo de nuevo lo antes posible o contacta con nuestro equipo de soporte para obtener más información.

¿POR QUÉ SOLO ADMITIMOS TLS 1.2 Y SUPERIOR?

El Consejo de Seguridad de la PCI establece las reglas sobre qué tecnologías son aceptables para su uso en la transmisión de datos de titulares de tarjetas. Han identificado explícitamente que TLS 1.0 ya no es una forma sólida de cifrado porque es vulnerable a muchos ataques conocidos.

Casi todos los sitios web han dejado de admitir TLS 1.0 y 1.1, esto se hace para ayudar a proteger su información.

¿ESTÁ AFECTADO?

Si no usa nuestras API, es poco probable que se vea afectado a menos que esté usando un navegador o sistema operativo realmente antiguo. Para verificar si su ordenador/navegador es compatible con TLS 1.2 o superior, por favor visite este enlace: https://www.ssllabs.com/ssltest/viewMyClient.html

SOPORTE DE BIBLIOTECA API

Si tiene un código que se conecta con la API de ZeroBounce, debe asegurarse de que seguirá funcionando después del 1 de junio de 2018. Cada lenguaje y biblioteca es diferente, a continuación se muestran los lenguajes más populares.

ESTOS LENGUAJES NECESITARÁN CAMBIOS/ACTUALIZACIONES IMPORTANTES PARA FUNCIONAR:

• Java 6u45 / 7u45

• .NET antes de 4.5 (no es compatible con TLS 1.2)

• .NET 4.5 (requiere cambios de configuración para habilitar explícitamente TLS 1.2)

• OpenSSL 0.9.8

• La mayoría de los lenguajes dinámicos como Ruby, PHP y Python se basan en la versión OpenSSL del sistema operativo subyacente. Puede comprobarlo ejecutando la versión OpenSSL. 1.0.1 en el mínimo requerido.

• PHP 5.5.19 y versiones posteriores son compatibles con TLS 1.2

Puede probar su conexión con varias herramientas y documentación que se encuentran en Internet. Por favor, tenga en cuenta que no somos expertos en todos los lenguajes o marcos, por lo que no podemos probar ni corregir su código.

INSTRUCCIONES ESPECÍFICAS DEL LENGUAJE

• NET 4.6: TLS 1.2 se utiliza automáticamente. No son necesarios cambios.

• .NET 4.5: SecurityProtocolType debe cambiarse a Tls12 (utilizando SecurityProtocol Setter)

• .NET 4.0: Se admite TLS 1.2, pero no hay una enumeración denominada SecurityProtocolType. Utilice (SecurityProtocolType)3072.

• .NET 3 y versiones anteriores: debe actualizarse a 4.5

Soporte para las versiones predeterminadas del sistema TLS incluidas en .NET

SOPORTE DEL NAVEGADOR

Los siguientes navegadores NO son compatibles con TLS 1.2 y ya no funcionarán.

• Google Chrome 29

• Firefox 26

• Internet Explorer 10

• Safari 8

• iOS 4

• Android 4

Necesita información detallada sobre el uso de la API de validación de correo electrónico? La encontrará en su panel de API.

El Panel de control de la API se encuentra en su cuenta fuera del menú de la izquierda. Cada vez que realiza una llamada a la API, registrará los resultados de la validación del correo electrónico. De este modo, puede ver rápidamente una visión general de su uso de créditos y sus resultados. No se guardan correos electrónicos, solo un recuento de los resultados.

En el Panel de control de la API, como se ha visto anteriormente, tendrá un menú desplegable con los detalles de los correos inválidos, no enviar y los códigos de estado desconocido. Además, podrá graficar por tendencias diarias o mensuales para obtener una mirada másprofunda en susvalidaciones de correo electrónico. Esto le brinda una mejor perspectiva de cómo ZeroBounce ha ayudado a mejorar su lista de correo electrónico.

En la imagen de arriba, hice clic en el estado que no quería mostrar, dejando solo la tendencia de los inválidos. Para obtener más detalles sobre los resultados inválidos, cambie el menú en la parte superior a "Inválidos por Sub_Status".

Ahora puede ver el desglose de sub_status de los correos electrónicos "Inválidos". Es una herramienta muy poderosa que le permite ver un resumen de uso por día, meses e incluso años, con una representación visual de la salud de los correos electrónicos que está pasando a través de la API.

La página de claves API es donde puede gestionar el acceso API a su cuenta ZeroBounce. En la página de claves API, puede crear nuevas claves API, así como editar o eliminar claves existentes, excepto la Clave Maestra.

AÑADIR NUEVA CLAVE DE API:

Paso 1:

Para crear una nueva clave API, haga clic en "+ Create a new API Key" en la parte superior derecha de la página.

Paso 2:

Escribe el nombre que deseas darle a la clave y asegúrate de establecer el "active state" de la clave como sí o no. La lista blanca puede configurarse a través del Modo de Edición después de haber creado tu clave.

Después de crear la clave, su nueva clave aparecerá en la lista, como en el ejemplo a continuación.

EDITAR CLAVE:

Paso 1:

Para editar el estado de su clave API, haga clic en el ícono de lápiz ubicado a la derecha (como en el ejemplo a continuación). Solo las direcciones IP de la lista blanca pueden ser editadas para la clave maestra.

Paso 2:

En el modo de edición, podrás cambiar el nombre y el estado activo de tu clave API. También puedes ingresar una dirección IP o un rango de direcciones IP para incluir en la lista blanca. Puedes agregar más de una dirección IP o rango de direcciones IP, y podrás editar o eliminarlas una vez añadidas.

GENERAR NUEVA CLAVE:

Paso 1:

Puede regenerar una nueva clave para reemplazar la actual.

Paso 2:

Haga clic en OK para procesar los cambios o en Cancel para salir.

ELIMINAR UNA CLAVE:

Paso 1:

A excepción de la Clave Maestra, puede eliminar las claves adicionales si ya no se utilizan.

Paso 2:

Haga clic en OK para eliminar la clave seleccionada o en Cancel para salir.

NOTA:

Si ha alcanzado el número máximo de claves API permitidas especificadas en su cuenta, no podrá agregar otras claves adicionales.

¿Necesita un especialista práctico que integre nuestra API en sus aplicaciones, páginas web, formularios de registro o pantallas de inscripción?

Considere utilizar uno de los proveedores de integración aprobados que se enumeran a continuación para que le ayuden con la configuración técnica y las pruebas. Han sido evaluados y están listos para ayudarle.

La información de contacto incluye sitio web, correo electrónico y número de teléfono. También se indica el soporte de idiomas ofrecido por cada proveedor.

Nombre de la empresa: LOGIMONK Technologies

Contacto: Logimonk

Correo electrónico: contact@logimonk.com

Sitio web: https://www.logimonk.com/

Teléfono: +91 9425 807 843

Tecnologías compatibles: Todas

Idiomas: Inglés, hindi

"En LOGIMONK tratamos cada proyecto como un desafío, y nos esforzamos por dar lo mejor para superarlo. Llevamos bastante tiempo en la industria para comprender la diferencia entre entrega y perfección, y valoramos esta última."

Contacto: Catalin Chivulescu

Correo electrónico: catalin.chivulescu@nxthost.com

Sitio web: https://www.nxthost.com/

Idiomas: Inglés, rumano

"Nuestro departamento de soporte altamente capacitado satisfará sus exigentes requerimientos en cualquier momento."

Contacto: Quixtec

Correo electrónico: contactus@quixtec.com

Sitio web: https://www.quixtec.com/

Teléfono: (425) 267-9025

Tecnologías compatibles: Haga clic aquí para ver las tecnologías compatibles

Idiomas: Inglés, español, alemán, hindi

"Nuestro objetivo es proporcionar a todos nuestros clientes, ya sea que sean una startup nueva o una potencia global, todos los recursos y la experiencia necesarios para entregar un proyecto increíble."

¿Necesita más ayuda para integrar nuestra API de validación de correo electrónico en su plataforma? Nuestros especialistas de Atención al Cliente están disponibles 24/7 para ayudarle. Pueden guiarle y responder cualquier pregunta para ayudarle a sacar el máximo partido a la API de ZeroBounce. Por favor, contáctenos en el chat en vivo, llámenos o envíe un correo electrónico a support@zerobounce.net.