CasinoHub – Anbindung

Technische Dokumentation für angebundene Plattformen · Stand dieser Seite: 2026-08-26

Schnellstart

CasinoHub bündelt Slots und Live-Casino mehrerer Spielehersteller zu EINER Anbindung. Sie holen die Spieleliste, starten ein Spiel für Ihren Spieler und holen das Guthaben danach zurück. Alles ist JSON, alle Beträge in Cent.

Basis-Adresse: https://staging.atlascasinohub.com

# 1. Erreichbarkeit prüfen (ohne Schlüssel)
curl https://staging.atlascasinohub.com/v1/health

# 2. Spieleliste
curl -H "Authorization: Bearer IHR_SCHLUESSEL" "https://staging.atlascasinohub.com/v1/games?brand=meine-marke&currency=EUR"

# 3. Spiel starten (1,00 € ins Spiel übertragen)
curl -X POST https://staging.atlascasinohub.com/v1/launch \
  -H "Authorization: Bearer IHR_SCHLUESSEL" -H "Content-Type: application/json" \
  -d '{"brand":"meine-marke","playerRef":"12345","currency":"EUR","gameCode":"SoSweet","amountCents":100}'

# 4. Guthaben zurückholen
curl -X POST https://staging.atlascasinohub.com/v1/return \
  -H "Authorization: Bearer IHR_SCHLUESSEL" -H "Content-Type: application/json" \
  -d '{"brand":"meine-marke","playerRef":"12345"}'

Zugang & Schlüssel

Jeder Kunde erhält einen Schlüssel (Format chk_…). Er wird genau einmal im Klartext ausgegeben; danach liegt bei uns nur ein Hash. Übergabe im Kopf der Anfrage:

Authorization: Bearer chk_xxxxxxxxxxxxxxxxxxxxxxxx

Der Schlüssel gehört auf Ihren Server, niemals in eine Anwendung beim Endkunden. Wer ihn hat, kann Spiele auf Ihre Rechnung starten.

Marke (`brand`)

Betreiben Sie mehrere Seiten, trennt brand sie voneinander: eigene Spielauswahl, eigene Währungen, eigene Auswertung. Bei nur einer Seite lassen Sie das Feld weg.

Spielerkennung (`playerRef`)

Ihre eigene Kennung des Spielers – eine Zahl oder Zeichenkette Ihrer Wahl. CasinoHub speichert keine Namen, keine E-Mail-Adressen, kein Geburtsdatum. Wir wissen nur, dass "Spieler 12345" gespielt hat.

Ablauf einer Spielrunde

Gespielt wird im Übertragungsverfahren. Ihr Guthaben bleibt bei Ihnen:

1.	Sie buchen den Einsatz beim Spieler ab – in Ihrem eigenen System.
2.	`POST /v1/launch` überträgt den Betrag ins Spiel und liefert die Startadresse.
3.	Der Spieler spielt. CasinoHub ist dabei nicht beteiligt.
4.	`POST /v1/return` holt den Reststand zurück und schließt die Sitzung.
5.	Sie schreiben den zurückgemeldeten Betrag dem Spieler gut.

Je Spieler kann immer nur eine Sitzung offen sein. Ein zweiter Start wird mit 409 abgelehnt und nennt die offene Sitzung – so kann Guthaben nicht an zwei Stellen gleichzeitig liegen.

Rufen Sie /v1/return immer auf, wenn der Spieler das Spiel verlässt – auch bei Abbruch, Fenster geschlossen oder Zeitüberschreitung. Solange die Sitzung offen ist, liegt das Guthaben im Spiel.

Endpunkte

Endpunkt	Zweck
`GET /v1/health`	Erreichbarkeit. Ohne Schlüssel, ideal für die Überwachung.
`GET /v1/games`	Spieleliste. Parameter: `brand`, `currency`, `category`, `maker`, `search`.
`GET /v1/makers`	Spielehersteller mit Anzahl – für Filterleisten.
`POST /v1/launch`	Spiel starten. Feld `amountCents`, optional `lang` und `returnUrl`.
`POST /v1/return`	Guthaben zurückholen und Sitzung schließen.
`GET /v1/session`	Offene Sitzung eines Spielers.

Antwort von `/v1/games`

{
  "currency": "EUR",
  "count": 2182,
  "games": [
    { "id": 21813, "code": "SoSweet", "name": "So Sweet",
      "maker": "CQ9", "category": "Slots",
      "image": "https://…/sosweet.png" }
  ]
}

code ist der Wert, den Sie bei /v1/launch als gameCode übergeben. maker ist der Spielehersteller.

Antwort von `/v1/launch`

{ "ok": true, "sessionId": 15, "transferredCents": 100,
  "url": "https://…/launch?user_code=…&g_token=…" }

Die Adresse öffnen Sie beim Spieler – als eigene Seite oder eingebettet.

Antwort von `/v1/return`

{ "ok": true, "sessionId": 15, "returnedCents": 40, "resultCents": 60 }

resultCents ist übertragen minus zurückgeholt – positiv heißt Verlust des Spielers.

Geld & Abrechnung

Das Guthaben Ihrer Spieler gehört durchgehend Ihnen. CasinoHub führt kein Spielerkonto und verwahrt kein fremdes Geld – wir übertragen es nur ins Spiel und wieder zurück und schreiben mit, was passiert ist.

Grundlage der Abrechnung sind die Sitzungen: Summe der übertragenen Beträge minus Summe der zurückgeholten. Ihre eigenen Sitzungen sehen Sie jederzeit im Portal oder über GET /v1/portal/sessions.

Kundenportal

Unter https://staging.atlascasinohub.com/portal melden Sie sich mit Ihrem Schlüssel an und bestimmen selbst, was Ihr Angebot enthält:

Spielehersteller	einzeln an- und abschalten
Kategorien	Slots und Live Casino getrennt
Einzelne Spiele	gezielt sperren
Höchstbetrag	Obergrenze je Spielstart
Sitzungen	eigene Auswertung

GET  https://staging.atlascasinohub.com/v1/portal/settings     # aktuelle Einstellungen
PUT  https://staging.atlascasinohub.com/v1/portal/settings     # ändern (nur die gesendeten Felder)
GET  https://staging.atlascasinohub.com/v1/portal/catalog      # wählbare Hersteller und Kategorien
GET  https://staging.atlascasinohub.com/v1/portal/sessions     # eigene Sitzungen
GET  https://staging.atlascasinohub.com/v1/portal/usage        # eigene Abrufe

Fehler & Grenzen

Code	Bedeutung	Was zu tun ist
200	In Ordnung	–
400	Angabe fehlt oder ist unzulässig	Meldung im Feld `error` lesen
401	Schlüssel fehlt, ist falsch oder gesperrt	Schlüssel prüfen
403	Zugang gesperrt oder Spiel abgeschaltet	Bei uns melden bzw. im Portal nachsehen
404	Spiel nicht gefunden	Spieleliste neu holen – das Angebot ändert sich
409	Sitzung läuft noch	Zuerst `/v1/return` aufrufen
429	Zu viele Anfragen	Takt drosseln und erneut versuchen
502	Spieleanbieter meldet einen Fehler	Meldung weitergeben; bei Wiederholung bei uns melden

Fehler kommen immer als JSON mit einem Feld error.