Migrating from 0.7 to 0.10 (beta)

v0.10 is currently still in beta phase.

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 (v0.10).

• /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 (v0.10), 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	If set, bug reports will be sent to this 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.