Quoten, Wetten und Coupons — technische API-Dokumentation

• Basis-URL-API;
• Login und Passwort des Kundenkontos;
• Wenn Sie einen Rückruf verwenden, aktivieren Sie die Funktion und die geheime Phrase callback_secret.

Die Beispiele verwenden eine bedingte Adresse:

BASE_URL="https://coupon-api.example.com"

Verwenden Sie in der Produktion HTTPS. Alle Daten werden als Unix-Zeitstempel in Millisekunden übertragen, Geldwerte werden als Dezimalzahlen ohne feste Genauigkeit übertragen.

Erfolg:

{
  "code": 1,
  "body": {},
  "error_code": null,
  "error_message": null,
  "date": 1784970000000,
  "time_ms": 5,
  "path": "/api/partner/example"
}

Der Geschäftsfehler kommt normalerweise auch mit HTTP 200:

{
  "code": 0,
  "body": null,
  "error_code": 1002,
  "error_message": "Not all params",
  "date": 1784970000000,
  "time_ms": 5,
  "path": "/api/partner/example"
}

Überprüfen Sie immer den HTTP-Code, dann code, dann error_code. Verwenden Sie nicht den Text error_message als Softwareschlüssel.

POST /api/partner/login
Content-Type: application/json

{
  "username": "partner-demo",
  "password": "strong-password"
}

Das Feld login wird als kompatibler Alias username unterstützt.

Erfolgreiche Antwort:

{
  "code": 1,
  "body": {
    "token": "<jwt-token>",
    "user_id": 17,
    "username": "partner-demo"
  },
  "error_code": null,
  "error_message": null
}

Übergeben Sie in allen geschützten Anfragen Folgendes:

Authorization: Bearer <jwt-token>

Grundlegende Anmeldefehler:

Diese Fehler werden von HTTP 200, code = 0 zurückgegeben. HTTP 401 einer geschützten Methode bedeutet, dass das JWT fehlt, ungültig, abgelaufen oder widerrufen ist; Melden Sie sich erneut an. HTTP 403 bedeutet unangemessene Rolle oder Zugriff verweigert.

Jedes ausgewählte Ergebnis wird als vorgefertigte Zeile aus der Sportzeile übermittelt:

line_type#game_id#group_id#type_id#rate#coefficient[#player_id]

Beispiele:

line#737779544#1#1#0#1.85
live#738917381|119|5869|0.5#3.6#149439538

• line_type: line oder live;
• rate: Gesamt-/Handicap-Parameter oder 0;
• player_id: optionale Spieler-ID;
• Die Trennzeichen # und | werden unterstützt.

Erfassen oder korrigieren Sie den Zeiger nicht manuell – übergeben Sie den aus der Zeile erhaltenen Wert unverändert.

POST /api/partner/coupons/place
Authorization: Bearer <jwt-token>
Content-Type: application/json

{
  "list_bets": [
    "line#737779544#1#1#0#1.85"
  ],
  "amount": 10,
  "currency": "USD",
  "callback_url": "https://partner.example.com/api/coupon-result",
  "lang": "en",
  "mode": "reject",
  "mode_type": null,
  "multi": false
}

Quoten

Normal-, Express- und multi

Ein Schnellzug kann nicht mehr als 15 Ereignisse enthalten. Sie können nicht mehrere Wetten auf dasselbe Spiel kombinieren, einschließlich des Hauptspiels, Halbzeiten, Perioden, Ecken, Fouls und anderer damit zusammenhängender Unterereignisse. Diese Kombination gibt 506 zurück.

Vollständige erfolgreiche Antwort mit Gutschein und akzeptierten Wettdaten in events_data:

{
  "code": 1,
  "body": {
    "coupons": [
      {
        "coupon_code": "000000000272",
        "amount": 10,
        "win": 18.5,
        "potential_win": 18.5,
        "real_win": null,
        "coef": 1.85,
        "original_coef": 1.85,
        "calculate_coef": null,
        "has_return": false,
        "date": 1784970000000,
        "status": 0,
        "asian": false,
        "calculate_date": null,
        "coupon_type": 1,
        "events_count": 1,
        "events_data": [
          {
            "id": 912,
            "game_id": 737779544,
            "main_game_id": 737779544,
            "is_sub_game": false,
            "parent_game_id": null,
            "sub_game_key": null,
            "raw_pointer": "line#737779544#1#1#0#1.85",
            "line_type": "line",
            "is_live": false,
            "bet_group_id": 1,
            "bet_group_name": "Match result",
            "bet_id": 1,
            "bet_name": "First team to win",
            "sport_id": 1,
            "sport_name": "Football",
            "tournament_id": 10001,
            "tournament": "National League",
            "event_date": 1784971800000,
            "status": 0,
            "opp1": "Team A",
            "opp2": "Team B",
            "coef": 1.85,
            "calc_coef": null,
            "bet_score": "line#737779544#1#1#0#1.85",
            "calculate_date": null,
            "calculate_score": null,
            "settlement_reason_code": null,
            "settlement_reason": null,
            "placement_score_full": null,
            "placement_score_periods": null,
            "calculation_score_full": null,
            "calculation_score_periods": null,
            "timer": null,
            "dop_name": null,
            "rate": "0",
            "sgame_id": null,
            "game_num": null,
            "stat_id": null,
            "team1_id": 101,
            "team2_id": 102,
            "opp_icon1": 101,
            "opp_icon2": 102
          }
        ]
      }
    ]
  },
  "error_code": null,
  "error_message": null,
  "date": 1784970000015,
  "time_ms": 45,
  "path": "/api/partner/coupons/place"
}

