Oranlar, bahisler ve kuponlar — API teknik dokümantasyonu

• temel URL API’si;
• müşteri hesabı kullanıcı adı ve şifresi;
• geri aramayı kullanırken - işlevi ve callback_secret gizli ifadesini etkinleştirin.

Örneklerde koşullu bir adres kullanılır:

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

Üretimde HTTPS kullanın. Tüm tarihler milisaniye cinsinden Unix zaman damgası olarak iletilir ve parasal değerler sabit hassasiyet olmadan ondalık sayılar olarak iletilir.

Başarı:

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

İş hatası genellikle HTTP 200 ile de birlikte gelir:

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

Her zaman HTTP kodunu, ardından code’yi ve ardından error_code’yi kontrol edin. error_message metnini yazılım anahtarı olarak kullanmayın.

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

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

login alanı uyumlu bir takma ad olan username olarak desteklenir.

Başarılı yanıt:

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

Tüm korumalı isteklerde şunu iletin:

Authorization: Bearer <jwt-token>

Temel giriş hataları:

Bu hatalar HTTP 200, code = 0’den döndürülür. Korumalı bir yöntemin HTTP 401’si, JWT’nin eksik, geçersiz, süresinin dolmuş veya iptal edilmiş olduğu anlamına gelir; Tekrar oturum açın. HTTP 403, uygunsuz rol veya erişimin reddedildiği anlamına gelir.

Seçilen her sonuç, spor serisinden hazır bir hat olarak iletilir:

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

Örnekler:

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

• line_type: line veya live;
• rate: toplam/handikap parametresi veya 0;
• player_id: isteğe bağlı oynatıcı kimliği;
• sınırlayıcılar # ve | desteklenir.

İşaretçiyi manuel olarak toplamayın veya düzeltmeyin - satırdan elde edilen değeri değiştirmeden iletin.

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
}

Oranlar

Sıradan, ekspres ve multi

Bir ekspres tren en fazla 15 etkinlik içerebilir. Ana maç, yarılar, periyotlar, kornerler, fauller ve diğer ilgili alt olaylar dahil olmak üzere aynı maça birden fazla bahis birleştiremezsiniz. Bu kombinasyon 506 değerini döndürür.

events_data içindeki kupon ve kabul edilen bahis verileriyle tam başarılı yanıt:

{
  "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"
}

Kupon alanları

Her öğe body.coupons[], oluşturulan ayrı bir kupondur.

Teklif alanları

events_data[]’nin her bir öğesi, kupon içinde kabul edilen belirli bir bahsi açıklar.

null değeri henüz hesaplanmamış veya mevcut olmayan veriler için normaldir. Bunu otomatik olarak 0 veya boş dizeyle değiştirmeyin.

Kuponun yalnızca code = 1 ve body.coupons’de nesnelerin varlığı durumunda kabul edildiğini düşünün. Bundan önce sepet bir ön seçimdir: seçim kaybolabilir, bloke edilebilir veya oranlar değişebilir.

Başarıdan sonra:

1. yalnızca ilkini değil, tüm body.coupons nesnelerini kaydedin;
2. coupon_code’yi baştaki sıfırlarla bir dize olarak saklayın;
3. gerekli verileri events_data’den kaydedin;
4. kuponu son kullanıcıyla eşleştirin;
5. kullanıcının mali işlemini ortağın sistemine kaydedin.

Tanımlayıcılar:

currency tam modelde ve geri aramada döndürülmez. Para birimi gerekiyorsa, değeri oluşturma isteğinden kaydedin.

501–504 için yeni API, body.changes[]’deki sorunlu oranları döndürür. Alan change_type: 1 - katsayı arttı, 2 - azaldı, null - yön geçerli değil.

Zaman aşımından sonra POST /coupons/place’yi körü körüne yeniden denemeyin: ilk istek kabul edilmiş olabilir ve yeniden denemek bir kopya oluşturacaktır.

Kodları kullanarak 100’e kadar değeri aktarabilirsiniz:

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

Veya oluşturma süresini 24 saatten fazla geçmeyin:

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

coupon_ids ve tarihleri ​​aynı sorguda birleştirmeyin. results, oluşturma zamanına göre filtreler ve calculated, son ödeme zamanına göre filtreler.

Kupon durumları:

Teklif durumları:

Son kullanıcıya mali tahakkuk sağlamak için hazır real_win’yi kullanın. potential_win’yi kullanmayın ve ödemeyi kendiniz yeniden hesaplamayın. Hesaplamadan önce, real_win, calculate_coef, calc_coef ve calculate_date, 0’ye değil, null’ye eşittir.

15 kuponunun ilk durumunda, eğer önceki sonuç zaten finansal olarak işlenmişse, iş ortağı bir kez daha amount’yi son kullanıcıdan borçlandırır, yeni bir nihai durum bekler ve yeni bir real_win tahsil eder. Operasyonları yeniden işlemeye karşı koruyun.

Tam modeldeki ve geri aramadaki her bahis şunları içerir:

