TeezU Developer Documentatie
Complete technische gids voor het integreren met het TeezU platform. Bevat gedetailleerde REST API v1 endpoints, RTMP/OBS livestream configuratie, WebRTC audio/video relays en WebSocket protocollen.
🏗️ Platform Architectuur & Systeemoverzicht
TeezU combineert een Express 5 microservice API gateway met dual-write dataconsistentie tussen Cloud Firestore en PostgreSQL, ultra low-latency video transcoding via FFmpeg en WebRTC SFU streaming.
┌─────────────────────────┐ RTMP :1935 ┌─────────────────────────┐
│ OBS Studio / Broadcaster│──────────────────────▶│ rtmp.teezu.online │
└─────────────────────────┘ │ (Node-Media-Server) │
└────────────┬────────────┘
│ FFmpeg HLS Transcoding
┌─────────────────────────┐ HTTPS / HLS ┌────────────▼────────────┐
│ Kijker Browser / App │◀──────────────────────│ live.teezu.online :8888 │
└────────────┬────────────┘ │ (HLS Delivery Edge) │
│ └─────────────────────────┘
│ REST API / WebSockets
┌────────────▼────────────┐ ┌─────────────────────────┐
│ api.teezu.online :3005 │──────────────────────▶│ PostgreSQL + Cloud DB │
│ (Express 5 + Socket.io) │ │ + Firestore Admin SDK │
└─────────────────────────┘ └─────────────────────────┘
🌐 21 Subdomeinen Matrix
Elk subdomein van TeezU is ontworpen voor een specifieke taak en geoptimaliseerd voor caching, isolatie en maximale prestaties:
| Subdomein | Doel | Backend / Target |
|---|---|---|
teezu.online / www | Hoofdplatform & landingspagina | SPA Frontend (dist) |
app.teezu.online | Directe webapp gebruikerservaring | SPA Direct App Mode |
admin.teezu.online | Beheerders- & moderatieconsole | Admin Gate & Dashboard |
creators.teezu.online | Creator Studio & Onboarding | Creator Portal |
providers.teezu.online | Geverifieerde Escort & Wellness | Provider Portal |
shop.teezu.online | Tokens, Merchandise & Cadeaus | Shop Marketplace |
stream.teezu.online | Broadcaster Studio & OBS Setup | Stream Manager |
beta.teezu.online | Early access testomgeving | Beta Features View |
docs.teezu.online | Officiële documentatieportal | Static Docs Engine |
api.teezu.online | Centrale REST API & WebSockets | Express Backend :3005 |
live.teezu.online | HLS videodistributie edge | HLS Server :8888 |
hls.teezu.online | HLS videosegmenten CDN | HLS Server :8888 |
livekit.teezu.online | WebRTC SFU interactieve media | LiveKit Server :7880 |
cdn.teezu.online | Statische uploads & avatars | Nginx Media Cache |
media.teezu.online | VOD archief & video vaults | Storage Server :443 |
ingest.teezu.online | RTMP inname gateway | RTMP Node :1935 |
rtmp.teezu.online | Primaire RTMP stream server | RTMP Node :1935 |
turn.teezu.online | Coturn STUN/TURN WebRTC relay | Coturn :3478 / :5349 |
mail.teezu.online | Zakelijke e-mail & support | MX / Mail Gateway |
ftp.teezu.online | Beveiligde SFTP media upload | SFTP Gateway :22 |
🔑 REST API v1 Endpoints Overzicht
Alle API aanroepen vereisen een geldige Firebase Bearer ID-token in de Authorization header tenzij anders aangegeven.
1. Authenticatie & Sessies
| Methode | Pad | Omschrijving |
|---|---|---|
| POST | /api/v1/auth/session-login | Verifieert Firebase ID token en maakt een beveiligde HTTP-only sessiecookie aan. |
| GET | /api/v1/auth/me | Haalt het actuele gebruikersprofiel, rollen en permissies op. |
| POST | /api/v1/auth/logout | Beëindigt de huidige sessie en wist cookies. |
2. Stream Keys & Broadcaster Ingest
| Methode | Pad | Omschrijving |
|---|---|---|
| POST | /api/v1/stream-keys/generate | Genereert een nieuwe cryptografische streamsleutel met 4-uurs TTL. |
| GET | /api/v1/stream-keys/active | Haalt de actieve streamsleutel van de ingelogde creator op. |
| POST | /api/v1/stream-keys/revoke | Trek een actieve streamsleutel per direct in bij beveiligingsincidenten. |
3. Wallet & TZ Tokens
| Methode | Pad | Omschrijving |
|---|---|---|
| GET | /api/v1/wallet/balance | Haalt realtime TZ token balans en transactiegeschiedenis op. |
| POST | /api/v1/wallet/tip | Verzend een atomische fooi in TZ tokens naar een creator tijdens een livestream. |
| POST | /api/v1/wallet/purchase | Initieert Stripe/Mollie checkout sessie voor het opwaarderen van tokens. |
🎥 OBS & RTMP Livestreaming Ingest Gids
Broadcasters kunnen streamen met Open Broadcaster Software (OBS Studio), Streamlabs of hardware encoders via ons RTMP netwerk:
Server URL: rtmp://rtmp.teezu.online/live Streamsleutel: tz_live_sec_******************************** Poort: 1935 (of 1936 voor RTMPS)
Aanbevolen OBS Encoder Instellingen
| Instelling | 1080p60 (High Quality) | 720p60 (Standaard) |
|---|---|---|
| Video Bitrate | 4500 - 6000 kbps | 2500 - 3500 kbps |
| Rate Control | CBR (Constant Bitrate) | CBR |
| Keyframe Interval | 2.0 seconden (Cruciaal voor HLS) | 2.0 seconden |
| CPU Preset | veryfast (x264) of NVENC P5 | veryfast of NVENC |
| Audio Bitrate | 160 kbps AAC | 128 kbps AAC |
⚡ WebRTC LiveKit & TURN Relay
Voor ultra low-latency 1-op-1 videogesprekken en co-streaming gebruikt TeezU LiveKit SFU gecombineerd met Coturn STUN/TURN relays voor betrouwbare NAT traversal:
LiveKit SFU Endpoint: wss://livekit.teezu.online STUN Server: stun:turn.teezu.online:3478 TURN Server (TLS): turns:turn.teezu.online:5349 Auth Protocol: RFC 5766 REST API Time-limited Credentials