Developer Reference

Introduction

ZentryAuth provides high-performance authentication infrastructure built for developers, desktop software, and automated reseller networks. This guide walks you through authenticating client applications, distributing binaries securely, and integrating the Seller API.

Choose between three authentication architectures based on your product needs: License Key validation, User & Password logins, or Hybrid Key-Claiming.

Quick Start

Follow these core steps to initialize and validate software licenses in your client application.

# Quickstart Activate Example
curl -X POST "https://api.zentryauth.com/v1/YOUR_APP_KEY/license/activate" \
  -H "Content-Type: application/json" \
  -d '{
    "key": "XXXX-XXXX-XXXX-XXXX",
    "hwid": "PC-HWID-9921",
    "version": "1.0.0"
  }'

Authentication

Requests sent to ZentryAuth require standard HTTP headers and valid payload schemas.

Content-Type: application/json
Accept: application/json

Configure the mode of your application inside the panel settings. Endpoints enforce strict mode checks and return mode mismatch errors if called out of scope.

License Mode

Key-based authentication designed for instant software access, device locking, and automated expiration.

{
  "version": "1.0.0"
}

{
  "success": true,
  "code": "OK",
  "data": {
    "app_name": "My Desktop App",
    "version": "1.0.0",
    "maintenance": false
  }
}

{
  "key": "XXXX-XXXX-XXXX-XXXX",
  "hwid": "PC-HWID-9921",
  "version": "1.0.0"
}

{
  "success": true,
  "code": "OK",
  "data": {
    "token": "sess_88192a910...",
    "expires_at": "2026-12-31 23:59:59"
  }
}

{
  "token": "sess_88192a910...",
  "hwid": "PC-HWID-9921",
  "version": "1.0.0"
}

{
  "success": true,
  "code": "OK",
  "message": "Session valid"
}

User / Password Mode

Account-based authentication for applications requiring registered usernames, passwords, and custom user credentials.

{
  "login": "john_doe",
  "password": "secret123",
  "hwid": "PC-HWID-9921",
  "version": "1.0.0"
}

{
  "success": true,
  "data": {
    "token": "sess_user_7712...",
    "username": "john_doe",
    "email": "john@example.com"
  }
}

Hybrid Mode

Combines key distribution with user creation. Claiming a key generates a user account instantly in one request.

{
  "key": "XXXX-XXXX-XXXX-XXXX",
  "username": "john_doe",
  "password": "secret123",
  "email": "john@example.com",
  "hwid": "PC-HWID-9921"
}

{
  "success": true,
  "code": "CLAIMED",
  "message": "Account created successfully"
}

Seller API Overview

Server-to-server endpoints allowing Discord bots, external webshops, and automated billing tools to generate and manage keys without panel logins.

X-Seller-Key: your_seller_key
X-Seller-Secret: your_seller_secret
Content-Type: application/json

License Operations

Automate key generation, HWID resets, bans, and info lookups through server requests.

{
  "duration_type": "days",
  "duration_value": 30,
  "key_prefix": "VIP"
}

{
  "success": true,
  "data": {
    "license_key": "VIP-9812-7712-0091",
    "duration": "30 days"
  }
}

{
  "license_key": "VIP-9812-7712-0091"
}

{
  "success": true,
  "message": "HWID reset successfully"
}

User Operations

Manage registered accounts, update passwords, and issue HWID resets remotely via API.

{
  "username": "jane_doe",
  "password": "secret123",
  "duration_days": 30
}

{
  "success": true,
  "data": {
    "username": "jane_doe",
    "expires_at": "2026-08-20"
  }
}

Discord Webhook Automation

Automate recurring Discord announcements, branding, and status updates directly bound to your applications.

Software Releases & Distribution

Publish DLLs, EXEs, and software installers safely. Uploaded files undergo SHA256 integrity verification and automated antivirus scanning.

{
  "release_id": 102,
  "version": "1.0.4",
  "file_name": "Launcher-v1.0.4.exe",
  "size_bytes": 14820104,
  "sha256": "e3b0c44298fc1c149afbf4c8996fb92427ae41e4649b934ca495991b7852b855",
  "scan_status": "clean"
}

Error Codes

Standardized response codes returned by ZentryAuth endpoints.