README.md

introdução

888sports-api é uma api esportiva baseada em 888sports © que fornece varias opções de esportes e informações em tempo real para serem consumidas atraves de aplicações e sistemas. Uma api de resposta rapida com todas as informações de esports, tais como Odds de mercado.

instalação

• Nota: Para instalação do serviço, é preciso ter node.js instalado em sua maquina de desenvolvimento tal como NPM na versão mais atual.

para aplicar esta biblioteca em seu projeto, execute o comando:

~# npm install 888sports-api --save

Uso

Os metodos de uso são diversos. Mas inicialmente, é preciso contruir um novo escopo de requisição:

/** 
*  Dentro do contructor, é possivel
*  passar informações de configuração
*  como lingua, moeda de cotação,
*  time-zone, entre outros.
*/
const bets = require('888sports-api');
const sport = new bets(); 

webConfig

Para definir o escopo de configuração geral, utilize:

// é possivel definir um novo escopo de configuração caso seja necessario.
// este metodo é importante, pois através dele é possivel obter os cookies de acesso.
sport.webConfig().then(rest => {
     console.log(rest)
})

• Nota: Todas as requisições precisam do cookie gerado pelo parametro webConfig

exemplo:

sport.webConfig().then(async (rest) => {
     console.log(rest.cookie)//cookie em formato de texto
     var sp = await sport.allSports(rest.cookie);//cookie passado no escopo da requisição
     console.log(sp)//resposta
})

O retorno esperado seria:

{
  preplay: [
    { event_id: 1335422, markets: [Array] },
    { event_id: 1335426, markets: [Array] },
    { event_id: 1335427, markets: [Array] },
    { event_id: 1335428, markets: [Array] },
    { event_id: 1335429, markets: [Array] },
    { event_id: 1335430, markets: [Array] },
    { event_id: 1335431, markets: [Array] }
  ],
  selections: {
    '941722': [ [Object], [Object], [Object] ],
    '941725': [ [Object], [Object], [Object] ],
    '941726': [ [Object], [Object], [Object] ],
    '941730': [ [Object], [Object], [Object] ],
    '962111': { '1383381': [Array], '1383384': [Array], '1383387': [Array] },
    '962132': { '1383381': [Array], '1383384': [Array], '1383387': [Array] },
    '962145': { '1383381': [Array], '1383384': [Array], '1383387': [Array] },
    '962168': { '1383381': [Array], '1383384': [Array], '1383387': [Array] },
    '970659': { '1383381': [Array], '1383384': [Array], '1383387': [Array] },
    '970695': { '1383381': [Array], '1383384': [Array], '1383387': [Array] },
    '970701': { '1383381': [Array], '1383384': [Array], '1383387': [Array] },
    '970713': { '1383381': [Array], '1383384': [Array], '1383387': [Array] }
  },
  live_events: [
    {
      count: 102,
      sport: 'football',
      sport_id: 2,
      sport_slug_i18n: 'futebol'
    }
  ],
  sports: [
    {
      market_type: 'default',
      name: 'Futebol',
      grouped_market_ids: [],
      market_id: 1408196,
      tournaments: [Array],
      id: 2,
      columns: 3,
      slug: 'football',
      usesThreeMarketView: false,
      default_market_headers: [Object],
      competitor_sides: [Array]
    }
  ],
  markets_headers: {
    '1350707': { '1': '1', '2': '2' },
    '1384135': { '1': '1', '2': '2' }
  },
  virtual_games: [
    {
      tournament_id: 365516,
      event_id: 820169,
      tournament_name: 'Futebol Virtual',
      sport_name: 'Esportes Virtuals',
      game_slug: 'virtual-football',
      game_name: 'Futebol Virtual',
      active: 1,
      game_id: '2060',
      category_id: 48228,
      sport_id: 900,
      category_name: 'Futebol Virtual'
    }
}

breadcrumbs

este metodo mostra a atual seleção configurada.

sport.breadcrumbs({ "id": 2, "label": "Football", "slug": "football" }, 'cookies').then(rest => {
     console.log(rest)
})

inPlayEvent

Para obter as informações de Ao-vivo resumidas:

sport.inPlayEvent('football', 'cookies').then(rest => {
     console.log(rest)
})

byDate

Este metodo server para obter dados de eventos a partir da data. você pode definir a data a partir do formato yyyy-mm-dd:

sport.byDate('2022-02-12', 'cookies').then(rest => {
     console.log(rest)
})

featured

para obter informações de eventos apresentados.

sports.featured('cookies').then(rest => {
     console.log(rest)
})

getVirtualGames

para obter dados de sports virtuais

sports.getVirtualGames('cookies').then(rest => {
     console.log(rest)
})

getFeaturedMatchesEvents

para obter detalhes de todos os eventos ao-vivo

sports.getFeaturedMatchesEvents('football', {
     country: 'BRA', // lang
     widget_label: 'Featured Football' // information
}, cookies).then(rest => {
     console.log(rest)
})

allSports

Para obter informações de todos os esportes

sports.allSports('cookies').then(rest => {
     console.log(rest)
})

getPopularEvents

Para obter os eventos mais populares e procurados.

sports.getPopularEvents('cookies').then(rest => {
     console.log(rest)
})

sportBook

Para obter o book de apostas.

sports.sportBook('BRA', 'cookies').then(rest => {
     console.log(rest)
})

fetchEvents

Para buscar um determinado evento e suas informações (odds, mercados, informações, estatisticas e etc).

sports.fetchEvents({
     tournamentSlug: 'concacaf-league',
     categorySlug: 'americas',
     sportSlug: 'football',
     fromTime: '2021-10-22T02:45:00',
     toTime: '2021-11-05T02:45:00',
     tournamentId: 341262,
     eventId: 1349631,
     categoryId: 29850,
     sportId: 2
}, 'cookies').then(rest => {
     console.log(rest)
})

event

Para capiturar informações de um determinado evento.

//as IDs de enevnto podem ser obtidas atraves do metodo 'allsports'
sports.event(1349631).then(rest => {
     console.log(rest)
})

urlPath

Buscar informações atraves de uma URI especifica

sports.urlPath('/au-vivo/mercados_partida/1349631-ipe-1349631/', 'cookies').then(rest => {
     console.log(rest)
})

queryHost

Para fazer uma requisição atraves de uma URL especifica do servidor.

sports.queryHost('URL', 'BODY', {query: ''}, 'cookies').then(rest => {
     console.log(rest)
})

Contatos do desenvolvedor.

• Telegram: @VictorRatts