Betflag Exchange API (2.0.6)

Download OpenAPI specification:Download

Authentication

api_key

Per ogni chiamata alle API deve essere valorizzato l'header X-BFkey con l'api key rilasciata da Betflag

Security Scheme Type	API Key
Header parameter name:	X-BFkey

SECURITY

Login/Logout

Login

Authorizations:

api_key

Request Body schema: application/json

Credenziali di accesso

Username	string
Pwd	string

Responses

Request samples

Payload

Content type

application/json

{"Username": "username di accesso Betflag",
"Pwd": "password di accesso Betflag"
}

Response samples

200

Content type

application/json

{"Balance": 7475,
"SessionToken": "90205160-600c-4cf8-9803-62fc14eee768",
"UserId": "13"
}

Logout

Authorizations:

api_key

header Parameters

X-BF-Session-Token

required

string

token di sessione

Responses

Refresh del token di sessione

Authorizations:

api_key

header Parameters

X-BF-Session-Token

required

string

token di sessione

Responses

NAVIGATION

Palinsesto exchange

Richiede il menu degli avvenimenti disponibili sull'exchange

Authorizations:

api_key

Responses

Response samples

200

Content type

application/json

{"d": [{"cs": 2,
"ds": "BASKET",
"n": [{"cn": 10,
"dn": "Argentina",
"m": [{"a": [{"a": 3877,
"da": "Obera Tenis Club - Regatas Corrientes",
"dt": "2020-12-13T18:00:00",
"id": 412756,
"l": 1,
"p": 30501
}
],
"cm": 74,
"dm": "Argentina - I Divisione"
}
]
}
]
},
{"cs": 1,
"ds": "CALCIO",
"n": [{"cn": 112,
"dn": "Italia",
"m": [{"a": [{"a": 2561,
"da": "Lazio - Hellas Verona",
"dt": "2020-12-12T20:45:00",
"id": 411222,
"l": 1,
"p": 30501
},
{"a": 1423,
"da": "Cagliari - Fc Inter Milano",
"dt": "2020-12-13T12:30:00",
"id": 411930,
"l": 1,
"p": 3050
}
],
"cm": 21,
"dm": "Serie A"
}
]
}
]
},
{"cs": 3,
"ds": "TENNIS",
"n": [{"cn": 199,
"dn": "Spagna",
"m": [{"a": [{"a": 39720,
"da": "Minc C / Zusman R - Jorda Sanchis D / Pla Malfeito",
"dt": "2020-12-10T15:00:00",
"id": 436617,
"l": 1,
"p": 30501
},
{"a": 39717,
"da": "Gakhov I / Veldheer M - Bellucci M / Nardi L",
"dt": "2020-12-10T15:40:00",
"id": 436614,
"l": 1,
"p": 30501
}
],
"cm": 722,
"dm": "Itf Spagna"
}
]
}
]
}
]
}

Richiede il menu degli avvenimenti live disponibili sull'exchange

Authorizations:

api_key

Responses

Response samples

200

Content type

application/json

{"d": [{"cs": 2,
"ds": "BASKET",
"n": [{"cn": 10,
"dn": "Argentina",
"m": [{"a": [{"a": 3877,
"da": "Obera Tenis Club - Regatas Corrientes",
"dt": "2020-12-13T18:00:00",
"id": 412756,
"l": 1,
"p": 30501
}
],
"cm": 74,
"dm": "Argentina - I Divisione"
}
]
}
]
},
{"cs": 1,
"ds": "CALCIO",
"n": [{"cn": 112,
"dn": "Italia",
"m": [{"a": [{"a": 2561,
"da": "Lazio - Hellas Verona",
"dt": "2020-12-12T20:45:00",
"id": 411222,
"l": 1,
"p": 30501
},
{"a": 1423,
"da": "Cagliari - Fc Inter Milano",
"dt": "2020-12-13T12:30:00",
"id": 411930,
"l": 1,
"p": 3050
}
],
"cm": 21,
"dm": "Serie A"
}
]
}
]
},
{"cs": 3,
"ds": "TENNIS",
"n": [{"cn": 199,
"dn": "Spagna",
"m": [{"a": [{"a": 39720,
"da": "Minc C / Zusman R - Jorda Sanchis D / Pla Malfeito",
"dt": "2020-12-10T15:00:00",
"id": 436617,
"l": 1,
"p": 30501
},
{"a": 39717,
"da": "Gakhov I / Veldheer M - Bellucci M / Nardi L",
"dt": "2020-12-10T15:40:00",
"id": 436614,
"l": 1,
"p": 30501
}
],
"cm": 722,
"dm": "Itf Spagna"
}
]
}
]
}
]
}

