Cloudflare Workers

Welcome to the Cloudflare Workers example documentation for integrating with No550. In this guide, you’ll learn how to use Cloudflare Workers to validate email addresses using the No550 API and perform conditional actions based on the response.

Prerequisites

Before you begin, make sure you have the following prerequisites:

A No550 account
A Cloudflare account with access to Cloudflare Workers.

Create a Cloudflare Worker

First, you need to create a Cloudflare Worker that will handle incoming requests and interact with the No550 API.

To initialise a Worker project you need to run:

$ npx wrangler init

Before we go into the code, we need to setup a secret for the API token. To do this, run the following command:

$ npx wrangler secret put NO550_API_TOKEN

# And then paste in the API token from the dashboard (https://dash.no550.com/account)

Then in the main file, use the following code as a starting point:

JavaScript
TypeScript

export default {
  async fetch(request, env) {
    try {
      // Parse the request body to extract the email address.
      const { email } = await request.json();

      // Make a POST request to the No550 API.
      const no550Response = await fetch('https://api.no550.com/check', {
        method: 'POST',
        body: JSON.stringify({ email }),
        headers: {
          Authorization: env.NO550_API_TOKEN,
          'Content-Type': 'application/json',
        },
      });

      // Handle the response from the No550 API.
      const no550Data = await no550Response.json();

      if (no550Data.success === false) {
        return new Response('An error occurred: ' + no550Data.error, {
          status: 500,
        });
      }

      // Check the email status.
      if (no550Data.data.status === 'invalid') {
        // Email is invalid, block the request.
        return new Response('Email validation failed: Invalid email address', {
          status: 400,
          headers: {
            'Content-Type': 'text/plain',
          },
        });
      } else {
        // Email is valid, proceed with the request as normal.
        return fetch(request);
      }
    } catch (error) {
      return new Response('An error occurred: ' + error.message, {
        status: 500,
      });
    }
  }
}

interface RequestBody {
  email: string;
}

interface CheckResponse {
  success: boolean;
  data?: {
    status: 'valid' | 'invalid';
  };
  error?: string;
}

interface Env {
  NO550_API_TOKEN: string;
}

export default {
  async fetch(request: Request, env: Env) {
    try {
      // Parse the request body to extract the email address.
      const { email } = await request.json<RequestBody>();

      // Make a POST request to the No550 API.
      const no550Response = await fetch('https://api.no550.com/check', {
        method: 'POST',
        body: JSON.stringify({ email }),
        headers: {
          Authorization: env.NO550_API_TOKEN,
          'Content-Type': 'application/json',
        },
      });

      // Handle the response from the No550 API.
      const no550Data = await no550Response.json<CheckResponse>();

      if (no550Data.success === false) {
        return new Response('An error occurred: ' + no550Data.error, {
          status: 500,
        });
      }

      // Check the email status.
      if (no550Data.data!.status === 'invalid') {
        // Email is invalid, block the request.
        return new Response('Email validation failed: Invalid email address', {
          status: 400,
          headers: {
            'Content-Type': 'text/plain',
          },
        });
      } else {
        // Email is valid, proceed with the request as normal.
        return fetch(request);
      }
    } catch (error) {
      return new Response('An error occurred: ' + (error as Error).message, {
        status: 500,
      });
    }
  }
}

Feel free to customize the code to fit your use case.

Deploy the Worker

Once you’ve created the Cloudflare Worker, you need to deploy it to the Cloudflare network. To do this, run the following command:

npx wrangler deploy

Test

To test your Cloudflare Worker, you can send a POST request to its URL with an email address in the request body. For example:

curl -X POST \
  -H "Content-Type: application/json" \
  -d '{"email": "[email protected]"}' \
  https://YOUR_WORKER.YOUR_SUBDOMAIN.workers.dev/signup

Replace https://YOUR_WORKER.YOUR_SUBDOMAIN.workers.dev/signup with the actual URL of your Cloudflare Worker.

Conclusion

You’ve successfully created a Cloudflare Worker that integrates with the No550 API to validate email addresses. If the email is valid, you can customize the worker to perform sign-up or other actions. If the email is invalid, the worker will block the request. Feel free to modify the code to suit your specific use case and requirements.