ForgeZone API

L2ForgeZone API v1.0 — Documentation and status

Base URL: https://api.l2forgezone.com


Public endpoint (no auth)

One endpoint for all public data: health, platform stats, and extension catalog.

Stats (health + stats + extensions)

GET /api/stats

No auth. Returns service, version, status, timestamp, stats (aggregate numbers), and extensions (catalog). Cached 5 min.

Try it →


Authentication

CSRF Token

GET /api/csrf-token

Session required. Returns 503 until session/KV configured.

Register

POST /api/auth/register

No auth. Body: username, password, email (optional).

Login

POST /api/auth/login

No auth. Body: username, password. Returns customer_id.

Check Username

GET /api/auth/check-username/<username>

No auth. Returns { "exists": true/false }.

Password Reset

POST /api/auth/password-reset/request
POST /api/auth/password-reset/validate
POST /api/auth/password-reset/reset

No auth. Return 503 until implemented.


Extensions

Extension by Name

GET /api/extensions/<extension_name>

No auth. Returns catalog entry with pricing.

Customers for Extension

GET /api/extensions/<extension_name>/customers

No auth. Returns list of customers who purchased this extension.


Customers

All customer endpoints require X-Trusted-Customer-ID header (until session is implemented).

List Customers

GET /api/customers

Query: page, limit.

Get Customer

GET /api/customers/<customer_id>

Customer Extensions

GET /api/customers/<customer_id>/extensions

Returns purchased and available extensions with pricing.

Customer Servers

GET /api/customers/<customer_id>/servers

Customer Credits

GET /api/customers/<customer_id>/credits

Purchase History

GET /api/customers/<customer_id>/purchase-history

Customer Write Operations

POST /api/customers/<customer_id>/credits/add
PUT /api/customers/<customer_id>/email
PUT /api/customers/<customer_id>/password
POST /api/customers/<customer_id>/servers
DELETE /api/customers/<customer_id>/servers/<id>
POST /api/customers/<customer_id>/expand-server-limit
POST /api/customers/<customer_id>/purchase-extension

Return 503 until implemented.


Discord Links

GET /api/customers/<customer_id>/discord-link
POST /api/customers/<customer_id>/discord-link
DELETE /api/customers/<customer_id>/discord-link
GET /api/discord/links/<discord_user_id>

Return 503 until implemented.


Compilation Jobs

POST /api/customers/<customer_id>/compilation/start
GET /api/compilation/jobs/pending
POST /api/compilation/jobs/<job_id>/status
GET /api/customers/<customer_id>/compilation/status/<job_id>
GET /api/customers/<customer_id>/compilation/download/<job_id>
GET /api/customers/<customer_id>/compilation/jobs

Return 503 until implemented.


Powered by Cloudflare Workers & Pages. Full spec: API_ENDPOINTS.md