Richiede il menu degli avvenimenti prossimi al live disponibili sull'exchange

Authorizations:

api_key

Responses

Response samples

200

Content type

application/json

{"d": [{"cs": 2,
"ds": "BASKET",
"n": [{"cn": 10,
"dn": "Argentina",
"m": [{"a": [{"a": 3877,
"da": "Obera Tenis Club - Regatas Corrientes",
"dt": "2020-12-13T18:00:00",
"id": 412756,
"l": 1,
"p": 30501
}
],
"cm": 74,
"dm": "Argentina - I Divisione"
}
]
}
]
},
{"cs": 1,
"ds": "CALCIO",
"n": [{"cn": 112,
"dn": "Italia",
"m": [{"a": [{"a": 2561,
"da": "Lazio - Hellas Verona",
"dt": "2020-12-12T20:45:00",
"id": 411222,
"l": 1,
"p": 30501
},
{"a": 1423,
"da": "Cagliari - Fc Inter Milano",
"dt": "2020-12-13T12:30:00",
"id": 411930,
"l": 1,
"p": 3050
}
],
"cm": 21,
"dm": "Serie A"
}
]
}
]
},
{"cs": 3,
"ds": "TENNIS",
"n": [{"cn": 199,
"dn": "Spagna",
"m": [{"a": [{"a": 39720,
"da": "Minc C / Zusman R - Jorda Sanchis D / Pla Malfeito",
"dt": "2020-12-10T15:00:00",
"id": 436617,
"l": 1,
"p": 30501
},
{"a": 39717,
"da": "Gakhov I / Veldheer M - Bellucci M / Nardi L",
"dt": "2020-12-10T15:40:00",
"id": 436614,
"l": 1,
"p": 30501
}
],
"cm": 722,
"dm": "Itf Spagna"
}
]
}
]
}
]
}

Richiede i mercati disponibili per un avvenimento exchange

Authorizations:

api_key

path Parameters

id_avvenimento

required

integer <int64>

l'id dell'avvenimento di cui si richiedono i mercati

Responses

Response samples

200

Content type

application/json

{"cs": 1,
"ds": "CALCIO",
"cm": 21,
"dm": "Serie A",
"match_id": 411222,
"pal": 30501,
"cod": 2561,
"data": "2020-12-12T20:45:00",
"des": "Lazio - Hellas Verona",
"lg": 0,
"sco": [{"id_mercato": 19901289,
"data": "2020-12-12T20:45:00",
"des": "Esito Finale 1x2",
"iad": "",
"lv": 1,
"ab": 1000,
"di": 7900,
"esi": [{"cod": 1,
"des": "1"
},
{"cod": 2,
"des": "X"
},
{"cod": 3,
"des": "2"
}
]
},
{"id_mercato": 19998470,
"data": "2020-12-12T20:45:00",
"des": "Under And Over",
"iad": "1.5",
"lv": 1,
"ab": 0,
"di": 0,
"esi": [{"cod": 1,
"des": "UNDER"
},
{"cod": 2,
"des": "OVER"
}
]
},
{"id_mercato": 19998469,
"data": "2020-12-12T20:45:00",
"des": "Under And Over",
"iad": "2.5",
"lv": 1,
"ab": 0,
"di": 0,
"esi": [{"cod": 1,
"des": "UNDER"
},
{"cod": 2,
"des": "OVER"
}
]
}
]
}

