Personal API Service

Small production-ready API stack for storing and reading messages.

Stack

• Go API
• PostgreSQL
• Nginx reverse proxy
• Docker

Endpoints

• GET /healthz
• POST /message
• GET /message?limit=50

Example create request:

curl -X POST http://localhost/message \
  -H "Content-Type: application/json" \
  -d '{"text":"hello from phone"}'

Example list request:

curl http://localhost/message

Run locally

1. Copy .env.example to .env and set a real password.
2. Start Docker Desktop if it is not already running.
3. Start the stack:

cp .env.example .env
docker compose up --build -d

If .env is missing, Docker Compose will now stop immediately with a clear error

4. Check health:

curl http://localhost/healthz

5. Smoke test the API:

curl -X POST http://localhost/message \
  -H "Content-Type: application/json" \
  -d '{"text":"hello from phone"}'

curl http://localhost/message

Deploy on a server

Install Docker and Docker Compose plugin, then place this folder on the server.

Use a firewall so only ports 80 and 443 are open publicly.

For HTTPS, terminate TLS at Nginx or put a managed proxy in front of it.

Start on boot with systemd

Example unit file is in deploy/systemd/personal-api-compose.service.

Install it on the server, then run:

sudo systemctl daemon-reload
sudo systemctl enable --now personal-api-compose