Migrating from 0.7 to 0.10

Reacher v0.10 introduces the /v1/* endpoints, namely:

  • /v1/check_email: Performs a single email verification while respecting the optional throttle and concurrency settings set in Reacher Configuration.

  • /v1/bulk, /v1/bulk/{job_id}, /v1/bulk/{job_id}/results: Create a bulk verification job, and query its progress and status. Docs coming soon.

The /v0/check_email endpoint DOES NOT change, neither in API nor in behavior. More specifically, even if you specify throttle and concurrency settings in the newly introduced Reacher Configuration, they will not be taken into account by the /v0/check_email endpoint, which will perform email verification as soon as it receives the request.

Environment Variables

With the introduction of Reacher Configuration, some of the Environment Variables have changed names.

Old name
New name
Description

RCH_HTTP_HOST

RCH__HTTP_HOST

The host name to bind the HTTP server to.

PORT

RCH__HTTP_PORT

The port to bind the HTTP server to, often populated by the cloud provider.

RCH_SENTRY_DSN

RCH__SENTRY_DSN

RCH_HEADER_SECRET

RCH__HEADER_SECRET

If set, then all HTTP requests must have the x-reacher-secret header set to this value. This is used to protect the backend against public unwanted HTTP requests.

RCH_FROM_EMAIL

RCH__FROM_EMAIL

Email to use in the <MAIL FROM:> SMTP step. Can be overwritten by each API request's from_email field.

RCH_HELLO_NAME

RCH__HELLO_NAME

Name to use in the <EHLO> SMTP step. Can be overwritten by each API request's hello_name field.

RCH_SMTP_TIMEOUT

RCH__SMTP_TIMEOUT

Timeout for each SMTP connection.

RCH_WEBDRIVER_ADDR

RCH__WEBDRIVER_ADDR

Set to a running WebDriver process endpoint (e.g. http://localhost:9515) to use a headless navigator to password recovery pages to check Yahoo and Hotmail/Outlook addresses. We recommend chromedriver as it allows parallel requests.

For Bulk Verification:

RCH_ENABLE_BULK

RCH__WORKER__ENABLE

DATABASE_URL

RCH__WORKER__POSTGRES__DB_URL

[Bulk] Database connection string for storing results and task queue

RCH_DATABASE_MAX_CONNECTIONS

Removed

[Bulk] Connections created for the database pool

RCH_MINIMUM_TASK_CONCURRENCY

Removed

[Bulk] Minimum number of concurrent running tasks below which more tasks are fetched

RCH_MAXIMUM_CONCURRENT_TASK_FETCH

Removed

[Bulk] Maximum number of tasks fetched at once

Bulk Verification

The /v0/bulk endpoints are deprecated, in favor of a RabbitMQ-based queue system. Docs for /v1/bulk endpoints are coming soon.

Last updated