OFFERS

Mercati e offerte

Richiede le offerte presenti su un mercato exchange

Authorizations:

api_key

path Parameters

id_mercato required	integer <int64> l'id del mercato di cui si richiedono le offerte
livello required	integer Enum: 1 2 3

Responses

Response samples

200

Content type

application/json

{"errore": "",
"esito": 1024,
"offerte": {"banca": [{"esi": [{"c": 1,
"d": "1",
"off": [{"i": 500,
"p": 1,
"q": 152
},
{"i": 800,
"p": 2,
"q": 151
},
{"i": 1000,
"p": 3,
"q": 150
}
]
},
{"c": 2,
"d": "X",
"off": [{"i": 500,
"p": 1,
"q": 325
},
{"i": 500,
"p": 2,
"q": 320
},
{"i": 500,
"p": 3,
"q": 300
}
]
},
{"c": 3,
"d": "2",
"off": [{"i": 400,
"p": 1,
"q": 600
},
{"i": 400,
"p": 2,
"q": 550
},
{"i": 700,
"p": 3,
"q": 500
}
]
}
]
}
],
"punta": [{"esi": [{"c": 1,
"d": "1",
"off": [{"i": 200,
"p": 1,
"q": 158
},
{"i": 200,
"p": 2,
"q": 160
},
{"i": 500,
"p": 3,
"q": 162
}
]
},
{"c": 2,
"d": "X",
"off": [{"i": 400,
"p": 1,
"q": 330
},
{"i": 200,
"p": 2,
"q": 335
},
{"i": 200,
"p": 3,
"q": 340
}
]
},
{"c": 3,
"d": "2",
"off": [{"i": 500,
"p": 1,
"q": 650
},
{"i": 200,
"p": 2,
"q": 700
},
{"i": 200,
"p": 3,
"q": 750
}
]
}
]
}
],
"scambiate": 1000,
"stato_betflag": 2,
"stato_sogei": 2,
"versione": 2,
"live": "true",
"ritardo_live": 5,
"data": "2021-03-10T20:45:00"
}
}

Richiede l'esposizione su un mercato exchange

Authorizations:

api_key

path Parameters

id_mercato

required

integer <int64>

l'id del mercato di cui si richiede l'esposizione

header Parameters

X-BF-Session-Token

required

string

token di sessione

Responses

Response samples

200

Content type

application/json

{"errore": "",
"esito": 1024,
"esposizione": {"esi": [{"cod": 1,
"con": 225,
"pro": -1239
},
{"cod": 2,
"con": -1080,
"pro": 45
},
{"cod": 3,
"con": -480,
"pro": 3210
}
],
"tax": 251
}
}

Richiede le offerte piazzate dall'utente su un mercato exchange

Authorizations:

api_key

path Parameters

id_mercato

required

integer <int64>

l'id del mercato di cui si richiedono le offerte

header Parameters

X-BF-Session-Token

required

string

token di sessione

Responses

Response samples

200

Content type

application/json

{"errore": "",
"esito": 1024,
"offerte": {"o": [{"abb": 500,
"dat": "2020-12-10T17:58:59",
"des": "1",
"esi": 1,
"ex": 500,
"id": "BC000000000054EC8C01",
"imp": 500,
"mnt": 0,
"quo": 155,
"rit": 1,
"st": 3,
"tipo": 1
},
{"abb": 0,
"dat": "2020-12-10T18:02:35",
"des": "X",
"esi": 2,
"ex": 1125,
"id": "BB000000000035964A01",
"imp": 500,
"mnt": 0,
"quo": 325,
"rit": 1,
"st": 1,
"tipo": 0
},
{"abb": 0,
"dat": "2020-12-10T18:02:45",
"des": "2",
"esi": 3,
"ex": 2000,
"id": "BB000000000035964B01",
"imp": 400,
"mnt": 0,
"quo": 600,
"rit": 1,
"st": 1,
"tipo": 0
}
]
},
"stato_betflag": 2,
"stato_sogei": 2,
"versione": 1,
"live": "true",
"ritardo_live": 5,
"data": "2021-03-10T20:45:00"
}

