# 彩票圖庫 API 规格

#### 1. 接口都有开启 CORS 跨域设定與白名單，請通知我方開啟白名單。
#### 2. 圖片CDN位置有可能會更換，請與我方獲取最新CDN位置

## API 网址

| 环境 | URL |
|------|------|
| 正式（Cloudflare 线路） | api.592nike.com |
| 正式（GoEdge 防封线路） | api.disans.xyz |
| 正式（CN2 线路） | api.sk226.com |

## 彩种代码

| 彩种 | 代码
|------|------
| 香港六合彩 | HK
| 香港六十彩 | HK_60
| 澳门六合彩 | MO
| 澳门六十彩 | MO_60

## 色彩代码

| 色彩 | 代码
|------|------
| 彩色 | colorful
| 黑白 | black_white

## 尺寸代码

| 尺寸 | 代码
|------|------
| 縮圖 | small

## HTTP 接口

### 1. 取得圖庫系列列表

接口 URL：`https://{api_url}/picture/gallery/list?color={color}&country={country_code}`

| 参数 | 说明 |
|------|------|
| country_code | 彩种代码，必填 |
| color | 顏色，必填 |

[
    {
        "letter": "A",
        "pictures": [
            {
                "period": "366",
                "picture_name": "信封圖跑狗"
            },
            {
                "period": "366",
                "picture_name": "博彩跑狗神算王"
            },
            {
                "period": "366",
                "picture_name": "正版西遊記跑狗"
            }
        ]
    }
]

| 栏位 | 说明 |
|------|------|
| letter | 圖片系列名稱索引 |
| pictures | 圖片系列列表 |
| pictures.period | 圖片系列最新期數 |
| pictures.picture_name | 圖片系列名稱 |

### 2. 取得圖片資訊

接口 URL：`https://{api_url}/picture/detail?country={country_code}&picture_name={picture_name}&period={period}&size={small}`

| 参数 | 说明 |
|------|------|
| country_code | 彩种代码，必填 |
| picture_name | 圖片系列名稱，必填 |
| period | 圖片期數，必填 |
| size | 縮圖，非必填 |

{
    "image_path": "MO60/image/2023/A/A71/A71_029",
    "height": 694,
    "width": 1001
}

| 栏位 | 说明 |
|------|------|
| image_path | 圖片路徑 |
| height | 圖片高度 |
| width | 圖片寬度 |

### 3. 一次獲取指定期數圖片資訊

接口 URL：`https://{api_url}/picture/home?country={country_code}&size={size}&color={color}&period={period}`

| 参数 | 说明 |
|------|------|
| country_code | 彩种代码，必填 |
| period | 圖片期數，必填 |
| size | 縮圖，非必填 |
| color | 圖片顏色，必填 |

{
    "country": "HK",
    "current_year": "2024",
    "period": "1",
    "pictures": [
        {
            "height": 744,
            "width": 300,
            "picture_url": "HK49/image/2024/R/R03/R03_365_s",
            "picture_name": "正版四不像",
            "id": 630115
        },]
}

| 栏位 | 说明 |
|------|------|
| picture_url | 圖片路徑 |
| height | 圖片高度 |
| width | 圖片寬度 |
| picture_name | 圖片名稱 |
| current_year | 目前年份 |
| period |期數