GET API USAGE (V2)

GET /V2/GETAPIUSAGE

URL DE API POR DEFECTO: https://api.zerobounce.net/v2/getapiusage
URL de API de U.S.A.*: https://api-us.zerobounce.net/v2/getapiusage

*Este punto final utiliza servidores ubicados en los Estados Unidos. Al utilizar este punto final, reconoces y consientes que tus datos serán procesados en servidores en los Estados Unidos.

Parámetros URL

Parámetro
Descripción
api_key
Su clave API, que se encuentra en su cuenta.
start_date
La fecha de inicio en la que desea ver el uso de la API. (formato: aaaa - mm - dd)
end_date
La fecha de finalización en la que desea ver el uso de la API. (formato: aaaa - mm - dd)

https://api.zerobounce.net/v2/getapiusage?api_key=your-api-key&start_date=2018-01-01&end_date=2019-12-12

https://api-us.zerobounce.net/v2/getapiusage?api_key=your-api-key&start_date=2018-01-01&end_date=2019-12-12

La API devolverá estos resultados en formato JSON utilizando el método "getapiusage".

Parámetro
Descripción
total
Número total de veces que se ha llamado a la API
status_valid
Total de direcciones de correo electrónico válidas devueltas por la API
status_invalid
Total de direcciones de correo electrónico inválidas devueltas por la API
status_catch_all
Total de direcciones de correo electrónico atrapatodo devueltas por la API
status_do_not_mail
Total de direcciones de correo electrónico donotmail devueltas por la API
status_spamtrap
Total de direcciones de correo electrónico trampas de spam devueltas por la API
status_unknown
Total de direcciones de correo electrónico desconocidas devueltas por la API
sub_status_toxic
Número total de veces que la API tiene un subestado de "tóxico"
sub_status_disposable
Número total de veces que la API tiene un subestado de "desechable"
sub_status_role_based
Número total de veces que la API tiene un subestado de "role_based"
sub_status_possible_trap
Número total de veces que la API tiene un subestado de "possible_trap"
sub_status_global_suppression
Númerototal de veces que la API tiene un subestado de "global_suppression"
sub_status_timeout_exceeded
Número total de veces que la API tiene un subestado de "timeout_exceeded"
sub_status_mail_server_temporary_error
Número total de veces que la API tiene un subestado de "mail _server_temporary_error"
sub_status_mail_server_did_not_respond
Número total de veces que la API tiene un subestado de "mail_server_din_not_respond"
sub_status_greylisted
Número total de veces que la API tiene un subestado de "greylisted"
sub_status_antispam_system
Número total de veces que la API tiene un subestado de "antispam_system"
sub_status_does_not_accept_mail
Número total de veces que la API tiene un subestado de "does_not_accept_mail"
sub_status_exception_occurred
Número total de veces que la API tiene un subestado de "exception_occurred"
sub_status_failed_syntax_check
Número total de veces que la API tiene un subestado de "failed_syntax_check"
sub_status_mailbox_not_found
Número total de veces que la API tiene un subestado de " mailbox_not_found"
sub_status_unroutable_ip_address
Número total de veces que la API tiene un subestado de " unroutable_ip_address"
sub_status_possible_typo
Número total de veces que la API tiene un subestado de " possible_typo"
sub_status_no_dns_entries
Número total de veces que la API tiene un subestado de " no_dns_entries"
sub_status_role_based_catch_all
Número total de correos atrapatodo basados en roles en que la API tiene un subestado de "role_based_catch_all"
sub_status_mailbox_quota_exceeded
Número total de veces que la API tiene un subestado de "mailbox_quota_exceeded"
sub_status_forcible_disconnect
Desconexiones forzadas totales en que la API tiene un subestado "forcible_disconnect"
sub_status_failed_smtp_connection
Total de conexiones SMTP fallidas en que la API tiene un subestado de "failed_smtp_connection"
sub_status_mx_forward
Número total de veces que la API tiene un subestado "mx_forward"
start_date
Fecha de inicio de la consulta. (formato: aaaa / mm / dd)
end_date
Fecha de finalización de la consulta. (formato: aaaa / mm / dd)

OBTENER MUESTRAS DE CÓDIGO GET API USAGE

RESPUESTA DE PUNTO FINAL

Respuesta exitosa

 {
      "total": 120,
      "status_valid": 17,
      "status_invalid": 69,
      "status_catch_all": 9,
      "status_do_not_mail": 16,
      "status_spamtrap": 0,
      "status_unknown": 6,
      "sub_status_toxic": 0,
      "sub_status_disposable": 1,
      "sub_status_role_based": 1,
      "sub_status_possible_trap": 0,
      "sub_status_global_suppression": 14,
      "sub_status_timeout_exceeded": 0,
      "sub_status_mail_server_temporary_error": 0,
      "sub_status_mail_server_did_not_respond": 0,
      "sub_status_greylisted": 6,
      "sub_status_antispam_system": 0,
      "sub_status_does_not_accept_mail": 27,
      "sub_status_exception_occurred": 0,
      "sub_status_failed_syntax_check": 20,
      "sub_status_mailbox_not_found": 12,
      "sub_status_unroutable_ip_address": 0,
      "sub_status_possible_typo": 0,
      "sub_status_no_dns_entries": 10,
      "sub_status_role_based_catch_all": 0,
      "sub_status_mailbox_quota_exceeded": 0,
      "sub_status_forcible_disconnect": 0,
      "sub_status_failed_smtp_connection": 0,
      "sub_status_leading_period_removed": 0,
      "sub_status_alias_address": 2,
      "sub_status_mx_forward": 0,
      "sub_status_alternate": 0,
      "sub_status_blocked": 0,
      "sub_status_allowed": 0,
      "start_date": "1/1/2023",
      "end_date": "1/30/2024"
    }

Respuesta de error - clave de API


    {"error":"Invalid API Key"}

Respuesta de error - Fecha


    {"error":"Invalid Date"}

GetApiUsage V2 Límites

Las solicitudes incorrectas a https://api.zerobounce.net/v2/getapiusage y https://api-us.zerobounce.net/v2/getapiusage 200 veces en 1 hora resultarán en un bloqueo temporal de 1 hora.

*Este punto final utiliza servidores ubicados en los Estados Unidos. Al utilizar este punto final, reconoces y consientes que tus datos serán procesados en servidores en los Estados Unidos.