Richiede le offerte abbinate piazzate dall'utente su un mercato exchange

Authorizations:

api_key

path Parameters

id_mercato

required

integer <int64>

l'id del mercato di cui si richiedono le offerte abbinate

header Parameters

X-BF-Session-Token

required

string

token di sessione

Responses

Response samples

200

Content type

application/json

{"errore": "",
"esito": 1024,
"abbinamenti": {"a": [{"id": "BA000000000014AC7B08",
"id_offerta": "BC000000000054EC8C01",
"tipo": 1,
"esi": 1,
"des": "1",
"quo": 175,
"imp": 1200,
"dat": "2021-10-10T12:58:59"
},
{"id": "BA000000000014AC7D08",
"id_offerta": "BC000000000055EC8C01",
"tipo": 1,
"esi": 1,
"des": "1",
"quo": 210,
"imp": 800,
"dat": "2021-10-10T13:06:12"
}
]
},
"stato_betflag": 2,
"stato_sogei": 2,
"versione": 1,
"live": "true",
"ritardo_live": 5,
"data": "2021-10-10T13:00:00"
}

Piazza una o piú offerte su un mercato exchange

Authorizations:

api_key

header Parameters

X-BF-Session-Token

required

string

token di sessione

Request Body schema: application/json

Offerte da piazzare

id_mercato required	integer <int64> identificativo del mercato su cui si vogliono piazzare le offerte
versione_mercato	integer Default: 0 versione mercato
puntata required	integer importo totale della giocata espresso in centesimi
ritira	integer Default: 0 Enum: 0 1 Descrive la modalitá con cui il sistema deve trattare le offerte piazzate nel passaggio tra pre-match a live 0 - le offerte piazzate non saranno automaticamente eliminate al passaggio del mercato da pre-match a live 1 - le offerte piazzate saranno automaticamente eliminate al passaggio del mercato da pre-match a live
mantieni	integer Default: 0 Enum: 0 1 Descrive la modalitá con cui il sistema tratterá le offerte piazzate in caso di sospensioni del mercato (solo per i live gestiti) 0 - le offerte saranno automaticamente eliminate a seguito di sospensioni del mercato (solo per i live gestiti) 1 - le offerte non saranno eliminate automaticamente a seguito di sospensioni del mercato
required	Array of objects (Offerta2Place)

Responses

Request samples

Payload

Content type

application/json

{"id_mercato": 813016,
"puntata": 74300,
"ritira": 0,
"mantieni": 0,
"offerta": [{"tipo": 1,
"esito": 1,
"quota": 179,
"importo": 14100,
"max_esposizione": 14100
},
{"tipo": 1,
"esito": 1,
"quota": 180,
"importo": 7000,
"max_esposizione": 7000
},
{"tipo": 1,
"esito": 1,
"quota": 181,
"importo": 100,
"max_esposizione": 100
},
{"tipo": 0,
"esito": 1,
"quota": 176,
"importo": 11500,
"max_esposizione": 8740
},
{"tipo": 0,
"esito": 1,
"quota": 175,
"importo": 5100,
"max_esposizione": 3825
},
{"tipo": 0,
"esito": 1,
"quota": 174,
"importo": 4200,
"max_esposizione": 3108
},
{"tipo": 1,
"esito": 2,
"quota": 231,
"importo": 600,
"max_esposizione": 600
},
{"tipo": 1,
"esito": 2,
"quota": 233,
"importo": 6300,
"max_esposizione": 6300
},
{"tipo": 1,
"esito": 2,
"quota": 236,
"importo": 3100,
"max_esposizione": 3100
},
{"tipo": 0,
"esito": 2,
"quota": 228,
"importo": 12300,
"max_esposizione": 15744
},
{"tipo": 0,
"esito": 2,
"quota": 227,
"importo": 6500,
"max_esposizione": 8255
},
{"tipo": 0,
"esito": 2,
"quota": 226,
"importo": 3500,
"max_esposizione": 4410
}
]
}