Gutscheinfelder

Für jeden Artikel body.coupons[] wird ein separater Gutschein erstellt.

Gebotsfelder

Jedes Element von events_data[] beschreibt eine bestimmte akzeptierte Wette innerhalb des Coupons.

Der Wert null ist normal für Daten, die noch nicht berechnet wurden oder nicht verfügbar sind. Ersetzen Sie es nicht automatisch durch 0 oder die leere Zeichenfolge.

Betrachten Sie den Gutschein nur als akzeptiert, wenn code = 1 und das Vorhandensein von Gegenständen in body.coupons vorliegt. Zuvor ist der Korb eine Vorauswahl: Die Auswahl könnte verschwinden, gesperrt werden oder sich die Quoten ändern.

Nach Erfolg:

1. alle body.coupons-Objekte speichern, nicht nur das erste;
2. Speichern Sie coupon_code als Zeichenfolge mit führenden Nullen.
3. Speichern Sie die erforderlichen Daten von events_data;
4. Ordnen Sie den Coupon dem Endbenutzer zu.
5. Erfassen Sie die Finanztransaktion des Benutzers im System des Partners.

Identifikatoren:

currency wird im vollständigen Modell und Rückruf nicht zurückgegeben. Wenn die Währung benötigt wird, speichern Sie den Wert aus der Erstellungsanforderung.

Für 501–504 gibt die neue API die problematischen Raten in body.changes[] zurück. Feld change_type: 1 – der Koeffizient ist gestiegen, 2 – gesunken, null – die Richtung ist nicht anwendbar.

Versuchen Sie es nicht blind erneut mit POST /coupons/place nach einer Zeitüberschreitung: Möglicherweise wurde die erste Anfrage akzeptiert und bei einem erneuten Versuch wird ein Duplikat erstellt.

Mithilfe von Codes können Sie bis zu 100 Werte übertragen:

{
  "coupon_ids": ["000000000272", "000000000273"]
}

Oder verstreichen Sie den Erstellungszeitraum nicht länger als 24 Stunden:

{
  "start_date": 1784880000000,
  "end_date": 1784966400000
}

Kombinieren Sie coupon_ids und Datumsangaben nicht in derselben Abfrage. results filtert nach Erstellungszeit und calculated filtert nach Endabrechnungszeit.

Gutscheinstatus:

Gebotsstatus:

Für die finanzielle Abgrenzung an den Endbenutzer verwenden Sie das vorgefertigte real_win. Verwenden Sie nicht potential_win und berechnen Sie die Zahlung nicht selbst neu. Vor der Berechnung sind real_win, calculate_coef, calc_coef und calculate_date gleich null, nicht 0.

Beim ersten Status des Gutscheins 15, wenn das vorherige Ergebnis bereits finanziell abgewickelt wurde, belastet der Partner erneut amount vom Endbenutzer, erwartet einen neuen Endstatus und berechnet einen neuen real_win. Schützen Sie den Betrieb vor einer Wiederaufbereitung.

Jede Wette im vollständigen Modell und Rückruf hat:

Vor der Berechnung sind beide Felder gleich null. Für eine lokalisierte Benachrichtigung verwenden Sie Code wie:

• MATCH_POSTPONED – das Spiel wurde verschoben;
• MATCH_CANCELLED – Spiel abgesagt;
• MARKET_PUSH – Rendite gemäß den Marktregeln.

Wenn der Code unbekannt ist, speichern Sie ihn und verwenden Sie den nicht leeren settlement_reason als Fallback-Text. Berechnen Sie die Zahlung nicht nach Grund, sondern verwenden Sie Status und real_win.

Diese Felder erläutern die bereits durchgeführte Berechnung oder Rückgabe und stellen keinen separaten Echtzeit-Feed des Match-Status dar.

Rückruf ist optional. Ein Partner kann nur durch Umfragen arbeiten. Für den Rückruf muss der Manager die Funktion aktivieren und callback_secret erstellen; Die URL wird in jedem erstellten Coupon mitgesendet.

