notifapi

NotifAPI

A simple API to receive data and send push notifications to multiple devices via Pusher

Features

• Send messages from all your various systems and services to all of your devices via API call
• Logging of all alerts to a SQLite DB

Installation

Server

• Sign up for a Pusher account
• Clone this repo
• go build
• Run manually
  • ./notifapi
• Install as a service
  • Copy notifapi.sh somewhere (home folder?)
  • Modify and copy notifapi.service to /etc/systemd/system/
  • systemctl enable notifapi.service and systemctl start notifapi.service
• On first run, a blank config file will be generated
• Modify config.yaml and re-run
• Navigate to 127.0.0.1: to install the Service Worker in Chrome to receive notifications

Docker

docker build -t notifapi \
  --build-arg DB_PATH=/app \
  --build-arg DEV_MODE=true \
  --build-arg INSTANCE_ID=xxx \
  --build-arg LOG_PATH=/app/logs \
  --build-arg PORT=8080 \
  --build-arg SECRET_KEY=xxx \
  --build-arg DISCORD_WEBHOOK=https://discord.com/api/webhooks/xxx/xxx .

docker run -p 8080:8080 \
  --name notifapi \
  --hostname notifapi_docker \
  notifapi

Client

Example:

package notifications

import (
	"fmt"

	"github.com/coma-toast/notifapi/pkg/client"
	"github.com/coma-toast/notifapi/pkg/notification"
)

type Notification struct {
	Target string
}

func (n *Notification) SendMessage(title, body string) error {
	client := client.Client{Target: n.Target}
	message := notification.Message{
		Interests: []string{"hello"},
		Title:     title,
		Body:      body,
		Source:    "Source Application Name", // what application are you sending this from
	}

	response, err := client.SendMessage(message)
	if err != nil {
		fmt.Println(err)
		return err
	}
	fmt.Println(response.Status)

	return nil
}

Send a notification

Send a POST request to URL:PORT/api/notify with the following JSON body:

{
    "interests": ["hello"],
    "title": "Test message",
    "body": "This is a test from my testing platform",
    "link": "",
    "source": "My-Laptop",
    "metadata": {
        "server": "macbook-pro"
    }
}

See notifapi.http for more details

Roadmap

• Authentication (JWT)
• Front End to view alert logs (React, or the JS framework du jour)
• Better documentation
• Better testing
• Docker images