Response samples

200

Content type

application/json

{"errore": "",
"esito": 1024,
"ordine": [{"abbinato": 0,
"importo": 14100,
"offerta": "BC0000000029E76EA604",
"tipo": 1
},
{"abbinato": 0,
"importo": 7000,
"offerta": "BC000000004682AD4E03",
"tipo": 1
},
{"abbinato": 0,
"importo": 100,
"offerta": "BC0000000029E76EB004",
"tipo": 1
},
{"abbinato": 0,
"importo": 11500,
"offerta": "BB000000002C0F362F04",
"tipo": 0
},
{"abbinato": 0,
"importo": 5100,
"offerta": "BB000000004BFFDBC803",
"tipo": 0
},
{"abbinato": 0,
"importo": 4200,
"offerta": "BB000000004BFFDBCB03",
"tipo": 0
},
{"abbinato": 0,
"importo": 600,
"offerta": "BC0000000029E76EB404",
"tipo": 1
},
{"abbinato": 0,
"importo": 6300,
"offerta": "BC000000004682AD5C03",
"tipo": 1
},
{"abbinato": 0,
"importo": 3100,
"offerta": "BC000000004682AD5D03",
"tipo": 1
},
{"abbinato": 0,
"importo": 12300,
"offerta": "BB000000004BFFDBD303",
"tipo": 0
},
{"abbinato": 0,
"importo": 6500,
"offerta": "BB000000004BFFDBD503",
"tipo": 0
},
{"abbinato": 0,
"importo": 3500,
"offerta": "BB000000006820F80402",
"tipo": 0
}
]
}

Elimina una o piú offerte da un mercato exchange

Authorizations:

api_key

header Parameters

X-BF-Session-Token

required

string

token di sessione

Request Body schema: application/json

Offerte da eliminare

id_mercato required	integer <int64> identificativo del mercato da cui si vogliono eliminare le offerte
required	Array of objects (Offerta2Delete)

Responses

Request samples

Payload

Content type

application/json

{"id_mercato": 813016,
"offerte": [{"id": "BB000000002C0F364304"
},
{"id": "BB000000002C0F364604"
}
]
}

Response samples

200

Content type

application/json

{"errore": "",
"esito": 1024,
"offerta": [{"esito_giocato": 1,
"id": "BB000000002C0F364304",
"importo": 6600,
"max_esposizione": 13134,
"quota": 299,
"restituito": 13134,
"tipo_offerta": 0
},
{"esito_giocato": 1,
"id": "BB000000002C0F364604",
"importo": 4300,
"max_esposizione": 8514,
"quota": 298,
"restituito": 8514,
"tipo_offerta": 0
}
]
}

Elimina tutte le offerte non abbinate da un mercato exchange

Authorizations:

api_key

header Parameters

X-BF-Session-Token

required

string

token di sessione

Request Body schema: application/json

Offerte da eliminare

id_mercato

required

integer <int64>

identificativo del mercato da cui si vogliono eliminare le offerte non abbinate

Responses

Request samples

Payload

Content type

application/json

{"id_mercato": 813016
}

Response samples

200

Content type

application/json

{"errore": "",
"esito": 1024,
"offerta": [{"id": "BB000000002C0F364304"
},
{"id": "BB000000002C0F364604"
}
]
}

Richiede le offerte piazzate dall'utente ancora aperte su un mercato exchange

Authorizations:

api_key

path Parameters

id_mercato

