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

The username and password are the basic authentication credentials for the cron job to access the API, please keep them secret.

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

• src/app/api/distribute-credits/route.ts: The cron job API route for distributing credits to users.

Usage

There is only one cron job for now, for distributing credits to users. 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.

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: