zituocn / lottery-period

使用golang实现的福彩、体彩的数字彩种期数算法及API接口

Lottery-Period

使用golang开发的福彩、体彩的数字彩种期数算法及API接口

特性

• 可输出API，供第三方程序调用；
• 也可修改代码，提供GRPC接口调用；
• 增加彩种或新的一年时，只需要修改项目中yaml内的配置文件；
• docker image(TODO)；

安装

go get -u github.com/zituocn/lottery-period

cd lottery-period
go run .

或

cd lottery-period
go build
./lottery-period # windows下执行 lottery-period.exe

docker 安装

docker pull gkzy/lottery-period
docker run -itd --restart=always --name lottery-period -p 8080:8080  gkzy/lottery-period 

API路由

接口路由说明

func APIRouter(r *gow.Engine) {
  r.NoRoute(handler.ErrorHandler)
  v1 := r.Group("/api")
  {
    v1.GET("/time", handler.GetOneByTime)     //根据时间取配置
    v1.GET("/period", handler.GetOneByPeriod) //根据期数取配置
    v1.GET("/list", handler.GetList)          //包括当前期数的小列表，即最近N期
    v1.GET("/today", handler.Today)           //今天开奖信息
    v1.GET("/game", handler.Game)             //彩种配置输出
    v1.GET("/year", handler.Year)             //年份配置输出
    v1.GET("/game/yaml", handler.GameYaml)    //彩种配置yaml输出
    v1.GET("/year/yaml", handler.YearYaml)    //年份配置yaml输出
  }
}

接口说明

分别就提供的接口做出的说明

1.根据时间取期数配置

接口

GET /api/time

参数

gamecode  int 彩种id
ts        int 时间戳，不传为当前时间
typeid    int -1=上一期 0=当前期 1=下一期

带参数

GET /api/time?gamecode=1&ts=1652001618&typeid=0

返回值

{
  "code": 0,
  "msg": "success",
  "time": 1657100708,
  "data": {
    "period": 2022118,
    "bt": "2022-05-08 21:15:00",
    "et": "2022-05-08 21:15:00",
    "at": "2022-05-08 21:15:00"
  }
}

2.根据期数取期数配置

接口

GET /api/period

参数

gamecode  int 彩种id
period    int 期数

带参数

GET /api/period?gamecode=1&period=2022150

返回值

{
  "code": 0,
  "msg": "success",
  "time": 1657100824,
  "data": {
    "period": 2022150,
    "bt": "2022-06-09 21:15:00",
    "et": "2022-06-09 21:15:00",
    "at": "2022-06-09 21:15:00"
  }
}

3.最近N期的小列表

接口

GET /api/list

参数

gamecode  int 彩种id
ts        int 时间戳，不传为当前时间
limit     int 返回的条数

带参数

GET /api/list?gamecode=1&limit=2&ts=1652001618

返回值

{
  "code": 0,
  "msg": "success",
  "time": 1657161545,
  "data": {
    "now": {
      "period": 2022118,
      "bt": "2022-05-08 21:15:00",
      "et": "2022-05-08 21:15:00",
      "at": "2022-05-08 21:15:00"
    },
    "recents": [
      {
        "period": 2022116,
        "bt": "2022-05-06 21:15:00",
        "et": "2022-05-06 21:15:00",
        "at": "2022-05-06 21:15:00"
      },
      {
        "period": 2022117,
        "bt": "2022-05-07 21:15:00",
        "et": "2022-05-07 21:15:00",
        "at": "2022-05-07 21:15:00"
      },
      {
        "period": 2022118,
        "bt": "2022-05-08 21:15:00",
        "et": "2022-05-08 21:15:00",
        "at": "2022-05-08 21:15:00"
      }
    ]
  }
}

4.查询所有彩种配置

可查询 gamecode

接口

GET  /api/game

返回值

{
  "code": 0,
  "msg": "success",
  "time": 1657100429,
  "data": [
    {
      "gamecode": 1,
      "oid": 1,
      "typeid": 1,
      "name": "福彩3D",
      "sname": "福彩3D",
      "ename": "fcsd",
      "opendate": "Monday,Tuesday,Wednesday,Thursday,Friday,Saturday,Sunday",
      "opentime": "21:15",
      "state": 0,
      "islocal": 0,
      "province": "",
      "formatqi": "YYYY,%.3d",
      "selist": null
    }...
  ]
}

5.查询所有年份配置

接口

GET  /api/year

返回值

{
  "code": 0,
  "msg": "success",
  "time": 1657161646,
  "data": [
    {
      "id": 1,
      "year": 2016,
      "selist": [
        {
          "stime": "2016-02-07",
          "etime": "2016-02-14"
        }
      ]
    },
    {
      "id": 1,
      "year": 2017,
      "selist": [
        {
          "stime": "2017-01-27",
          "etime": "2017-02-03"
        }
      ]
    },
    {
      "id": 1,
      "year": 2018,
      "selist": [
        {
          "stime": "2018-02-15",
          "etime": "2018-02-22"
        }
      ]
    },
    {
      "id": 2,
      "year": 2019,
      "selist": [
        {
          "stime": "2019-02-04",
          "etime": "2019-02-11"
        },
        {
          "stime": "2019-10-01",
          "etime": "2019-10-08"
        }
      ]
    },
    {
      "id": 3,
      "year": 2020,
      "selist": [
        {
          "stime": "2020-01-22",
          "etime": "2020-03-11"
        },
        {
          "stime": "2020-10-01",
          "etime": "2020-10-05"
        }
      ]
    },
    {
      "id": 4,
      "year": 2021,
      "selist": [
        {
          "stime": "2021-02-09",
          "etime": "2021-02-19"
        },
        {
          "stime": "2021-10-01",
          "etime": "2021-10-05"
        }
      ]
    },
    {
      "id": 5,
      "year": 2022,
      "selist": [
        {
          "stime": "2022-01-29",
          "etime": "2022-02-08"
        },
        {
          "stime": "2022-10-01",
          "etime": "2022-10-05"
        }
      ]
    }
  ]
}