https://github.com/kamikazechaser/disposable-email-cache
A self-hosted alternative to Kickbox's OpenAPI for checking if an email is disposable/temporary
https://github.com/kamikazechaser/disposable-email-cache
disposable-domains disposable-email spam-emails
Last synced: about 2 months ago
JSON representation
A self-hosted alternative to Kickbox's OpenAPI for checking if an email is disposable/temporary
- Host: GitHub
- URL: https://github.com/kamikazechaser/disposable-email-cache
- Owner: kamikazechaser
- License: unlicense
- Created: 2021-12-26T13:04:02.000Z (almost 4 years ago)
- Default Branch: master
- Last Pushed: 2022-01-19T17:14:06.000Z (almost 4 years ago)
- Last Synced: 2025-04-29T23:36:29.642Z (6 months ago)
- Topics: disposable-domains, disposable-email, spam-emails
- Language: Go
- Homepage:
- Size: 7.81 KB
- Stars: 6
- Watchers: 1
- Forks: 2
- Open Issues: 1
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
## disposable-email-cache
> A self-hosted alternative to Kickbox's OpenAPI for checking if an email is disposable/temporary.
### Build and run
```bash
# single binary
$ make build
$ ./disposable-email-cache
```
or
```bash
# build Docker container
$ DOCKER_BUILDKIT=1 docker build -t disposable-email-cache .
$ docker run --name disposable-email-cache -p 5000:5000 disposable-email-cache:latest
# or use pre-built Docker image
$ docker run --name disposable-email-cache -p 5000:5000 kamikazechaser/disposable-email-cache:latest
```
### API Endpoints
**Check if email domain is disposable**
```bash
$ curl localhost:5000/check/n8.gs
# {"disposable":true}
```
**Update and reload cache**
```bash
$ curl localhost:5000/update-cache
# {"cacheUpdated":true}
```