Eren Xiters · Auth API

API Overview

Operational

GitHub-backed authentication API with user management, HWID binding, and category-based organization.

GITHUB_TOKEN GITHUB_USER GITHUB_REPO GITHUB_FILE

Data stored as JSON in a GitHub repository. All operations commit directly to the repo.

Repository

Storage GitHub JSON

Operations CRUD via API

Auth Method Password + HWID

Rate Limit GitHub API limits apply

Required ENV

GITHUB_TOKEN = ghp_xxxxxxxx
GITHUB_USER = your-username
GITHUB_REPO = your-repo
GITHUB_FILE = users.json

● All variables required for operation

fetch GET

/fetch

Parameters:
username (string, required)
pass (string, required)
categorytocheckin (string, required)

Authenticate a user and return their full user data.

/fetch?username=johndoe&pass=secret&categorytocheckin=users

addUser POST

/addUser

Parameters:
category (string, required)
username (string, required)
password (string, optional, default: "default")

Create a new user in a category. Auto-sets creation date.

/addUser?category=premium&username=alice&password=secure123

createCategory POST

/createCategory

Parameters:
category (string, required)

Create a new empty category for organizing users.

/createCategory?category=enterprise

editUser PUT

/editUser

Parameters:
category (string, required)
username (string, required)
field (string, required)
value (string, required)

Update any field (password, hwid, expiryDate, loginMessage, etc.)

/editUser?category=premium&username=alice&field=hwid&value=ABC-123

fetchUsers GET

/fetchUsers

Parameters:
category (string, optional)

Get all users (or filter by category). Returns full JSON.

/fetchUsers?category=premium

updatehwid PUT

/updatehwid

Parameters:
username (string, required)
category (string, required)
hwid (string, required)

Update a user's HWID and auto-set lastUsed timestamp.

/updatehwid?username=alice&category=premium&hwid=HWID-123456

github (unified) POST

/github

Actions:
getUsers — list all users
addUsers — bulk add users
searchUser — find user
editUser — edit user fields
deleteUser — delete user
resetHwid — clear HWID

Unified endpoint supporting all operations via action parameter. Expects JSON body.

{ "action": "searchUser", "username": "johndoe" }

User Data Structure

{
  "category": {
    "username": {
      "password": "string",
      "hwid": "string",
      "expiryDate": "string",
      "creationDate": "YYYY-MM-DD HH:MM:SS",
      "lastUsed": "YYYY-MM-DD HH:MM:SS",
      "loginMessage": "string"
    }
  }
}

● All fields stored in JSON · Commits to GitHub on every change