api.ronanhayes.net API Docs
Generated at 2026-02-17T12:07:31.452Z. Use https://api.ronanhayes.net as the single API base URL.
Quick Start
- Use
https://api.ronanhayes.netfor every endpoint listed below. - 13 public routes require no auth.
- 16 admin routes require
x-admin-token. - Face match is public and uses Amazon Rekognition behind the API.
- Fraud check is public and returns bot/spam risk signals for the caller request.
- Overlay events are polled on-demand and do not run 24/7 in the background.
- Application classification is public and uses SageMaker Runtime behind the API.
Links API (track service)
Short links, analytics, and dashboard session routes.
| Method | URL | Auth | Notes |
|---|---|---|---|
GET | https://api.ronanhayes.net/api/health | Public | Health check. |
POST | https://api.ronanhayes.net/api/session/unlock | Required: x-admin-token | Unlock dashboard session cookie. |
POST | https://api.ronanhayes.net/api/session/lock | Public | Clear dashboard session cookie. |
GET | https://api.ronanhayes.net/api/links | Required: x-admin-token | List shortened links. |
POST | https://api.ronanhayes.net/api/links | Required: x-admin-token | Create a new short link. |
DELETE | https://api.ronanhayes.net/api/links/{slug} | Required: x-admin-token | Delete a short link by slug. |
GET | https://api.ronanhayes.net/api/analytics/{slug} | Required: x-admin-token | Read analytics for a slug. |
Angel API (config + visits)
Link tree config and visit analytics routes.
| Method | URL | Auth | Notes |
|---|---|---|---|
GET | https://api.ronanhayes.net/api/config | Public | Read public page configuration. |
POST | https://api.ronanhayes.net/api/visit | Public | Track a public page visit event. |
GET | https://api.ronanhayes.net/api/admin/config | Required: x-admin-token | Read full admin configuration. |
PUT | https://api.ronanhayes.net/api/admin/config | Required: x-admin-token | Update admin configuration. |
GET | https://api.ronanhayes.net/api/admin/visits | Required: x-admin-token | Read visit analytics for angel.ronanhayes.net. |
Offers API (public)
Client-facing offer discovery, resolve, redirect, and click tracking.
| Method | URL | Auth | Notes |
|---|---|---|---|
GET | https://api.ronanhayes.net/api/offers | Public | List active offers for current request context (supports ?ref, ?uid, ?local_hour, ?local_weekday, ?tz_offset_min, ?lang, ?os, ?browser, ?conn, ?returning, ?session_depth). |
GET | https://api.ronanhayes.net/api/offers/{slug} | Public | Read one active offer. |
GET | https://api.ronanhayes.net/api/offers/{slug}/resolve | Public | Resolve the destination URL for an offer. |
GET | https://api.ronanhayes.net/o/{slug} | Public | Redirect to an eligible offer destination and record click analytics. |
POST | https://api.ronanhayes.net/api/offers/{slug}/click | Public | Record one offer click event. |
Offers API (admin)
Offer CRUD and offer analytics admin routes.
| Method | URL | Auth | Notes |
|---|---|---|---|
GET | https://api.ronanhayes.net/api/admin/offers | Required: x-admin-token | List all offers (including inactive). |
POST | https://api.ronanhayes.net/api/admin/offers | Required: x-admin-token | Create an offer. |
GET | https://api.ronanhayes.net/api/admin/offers/{slug} | Required: x-admin-token | Read one offer. |
PUT | https://api.ronanhayes.net/api/admin/offers/{slug} | Required: x-admin-token | Update one offer. |
DELETE | https://api.ronanhayes.net/api/admin/offers/{slug} | Required: x-admin-token | Delete one offer. |
GET | https://api.ronanhayes.net/api/admin/offers/{slug}/analytics | Required: x-admin-token | Read offer click analytics. |
DELETE | https://api.ronanhayes.net/api/admin/offers/{slug}/analytics | Required: x-admin-token | Reset offer click analytics. |
Face Match API (public)
Face comparison endpoint powered by Amazon Rekognition.
| Method | URL | Auth | Notes |
|---|---|---|---|
POST | https://api.ronanhayes.net/api/face/match | Public | Compare two face images using Amazon Rekognition. |
Fraud API (public)
Request risk scoring endpoint for bot/spam diagnostics.
| Method | URL | Auth | Notes |
|---|---|---|---|
POST | https://api.ronanhayes.net/api/fraud/check | Public | Inspect request risk signals and return spam/bot score. |
Overlay API (public)
Live overlay events feed (polls Chaturbate only when requested).
| Method | URL | Auth | Notes |
|---|---|---|---|
GET | https://api.ronanhayes.net/api/overlay/events | Public | Read sanitized live overlay events (tips/follows) from Chaturbate on-demand feed polling. |
Application API (public)
Application workflows powered by model inference.
| Method | URL | Auth | Notes |
|---|---|---|---|
POST | https://api.ronanhayes.net/api/application/length | Public | Classify approximate visual length category from one uploaded image (no exact measurement, requires custom model). |
Machine-readable docs
/openapi.json (OpenAPI 3.0.3)
/docs/migration.json (migration map)