philippeperez/api-authentication-email repository overview

⁠🔐 Dead-Simple OTP ( One Time Password ) Auth API with Email PIN Codes

A lightweight authentication API that sends PIN codes to users via email — perfect for hobby projects, prototypes, or internal tools (like back-office systems).

⁠Docker use is free , also available as a pay per use on https://rapidapi.com/philippe234/api/otp-authentication-api-email⁠

⁠✅ Features

• 📦 Self-hosted in a container
• 🔒 100% control of your user base
• 🚫 No OAuth, no tokens, no headache
• 📝 Built-in Swagger documentation

⁠🚀 Getting Started

⁠1. Prepare a Local Directory

Create a local directory (LOCAL_DIR) to store your user database and configuration.

⁠2. Create the Configuration File

Save the following as config.ini inside your local directory:

# config.ini
[database]
URI = sqlite:////app/database.db
TRACK_MODIFICATIONS = False

[app]
DEBUG = True
TESTING = False
PORT = 5001
HOST = 127.0.0.1
 
[mode]
MULTI = True
EMAIL = "[email protected]"

[mail_server]
HOST = "mail.privateemail.com"
NAME = "Private Mail"
NOREPLY = "[email protected]"
PASSWORD = "*******"
PORT = 587
USER = "[email protected]"

[mail_template]
BODY = "Please enter the following pin code to login"
DESCRIPTION = ""
NAME = "Private mail"
SUBJECT = "Pin code"

---
### Api documentation

https://rapidapi.com/philippe234/api/otp-authentication-api-email

###

[Sample application](https://github.com/PhilippePerez/api-authentication-email-demo/tree/master)