Hesaplamadan önce her iki alan da null’ye eşittir. Yerelleştirilmiş bir bildirim için aşağıdaki gibi bir kod kullanın:

• MATCH_POSTPONED - maç ertelendi;
• MATCH_CANCELLED - maç iptal edildi;
• MARKET_PUSH - piyasa kurallarına göre iade.

Kod bilinmiyorsa kaydedin ve boş olmayan settlement_reason’yi yedek metin olarak kullanın. Ödemeyi nedene göre hesaplamayın; durumları ve real_win’yi kullanın.

Bu alanlar, halihazırda gerçekleştirilmiş olan hesaplamayı veya getiriyi açıklar ve eşleşme durumunun ayrı bir gerçek zamanlı akışı değildir.

Geri arama isteğe bağlıdır. Bir ortak yalnızca oylama yoluyla çalışabilir. Geri arama için yöneticinin işlevi etkinleştirmesi ve callback_secret oluşturması gerekir; URL, oluşturulan her kuponda gönderilir.

İş ortağı, geri arama URL’sini bağımsız olarak belirler. Üretimde https:// kullanılmalıdır; test ortamında http://’ye izin verilir.

Sistem şunu gönderir:

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

Kısa yük:

{
  "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
        }
      ]
    }
  ]
}

Zorunlu kurallar:

1. JSON ayrıştırmadan önce gövdenin tam kaynak baytlarından sha256=<hex(HMAC-SHA256(raw_body, callback_secret))>’yi hesaplayın ve imzaları güvenli bir şekilde karşılaştırın;
2. tüm öğeleri coupons işleyin, paket en fazla 100 kupon içerebilir;
3. batchId’yi benzersiz bir dizinle saklayın;
4. tekrarlanan batchId, silme veya tahakkukları tekrarlamamalıdır;
5. bir coupon_code, aşamalı hesaplama ve yeniden hesaplama sırasında farklı batchId ile birlikte gelebilir;
6. HTTP 200’yi yalnızca paketin tamamı güvenli bir şekilde saklandıktan sonra döndürün.

Minimum başarılı yanıt boş bir HTTP 200’dir. Gelişmiş:

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

processed, couponCount’ye eşit olmalıdır. 201, 202 ve 204 yanıtları başarılı sayılmaz.

Tekrarlar yalnızca zaman aşımı, aktarım hatası veya HTTP durumunda gerçekleştirilir. 500, 502, 503, 504: hemen, ardından 1, 5, 15 ve 60 dakika sonra - en fazla beş gönderim. success: false veya kısmi processed ile HTTP 200 üzerinde otomatik yeniden deneme yoktur.

Geri aramada bile sonuçları periyodik olarak kontrol edin:

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

120 dakikadan uzun bir aradan sonra, kaydedilen coupon_ids veya 24 saate kadar oluşturma süreleri üzerinden POST /api/partner/coupons/results’yi kullanın. Aynı serveti tekrar almak, finansal işlemleri tekrarlamamalıdır.

• kullanıcı adını, şifreyi, JWT ve callback_secret’yi yalnızca sunucuda saklayın;
• URL’de JWT’yi iletmeyin ve belirtecin tamamını günlüklere yazmayın;
• para için ondalık türü kullanın;
• coupon_code’yi bir dize olarak saklayın;
• amount’yi, gerekli teklif verilerini ve kullanılıyorsa currency’yi kaydedin;
• kupon ve teklif durumları arasında ayrım yapın;
• bilinmeyen alanları ve neden kodlarını hatasız kabul edin;
• Tüm son kullanıcı finansal işlemlerini bağımsız hale getirin.

Eski rotalar desteklenmeye devam ediyor ancak yeni entegrasyonların /api/partner/** kullanması gerekiyor. Eski yanıtlar ve hatalar farklı formatlara sahiptir. Mevcut bir istemciyi güncellemek için tek bir dosya kullanın “Eski API’den geçiş”.

Cashout geliştirme aşamasındadır, tam olarak test edilmemiştir ve üretim için önerilmez.

• BASE_URL, kullanıcı adı ve şifre alındı.
• JWT bir Taşıyıcı jetonu olarak iletilir.
• İşaretçiler değişiklik yapılmadan satırdan alınır.
• Sepet ancak code = 1 sonrasında kabul edilen bir kupon olarak kaydedilir.
• İşlendi multi, kısıtlamaları ve hataları ifade edin 501–507.
• Müşteri bakiyesinin otomatik olarak silinmesi dikkate alınmıştır.
• Tüm coupon_code ve teklif kimlikleri kaydedilir.
• Son ödeme real_win’den alınır.
• Geri arama, kaynak baytlarına göre kontrol edilir ve batchId kullanılarak tekilleştirilir.
• Yedek yoklama yapılandırıldı.
• Kullanıcı bakiyesi, müşteri bakiyesi SportAPI’den ayrıdır.

Ayrıntılı belgeler API’ye genel bakış ile başlar. Uç nokta haritasının tamamı manuel içindedir.