ContactForm API (.NET 8 + AWS Lambda)

Backend RESTful API for contact form submissions: multi-SMTP failover, templates, attachments, API versioning, rate limiting. Runs locally or on AWS Lambda.

Documentation

Setup

• Getting started
• Configuration (env vars, SMTP, CORS)
• Deployment (AWS Lambda + GitHub Actions)

Feature

• API reference (endpoints, payloads, responses)
• API versioning
• Rate limiting & anti-abuse
• Email templates
• Error handling
• Security

Quick start

cd API
dotnet restore
dotnet run

• Swagger UI: http://localhost:5108/
• Health check: GET http://localhost:5108/test

Configuration

Minimum required env vars:

• SMTP_CONFIGURATIONS
• SMTP_{INDEX}_PASSWORD
• SMTP_RECEPTION_EMAIL
• SMTP_CATCHALL_EMAIL

Optional (prod CORS allow-list):

• CORS_{INDEX}_ORIGIN

See Docs/configuration.md.

API

Primary endpoints (v1):

• POST /api/v1/emails?smtpId={smtpId}
• POST /api/v1/emails?smtpId={smtpId}&test=true
• GET /api/v1/emails/{emailId}
• GET /api/v1/smtp-configurations
• GET /api/v1/versiontest

Minimal local call example:

curl -X POST "http://localhost:5108/api/v1/emails?smtpId=1" \
  -H "Content-Type: application/json" \
  -d '{"Email":"sender@example.com","Username":"John Doe","Message":"Hello"}'

Details: Docs/api.md and Docs/versioning.md.

Deployment

• AWS Lambda + GitHub Actions: Docs/deployment/aws-lambda.md

License

MIT - see LICENSE.