# Thomas Marchand Developer Resources

> APIs, webhooks, and machine-readable docs for thomas.md. License claims for Oraxen and HackedServer live here too.

## When to use thomas.md APIs

Use these endpoints to automate license fulfillment, reconcile payments, or integrate with the thomas.md account system. Public writing is available as HTML or via Accept: text/markdown; start with [/llms.txt](https://thomas.md/llms.txt).

## Public pages

- [License claim UI](https://thomas.md/license): Claim Oraxen or HackedServer licenses after purchase.
- [Beta program](https://thomas.md/beta): Join or leave the beta membership program.
- [Newsletter](https://thomas.md/email): Subscribe or unsubscribe from updates.
- [Sitemap](https://thomas.md/sitemap.xml): Full URL index for crawlers.
- [llms.txt](https://thomas.md/llms.txt): Agent-oriented site map and when-to-use guidance.

## Webhook endpoints (server-to-server)

Payment and platform webhooks expect signed payloads from the upstream provider. Do not call these with user credentials.

- POST https://thomas.md/api/stripe/webhook — Stripe checkout and charge events for license fulfillment.
- POST https://thomas.md/api/paypal/webhook — PayPal IPN for license fulfillment.
- POST https://thomas.md/api/tebex/webhook — Tebex purchase notifications (IP allowlist enforced).

## User-facing API routes

Authenticated or session-based routes used by the site UI:

- POST https://thomas.md/api/license/claim — Claim a license with a transaction ID.
- POST https://thomas.md/api/discord/unlink — Remove Discord role linkage for the signed-in user.
- POST https://thomas.md/api/beta/join — Join the beta program.
- POST https://thomas.md/api/beta/leave — Leave the beta program.
- POST https://thomas.md/api/newsletter/join — Subscribe to the newsletter.
- POST https://thomas.md/api/newsletter/leave — Unsubscribe from the newsletter.

Admin routes under /api/admin/ require an authenticated admin session and are not part of the public integration surface.

## Open-source repositories

- [Oraxen on GitHub](https://github.com/th0rgal/Oraxen): Source code, issues, and plugin documentation.
- Search GitHub for th0rgal for additional public repositories.

## Content negotiation

Send Accept: text/markdown on any public page URL (for example https://thomas.md/posts/quantum-proofing-bitcoin) to receive Markdown instead of HTML. Responses include Vary: Accept for CDN-safe caching.