Cron Jobs

MkSaaS supports integrating Cron Jobs, which is a free and open-source cron job scheduler, for scheduled tasks, allowing you to automate your website's tasks, like distributing credits to users.

Setup

1. Create a new account in Cron Job.
2. Go to Cron Job Dashboard > Cronjobs, click CREATE CRONJOB.
3. Set Title and URL in Cron Job Common section, and set Execution schedule to run every day, the time is arbitrary, for example, 00:00. The URL is in the format of https://{=YOUR-DOMAIN}/api/distribute-credits.

4. Set Username and Password in Cron Job Advance section, and set Timeout to 30 seconds.

5. After creating the cron job, set the Username and Password in the .env file.

CRON_JOBS_USERNAME=YOUR-USERNAME
CRON_JOBS_PASSWORD=YOUR-PASSWORD

Cron Job System Structure

The file src/app/api/distribute-credits/route.ts is the cron job API route for distributing credits to users.

Usage

There is only one cron job for now, for distributing credits to users, and handling credit expiration. It should be run every day, so you should set the right Execution schedule when creating the cron job.

When the cron job is triggered, it will make a request to the /api/distribute-credits route, with the Username and Password as basic authentication credentials, and distribute credits to users, and handle credit expiration.

You can test the cron job by clicking the TEST RUN button in the cron job page, and check the response in the Response tab in the image below. You can also view the execution history of the cron job.

Reference

• Cron Job Official Website

Next Steps

Now that you have enabled the cron job, you may want to explore these related integrations: