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.
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