API for our pubnix

Go to file

Arya Kiran b35e7805d2 why use val in the log midou		2023-05-27 18:25:12 +08:00
examples	send user email once registration is sent	2023-02-05 19:00:47 +05:30
pages	why use val in the log midou	2023-05-27 18:25:12 +08:00
utils	add todo to signup email	2023-03-06 19:40:53 +05:30
.gitignore	remove binary wtf	2023-01-07 19:16:48 +01:00
go.mod	switch to env for meta-info; add example meta-info.env	2023-01-18 21:05:07 +05:30
go.sum	switch to env for meta-info; add example meta-info.env	2023-01-18 21:05:07 +05:30
LICENSE	Arya fix it	2023-01-07 16:33:51 +01:00
main.go	try fixing ip issue	2023-02-18 10:24:36 +01:00
publapi.env	add notif after user is created	2023-03-01 19:16:53 +05:30
README.md	add signup ip support	2023-02-18 15:20:24 +05:30

README.md

PublAPI

PublAPI is a simple API for Project Segfault's upcoming public shared system (pubnix).

Install

An installation of Go 1.19 or higher is required.

git clone https://github.com/ProjectSegfault/publapi
go mod download 
go build 
./publapi

By default publapi listens on 127.0.0.1:3000. You can change the port with the environment variable PUBLAPI_PORT.

Additionally, you need to set the variable PUBLAPI_EMAIL_SHOUTRRRURL and PUBLAPI_NOTIFY_SHOUTRRRURL in order for signup notifications to work. URL Format can be found at https://containrrr.dev/shoutrrr/v0.5.

You can also set PUBLAPI_SIGNUP_IP to make sure signup requests can only be made from one IP.

Usage

Currently, PublAPI has only two routes, /users and /signup.

ROUTE	TYPE	EXTRA ARGS	DESCRIPTION
/users	GET	N/A	Return information about users.
/signup	POST	username, email, ssh	Creates a register script and notifies admins that a new registration request was sent.