required

integer <int64>

l'id del mercato di cui si richiede l'esposizione

header Parameters

X-BF-Session-Token

required

string

token di sessione

Responses

Response samples

200

Content type

application/json

{"errore": "",
"esito": 1024,
"stato_sogei": 2,
"stato_betflag": 2,
"versione": 3,
"live": "true",
"ritardo_live": 5,
"data": "2021-03-10T20:45:00",
"o": [{"id": "BC0000000046559B0E03",
"tipo": 1,
"esi": 1,
"des": "UNDER",
"quo": 159,
"imp": 3200,
"ex": 3200,
"abb": 0,
"dat": "2020-12-12T10:20:40",
"st": 1,
"rit": 0,
"mnt": 0
},
{"id": "BB000000004BD3B42C03",
"tipo": 0,
"esi": 1,
"des": "UNDER",
"quo": 149,
"imp": 4800,
"ex": 2352,
"abb": 0,
"dat": "2020-12-12T10:20:41",
"st": 1,
"rit": 0,
"mnt": 0
},
{"id": "BC0000000046559B1103",
"tipo": 1,
"esi": 2,
"des": "OVER",
"quo": 328,
"imp": 4000,
"ex": 4000,
"abb": 0,
"dat": "2020-12-12T10:20:41",
"st": 1,
"rit": 0,
"mnt": 0
},
{"id": "BB000000004BD3B43003",
"tipo": 0,
"esi": 2,
"des": "OVER",
"quo": 281,
"imp": 6600,
"ex": 11946,
"abb": 0,
"dat": "2020-12-12T10:20:41",
"st": 1,
"rit": 0,
"mnt": 0
},
{"id": "BB000000004BD3B43103",
"tipo": 0,
"esi": 2,
"des": "OVER",
"quo": 278,
"imp": 4200,
"ex": 7476,
"abb": 0,
"dat": "2020-12-12T10:20:41",
"st": 1,
"rit": 0,
"mnt": 0
}
]
}

ACCOUNT

Info utente e conto

Richiede info sull'account

Authorizations:

api_key

header Parameters

X-BF-Session-Token

required

string

token di sessione

Responses

Response samples

200

Content type

application/json

{"AnnoNascita": 0,
"AnnoRilascio": 0,
"CAPResidenza": "string",
"Cittadinanza": 0,
"Codice": "string",
"CodiceFiscale": "string",
"Cognome": "string",
"ComuneNascita": "string",
"ComuneResidenza": "string",
"Email": "string",
"GiornoNascita": 0,
"GiornoRilascio": 0,
"IndirizzoResidenza": "string",
"LocalitaRilascio": "string",
"MailValidata": 0,
"MeseNascita": 0,
"MeseRilascio"": 0,
"Mobile": "string",
"MobileValidato": 0,
"NazioneNascita": 0,
"NazioneResidenza": 0,
"NewsBonusPromozioni": 0,
"NewsSms": 0,
"Nome": "string",
"NumeroDocumento": "string",
"ProvinciaNascita": "string",
"ProvinciaResidenza": "string",
"Sesso": "string",
"Stato_conto": 0,
"Telefono": "string",
"TipoDocumento": "string",
"Username": "string",
"conto_gioco": "string",
"contratto_ricevuto": 0,
"documento_ricevuto": 0,
"id_domanda_segreta": 0,
"risposta_segreta": 0
}

Richiede il saldo dell'account

Authorizations:

api_key

header Parameters

X-BF-Session-Token

required

string

token di sessione

Responses

Response samples

200

Content type

application/json

{"Balance": 42473,
"FreeBalance": 42473,
"FunBalance": 80000,
"LockedBalance": 0
}

Richiede la commissione applicata all'account

Authorizations:

api_key

header Parameters

X-BF-Session-Token

required

string

token di sessione

Responses

Response samples

200

Content type

application/json

{"errore": "",
"esito": 1024,
"tax": 251
}