API DOKUMENTATION

Public REST + Webhooks. Open spec, sandbox-fähig, OAuth2-secured.

Die komplette OG Records Plattform — Releases, Tracks, Splits, Earnings, Smart Links, Analytics, Sync — als Public API verfügbar. Volle Live-Dokumentation auf developer.og-records.com (Phase 8 unseres Roadmaps).

developer.og-records.comSandbox-Zugang anfordern

REST + Webhooks

Alle Plattform-Aktionen als REST-Calls. Status-Änderungen werden zusätzlich über Webhooks ausgespielt — HMAC-signiert mit deinem Secret, Replay-protected, automatisch retried (Exponential Backoff).

OAuth2 + API Keys

Production-Apps nutzen OAuth2-Authorization-Code-Flow mit refresh-fähigen Tokens. Server-to-Server-Integrationen können stattdessen einen API-Key mit Scopes verwenden — pro Integration getrennt, jederzeit rotierbar.

Sandbox-Mode

Voll funktionsfähige Sandbox-Umgebung mit Mock-Daten — ohne KYC, ohne echte DSP-Auslieferung. Identische Schemas, identische Fehler-Codes, identische Webhook-Signaturen wie Production.

TypeScript & Python SDKs

Auto-generierte SDKs aus OpenAPI 3.1 — für TypeScript (npm: @og/api-sdk) und Python (pip: og-records). Inklusive Retry-Helper, Pagination-Iteratoren und Webhook-Verifier.

ENDPOINT-ÜBERSICHT

Was du heute schon machen kannst (Phase 1).

Sandbox ist live. Production-Zugriff ist gated bis zum Public-Launch der Public-API in Phase 8 — Early Access auf Anfrage.

Releases & Tracks

  • POST/api/v1/releasesRelease anlegen (Wizard-Step 1).
  • GET/api/v1/releases/:idRelease-Detail inkl. Tracks und QC-Status.
  • PATCH/api/v1/releases/:id/:stepWizard-Step aktualisieren.
  • POST/api/v1/releases/:id/submitRelease zur Distribution einreichen.
  • POST/api/v1/tracksTrack anlegen oder Audio-File hochladen.
  • GET/api/v1/tracks/:id/qc-statusAudio-QC- und Cover-QC-Status.

Royalty Splits

  • POST/api/v1/splitsSplit-Konfiguration anlegen — pro Track oder pro Release.
  • GET/api/v1/releases/:releaseId/splitsAktive Splits eines Releases.
  • POST/api/v1/personsEmpfänger:in anlegen oder einladen.

Earnings & Payouts

  • GET/api/v1/earningsEarnings-Stream pro Release / Track / Periode.
  • GET/api/v1/payoutsAuszahlungs-Historie.
  • POST/api/v1/payouts/requestManuelle Auszahlung anfordern.

Smart Links

  • POST/api/v1/smartlinksSmart-Link erstellen, mit Pre-Save-Konfiguration.
  • GET/api/v1/smartlinks/:slugSmart-Link Public-View (kein Auth).
  • GET/api/v1/smartlinks/:id/statsConversions, Klicks, DSP-Verteilung.

Webhooks

  • POST/webhooks/stripeStripe-Inbound (HMAC, replay-protected).
  • POST/webhooks/wiseWise-Inbound für Payout-Status.
  • POST/webhooks/dsp-syncDSP-Sync-Events vom Sub-Distributor.
  • POST/webhooks/mailgunMailgun-Bounce-/Complaint-Events.
  • POST/webhooks/whapiWhatsApp Business API-Inbound.
AUTHENTIFIZIERUNG

OAuth2 oder API-Key — du wählst.

OAuth2-Authorization-Code-Flow für End-User-Apps mit Refresh-Token-Rotation. API-Keys mit granularen Scopes (releases:write, splits:read, earnings:read, smartlinks:write etc.) für Server-Integrationen. Alle Keys sind jederzeit per UI rotierbar — alte Keys werden mit 7 Tagen Toleranz weiterhin akzeptiert.

RATE LIMITS

Was deine Integration darf.

Sandbox
60 req / Min

pro API-Key, IP-bezogen.

Production · Free
120 req / Min

burst bis 240, soft-throttled.

Production · Business
600 req / Min

dedizierte Worker-Pool, SLA verfügbar.

Antworten enthalten X-RateLimit-Limit, X-RateLimit-Remaining und Retry-After Header. Bei Überschreitung antworten wir mit 429 und Retry-After in Sekunden.

EARLY ACCESS

Sandbox ist heute schon zugänglich.

Schreib uns kurz, wofür du die API nutzen willst — wir provisionieren dir innerhalb von 24 Stunden einen Sandbox-Account und einen API-Key.

Sandbox anfordernPublic-API-Roadmap