Der Partner bestimmt die Callback-URL selbstständig. In der Produktion sollte https:// verwendet werden; In einer Testumgebung ist http:// zulässig.

Das System sendet:

POST {callback_url}
Content-Type: application/json
X-Coupon-Signature: sha256=<hex_hmac_sha256>

Kurze Nutzlast:

{
  "event": "coupons.settled",
  "batchId": "d407e986f3a64d9d36a77bf532322ef8",
  "couponCount": 1,
  "coupons": [
    {
      "coupon_code": "000000000272",
      "realWin": 18.5,
      "calculate_coefficient": 1.85,
      "status": 2,
      "calculate_date": 1784973600000,
      "events_data": [
        {
          "uuid": "912",
          "status": 1,
          "calculate_coefficient": 1.85,
          "calculate_date": 1784973600000,
          "calculate_score": "2:1",
          "settlement_reason_code": "REMOTE_WIN",
          "settlement_reason": "Win",
          "timer": 0
        }
      ]
    }
  ]
}

Obligatorische Regeln:

1. Berechnen Sie sha256=<hex(HMAC-SHA256(raw_body, callback_secret))> aus den genauen Quellbytes des Körpers vor der JSON-Analyse und vergleichen Sie Signaturen auf sichere Weise.
2. alle Artikel verarbeiten coupons, das Paket kann bis zu 100 Coupons enthalten;
3. Speichern Sie batchId mit einem eindeutigen Index.
4. wiederholtes batchId sollte die Abschreibung oder Rückstellung nicht wiederholen;
5. ein coupon_code kann während der progressiven Berechnung und Neuberechnung mit unterschiedlichen batchId kommen;
6. Geben Sie HTTP 200 erst zurück, nachdem das gesamte Paket sicher gespeichert wurde.

Die minimale erfolgreiche Antwort ist ein leeres HTTP 200. Fortgeschritten:

{
  "success": true,
  "processed": 1
}

processed muss gleich couponCount sein. Die Antworten 201, 202 und 204 gelten als nicht erfolgreich.

Wiederholungen werden nur bei Zeitüberschreitung, Transportfehler oder HTTP durchgeführt. 500, 502, 503, 504: sofort, dann nach 1, 5, 15 und 60 Minuten – nicht mehr als fünf Sendungen. Es gibt keinen automatischen Wiederholungsversuch bei HTTP 200 mit success: false oder teilweisem processed.

Überprüfen Sie auch bei Rückruf regelmäßig die Ergebnisse:

GET /api/partner/coupons/calculated?time=10

Nach einer Pause von mehr als 120 Minuten verwenden Sie POST /api/partner/coupons/results über gespeicherte coupon_ids oder Erstellungszeiträume bis zu 24 Stunden. Um das gleiche Vermögen noch einmal zu erhalten, sollten keine Finanztransaktionen wiederholt werden.

• Login, Passwort, JWT und callback_secret nur auf dem Server speichern;
• Übergeben Sie kein JWT in der URL und schreiben Sie nicht das vollständige Token in die Protokolle.
• Verwenden Sie für Geld den Dezimaltyp.
• Speichern Sie coupon_code als Zeichenfolge.
• Speichern Sie amount, die erforderlichen Gebotsdaten und currency, falls verwendet.
• zwischen Coupon- und Gebotsstatus unterscheiden;
• Akzeptieren Sie unbekannte Felder und Ursachencodes ohne Fehler.
• Machen Sie alle Finanztransaktionen der Endbenutzer idempotent.

Alte Routen werden weiterhin unterstützt, neue Integrationen müssen jedoch /api/partner/** verwenden. Alte Antworten und Fehler haben unterschiedliche Formate. Um einen vorhandenen Client zu aktualisieren, verwenden Sie eine einzelne Datei „Migration von der alten API“.

Cashout befindet sich in der Entwicklung, ist noch nicht vollständig getestet und wird nicht für die Produktion empfohlen.

• Erhalten Sie BASE_URL, Login und Passwort.
• JWT wird als Bearer-Token übertragen.
• Die Zeiger werden unverändert aus der Zeile übernommen.
• Der Warenkorb wird erst nach code = 1 als akzeptierter Coupon gespeichert.
• Verarbeitet multi, ausdrückliche Einschränkungen und Fehler 501–507.
• Die automatische Abschreibung des Kundenguthabens wurde berücksichtigt.
• Alle coupon_code und Gebots-IDs werden gespeichert.
• Die endgültige Auszahlung erfolgt aus real_win.
• Der Rückruf wird anhand der Quellbytes überprüft und mit batchId dedupliziert.
• Backup-Polling wurde konfiguriert.
• Das Benutzerguthaben ist vom Kundenguthaben SportAPI getrennt.

Die ausführliche Dokumentation beginnt mit API-Übersicht. Die vollständige Endpunktkarte finden Sie im Handbuch.