# 帐户系统

## 1.验证码生成

1.1 接口 `https://api.goowee.cn/v1/users/code`

1.2 请求方式 POST

1.3 输入

```conf
{"username": "13611778890", "type": 1}
```

| 字段名称     | 类型      | 字段必须     | 备注                                |
| -------- | ------- | -------- | --------------------------------- |
| username | string  | required | 用户名称                              |
| type     | integer | required | 短信类型 值为：1:登录与注册，2:修改帐号验证码，3，4，5，6 |

```conf
type 可能的值说明：
1     :   "身份验证验证码"
2     :   "修改帐号验证码"
4     :   "帐号注销验证码"
```

1.4 输出

```conf
{
    "code":0,
    'message': "OK"
}
'message': "参数错误"
'message': "验证码发送过于频繁"
'message': "新用户不能找回密码，请选择其他登录方式"
```

1.5. 接口测试

```conf
# 1. 线上
curl -i -X POST \
-d "username=13611778890&type=1" \
https://api.goowee.cn/v1/users/code
```

## 1. 验证码验证

1.1 接口 `https://api.goowee.cn/v1/users/check/code`

1.2 请求方式 POST

1.3 输入

```conf
{"username": "13611778890", "type": 2, "code": 1221}
```

| 字段名称     | 类型      | 字段必须     | 备注                                |
| -------- | ------- | -------- | --------------------------------- |
| username | string  | required | 用户名称                              |
| type     | integer | required | 短信类型 值为：1:登录与注册，2:修改帐号验证码，3，4，5，6 |
| code     | integer | required | 验证码                               |

```conf
type 可能的值说明：
1     :   "身份验证验证码"
2     :   "修改帐号验证码"
```

1.4 输出

```conf
{
    "code":0,
    'message': "OK"
    "data": {
        "check": 1 or 0
    }
}
check 1 通过
check 0 不通过
```

1.5. 接口测试

```conf
# 1. 线上
curl -i -X POST \
-d "username=13611778896&type=2&code=1122" \
https://api.goowee.cn/v1/users/check/code
```

## 2 用户登录+注册

2.1 接口 `https://api.goowee.cn/v1/users/signIn` 2.2 请求方式 POST

2.3 输入

```conf
# 登录1——验证码方式
{"username": "13611778890", code: "111111", visitorId: 'abcdefg'}

# 游客绑定手机时用
```

| 字段名称      | 类型     | 字段必须               | 备注                                                |
| --------- | ------ | ------------------ | ------------------------------------------------- |
| username  | string | required           | 用户名称                                              |
| code      | string | required or option | 验证码                                               |
| visitorId | string | option             | 前端生成的随机Id（设备Id），用于确定哪个游客，androidId or idfa，游客注册专用 |

2.4. 输出

```conf
{
    "code":0,
    "message":"OK",
    "data":{
        "userInfo":{
            "userId":"740699410",
            "username":"13611778890",
            "nickname":"136******56",
            "visitorId": "abc",
            "gender":"0",
            "birthday":"",
            "keys":"0",
            "icon":"",
            "new":"0"
        },
        "token":"6c6b11b2-ee0b-4825-831b-f3d696677387",
        "expire":0
    }
}
```

* userInfo信息结构说明

| 字段名称      | 类型      | 字段必须               | 备注         |
| --------- | ------- | ------------------ | ---------- |
| userId    | string  | require            | 用户Id       |
| username  | string  | required           | 用户名称       |
| nickname  | string  | required or option | 用户昵称       |
| gender    | integer | required           | 性别 1:男 2:女 |
| visitorId | string  | required           | 游客Id       |
| birthday  | string  | required           | 生日         |
| keys      | integer | required           | 钥匙         |
| icon      | string  | required           | 用户头像       |
| new       | integer | required           | 是否新用户      |

* token 为当前session信息
* expire session过期时间

2.5. 接口测试

```conf
1. 线上测试
curl -i -X POST \
-d "username=13611778890&code=2889" \
https://api.goowee.cn/v1/users/signIn

```

## 21 华为用户登录+注册

2.1 接口 `https://api.goowee.cn/v1/users/hw/signIn` 2.2 请求方式 POST

2.3 输入

```conf
# 登录1——验证码方式
{code: "DwEEAPu+7D7Yw4h/g2C0ZzlOCGm4c0UM/ZX7soetFPs25uSRpprL...", visitorId: 'abcdefg'}

# 游客绑定手机时用
```

| 字段名称      | 类型     | 字段必须     | 备注                                                |
| --------- | ------ | -------- | ------------------------------------------------- |
| code      | string | required | 华为 authorization code                             |
| visitorId | string | option   | 前端生成的随机Id（设备Id），用于确定哪个游客，androidId or idfa，游客注册专用 |

2.4. 输出

```conf
{
    "code":0,
    "message":"OK",
    "data":{
        "userInfo":{
            "userId":"740699410",
            "username":"13611778890",
            "nickname":"136******56",
            "visitorId": "abc",
            "gender":"0",
            "birthday":"",
            "keys":"0",
            "icon":"",
            "new":"0",
            "access_token": "",
        },
        "token":"6c6b11b2-ee0b-4825-831b-f3d696677387",
        "expire":0
    }
}
```

* userInfo信息结构说明

| 字段名称          | 类型       | 字段必须               | 备注         |
| ------------- | -------- | ------------------ | ---------- |
| userId        | string   | require            | 用户Id       |
| username      | string   | required           | 用户名称       |
| nickname      | string   | required or option | 用户昵称       |
| gender        | integer  | required           | 性别 1:男 2:女 |
| visitorId     | string   | required           | 游客Id       |
| birthday      | string   | required           | 生日         |
| keys          | integer  | required           | 钥匙         |
| icon          | string   | required           | 用户头像       |
| new           | integer  | required           | 是否新用户      |
| access\_token | requires | 登录验证码              |            |

* token 为当前session信息
* expire session过期时间

2.5. 接口测试

```conf
1. 线上测试
curl -i -X POST \
-d "code=authorization_code" \
https://api.goowee.cn/v1/users/hw/signIn

```

## 20 用户注销

20.1 接口 `https://api.goowee.cn/v1/platform/logout` 20.2 请求方式 POST

20.3 输入

```conf
# 用户注销验证码——验证码方式
{"username": "13611778890", code: "111111", token: 'abcdefg'}

# 游客绑定手机时用
```

| 字段名称     | 类型     | 字段必须     | 备注         |
| -------- | ------ | -------- | ---------- |
| username | string | required | 用户名称       |
| code     | string | required | 注销验证码      |
| token    | string | required | session 字串 |

20.4. 输出

```conf
{
    "code":0,
    "message":"OK",
}
# 异常
# "Token 不正确"
# "用户不存在"
# "验证码不正确"
```

20.5. 接口测试

```conf
1. 线上测试
curl -i -X POST \
-d "username=13611778890&code=2889&token=" \
https://api.goowee.cn/v1/platform/logout

```

## 3 用户信息更新

3.1 接口 `https://api.goowee.cn/v1/users/update`

3.2 请求方式 POST

3.3 输入

```conf
{
    userId:740699410,
    token:,
    gender:1,
    birthday:2015-02-20,
    icon:29985757893291,
    nickname:cc,
    email:zh@163.com,
    phoneno:13822773391
}
```

| 字段名称     | 类型      | 字段必须               | 备注              |
| -------- | ------- | ------------------ | --------------- |
| userId   | string  | required           | 用户Id            |
| token    | string  | required           | token           |
| gender   | integer | option             | 性别 1:男 2:女      |
| birthday | string  | required or option | 验证码             |
| icon     | string  | option             | 头像唯一Id 一般为当前时间戳 |
| nickname | string  | option             | 昵称              |
| email    | string  | option             | 邮箱              |
| phoneno  | string  | option             | 绑定手机号           |

3.4. 输出

```conf
{
    "code":0,
    "message":"OK",
    "data":{
        "userInfo":{
            "userId":"740699410",
            "username":"13611778890",
            "nickname":"cc",
            "gender":"0",
            "birthday":"2015-02-20",
            "keys":"100",
            "icon":"129985757893291",
            "new":"0"
        }
    }
}
```

* userInfo信息结构说明

| 字段名称     | 类型      | 字段必须               | 备注         |
| -------- | ------- | ------------------ | ---------- |
| userId   | string  | require            | 用户Id       |
| username | string  | required           | 用户名称       |
| nickname | string  | required or option | 用户昵称       |
| gender   | integer | required           | 性别 1:男 2:女 |
| birthday | string  | required           | 生日         |
| keys     | integer | required           | 钥匙         |
| icon     | string  | required           | 用户头像       |
| new      | integer | required           | 是否新用户      |

3.5. 接口测试

```conf
1. 线上测试
# 更新用户数据
# nickname,birthday,gender,email,keys,phoneno,icon
curl -i -X POST \
-d "userId=740699410&token=&gender=1&birthday=2015-02-20&icon=129985757893291&nickname=cc&email=zh@163.com&phoneno=13822773391"  \
https://api.goowee.cn/v1/users/update

```

## 4 主场景信息

4.1 接口 `https://api.goowee.cn/v1/scene/init` 4.2 请求方式 POST

4.3 输入

```conf
{
    userId:740699410,
    token:
}
```

| 字段名称   | 类型     | 字段必须     | 备注    |
| ------ | ------ | -------- | ----- |
| userId | string | required | 用户Id  |
| token  | string | required | token |

4.4. 输出

```conf
{
    "code":0,
    "message":"OK",
    "data":{
        "userInfo":{
            "userId":"740699410",
            "username":"13611778890",
            "nickname":"cc",
            "gender":"0",
            "birthday":"2015-02-20",
            "keys":"100",
            "icon":"129985757893291",
            "new":"0"
        },
        "readInfo":{
            "bookId":"880001",
            "readTime":"2021-09-18"
        },
        "listenInfo":{
            "audioId":"610001"
        },
        "unlockInfo":[
            "880001","880002","880003",...
        ],
        "complete":[
            "880001","880002","880003",...
        ],
        "settingInfo":{
            "readingBooks"    :    3 ,
            "updateTime"    :    1632732973
        },
        "configInfo":{
            "books":[
                {
                "bookId":"880001","name":"糊涂的小海獭",
                "labelId":["某某科",""]
                "desc":"","icon":"Icon_880001",
                "price":"0","unlock":"0","discount":"",
                "order":"1","show":"1"
                },
                ...
            ],
            "orders":[
                {
                    "orderId":"18001","name":"1把钥匙",
                    "icon":"Icon_18001","prime":"5",
                    "present":"3","discount":"7","keys":"1"
                },
            ],
            "show":[
                "880001", "880002", "880003", ...
            ]
        } ,
    }
}
```

* userInfo信息结构说明

| 字段名称     | 类型      | 字段必须               | 备注         |
| -------- | ------- | ------------------ | ---------- |
| userId   | string  | require            | 用户Id       |
| username | string  | required           | 用户名称       |
| nickname | string  | required or option | 用户昵称       |
| gender   | integer | required           | 性别 1:男 2:女 |
| birthday | string  | required           | 生日         |
| keys     | integer | required           | 钥匙         |
| icon     | string  | required           | 用户头像       |
| new      | integer | required           | 是否新用户      |

* readInfo 最新阅读信息说明

| 字段名称     | 类型     | 字段必须     | 备注       |
| -------- | ------ | -------- | -------- |
| bookId   | string | require  | 最后阅读绘本Id |
| readTime | string | required | 最后阅读时间   |

* unlockInfo 解锁绘本信息为绘本Id列表
* complete 读完的绘本Id列表
* settingInfo 设置项信息说明

| 字段名称         | 类型      | 字段必须     | 备注        |
| ------------ | ------- | -------- | --------- |
| readingBooks | integer | required | 每天可阅读的书数量 |
| updateTime   | integer | required | 配置更新时间    |

* orders 商品配置信息说明

| 字段名称     | 类型      | 字段必须     | 备注    |
| -------- | ------- | -------- | ----- |
| orderId  | string  | require  | 商品Id  |
| name     | string  | required | 商品名称  |
| icon     | string  | required | 商品图标  |
| prime    | integer | required | 原价    |
| present  | integer | required | 现价    |
| discount | integer | required | 折扣    |
| keys     | integer | required | 获取钥匙数 |

* books 书籍配置信息说明

| 字段名称     | 类型      | 字段必须     | 备注                 |
| -------- | ------- | -------- | ------------------ |
| bookId   | string  | require  | 绘本Id               |
| name     | string  | required | 绘本名称               |
| desc     | string  | required | 绘本描述               |
| icon     | string  | required | 绘本图标               |
| price    | integer | required | 钥匙价格               |
| unlock   | integer | required | 解锁类型 0:免费解锁 1:钥匙解锁 |
| discount | integer | required | 折扣                 |
| order    | integer | required | 货架排序               |
| show     | integer | required | 是否显示在大厅            |

4.5. 接口测试

```conf
1. 线上测试
# 场景初始化接口
curl -i -X POST \
-d "userId=532188470&token=" \
https://api.goowee.cn/v1/scene/init

```

## 5 点击阅读绘本

5.1 接口 `https://api.goowee.cn/v1/books/click` 5.2 请求方式 POST

5.3 输入

```conf
{
    userId:740699410 ,
    bookId:880001 ,
    token:
}
```

| 字段名称   | 类型     | 字段必须     | 备注    |
| ------ | ------ | -------- | ----- |
| userId | string | required | 用户Id  |
| bookId | string | required | 绘本Id  |
| token  | string | required | token |

5.4. 输出

```conf
{
    "code":0,
    "message":"OK"
}

# 异常
10000：参数不正常
10001：Token不正确
30001：绘本不存在

```

* userInfo信息结构说明

| 字段名称     | 类型      | 字段必须               | 备注         |
| -------- | ------- | ------------------ | ---------- |
| userId   | string  | require            | 用户Id       |
| username | string  | required           | 用户名称       |
| nickname | string  | required or option | 用户昵称       |
| gender   | integer | required           | 性别 1:男 2:女 |
| birthday | string  | required           | 生日         |
| keys     | integer | required           | 钥匙         |
| icon     | string  | required           | 用户头像       |
| new      | integer | required           | 是否新用户      |

5.5. 接口测试

```conf
1. 线上测试
# 场景初始化接口
curl -i -X POST \
-d "userId=532188470&bookId=880001&token=" \
https://api.goowee.cn/v1/books/click

```

## 6 使用钥匙解锁

6.1 接口 `https://api.goowee.cn/v1/books/unlock` 6.2 请求方式 POST

6.3 输入

```conf
{
    userId:740699410 ,
    bookId:880001 ,
    token:
}
```

| 字段名称   | 类型     | 字段必须     | 备注    |
| ------ | ------ | -------- | ----- |
| userId | string | required | 用户Id  |
| bookId | string | required | 绘本Id  |
| token  | string | required | token |

6.4. 输出

```conf
{
    "code":0,
    "message":"OK",
    "data":{
        "userInfo":{
            "userId":"740699410",
            "username":"13611778890",
            "nickname":"136******56",
            "gender":"0",
            "birthday":"",
            "keys":"0",
            "icon":"",
            "new":"0"
        },
        "unlockInfo" : [
            "880003",
            "880004",
            "880005"
        ]
    }
}

# 异常
10000：参数不正常
10001：Token不正确
30002：绘本已经购买
30003：绘本是免费的
40011：钥匙不足

```

* userInfo信息结构说明

| 字段名称     | 类型      | 字段必须               | 备注         |
| -------- | ------- | ------------------ | ---------- |
| userId   | string  | require            | 用户Id       |
| username | string  | required           | 用户名称       |
| nickname | string  | required or option | 用户昵称       |
| gender   | integer | required           | 性别 1:男 2:女 |
| birthday | string  | required           | 生日         |
| keys     | integer | required           | 钥匙         |
| icon     | string  | required           | 用户头像       |
| new      | integer | required           | 是否新用户      |

* unlockInfo 解锁信息结构说明

| 字段名称     | 类型      | 字段必须               | 备注         |
| -------- | ------- | ------------------ | ---------- |
| userId   | string  | require            | 用户Id       |
| username | string  | required           | 用户名称       |
| nickname | string  | required or option | 用户昵称       |
| gender   | integer | required           | 性别 1:男 2:女 |
| birthday | string  | required           | 生日         |
| keys     | integer | required           | 钥匙         |
| icon     | string  | required           | 用户头像       |
| new      | integer | required           | 是否新用户      |

6.5. 接口测试

```conf
1. 线上测试
# 场景初始化接口
curl -i -X POST \
-d "userId=532188470&bookId=880001&token=" \
https://api.goowee.cn/v1/books/unlock

```

## 7 支付发货接口

7.1 接口 `https://api.goowee.cn/v1/orders/deliver` 7.2 请求方式 POST

7.3 输入

```conf
{
    userId:740699410 ,
    purchaseInfo:{\"autoRenewing\":false,\"orderId\":\"202109241542584543abc77331.104738673\",\"packageName\":\"org.goowee.animalcastle\",\"applicationId\":104738673,\"kind\":0,\"productId\":\"18000\",\"productName\":\"1把钥匙测试\",\"purchaseTime\":1632469387000,\"purchaseTimeMillis\":1632469387000,\"purchaseState\":0,\"developerPayload\":\"FeeHuawei\",\"purchaseToken\":\"0000017c16c20cf10c9ce3c4d8a147de9e4862b9b97bb3496b85b53cf60ff92259758f664659ad5dx434e.1.104738673\",\"consumptionState\":0,\"confirmed\":0,\"currency\":\"CNY\",\"price\":1,\"country\":\"CN\",\"payOrderId\":\"A2d04c9ab8253b6ffaeb1dc8e653f473\",\"payType\":\"4\",\"sdkChannel\":\"1\"}"   // json字符串
    token:
}
```

| 字段名称         | 类型          | 字段必须     | 备注                                           |
| ------------ | ----------- | -------- | -------------------------------------------- |
| userId       | string      | required | 用户Id                                         |
| purchaseInfo | json string | required | 购买信息 inAppPurchaseData->purchaseTokenData 部分 |
| token        | string      | required | token                                        |

7.4. 输出

```conf
{
    "code":0,
    "message":"OK",
    "data":{
        "userInfo":{
            "userId":"740699410",
            "username":"13611778890",
            "nickname":"136******56",
            "gender":"0",
            "birthday":"",
            "keys":"0",
            "icon":"",
            "new":"0"
        }
    }
}

# 异常
10000：参数不正常
10001：Token不正确

```

* userInfo信息结构说明

| 字段名称     | 类型      | 字段必须               | 备注         |
| -------- | ------- | ------------------ | ---------- |
| userId   | string  | require            | 用户Id       |
| username | string  | required           | 用户名称       |
| nickname | string  | required or option | 用户昵称       |
| gender   | integer | required           | 性别 1:男 2:女 |
| birthday | string  | required           | 生日         |
| keys     | integer | required           | 钥匙         |
| icon     | string  | required           | 用户头像       |
| new      | integer | required           | 是否新用户      |

7.5. 接口测试

```conf
1. 线上测试

# 验证并发货接口
curl -i -X POST \
-d "userId=740699410&token=&purchaseInfo={\"autoRenewing\":false,\"orderId\":\"202109241542584543abc77331.104738673\",\"packageName\":\"org.goowee.animalcastle\",\"applicationId\":104738673,\"kind\":0,\"productId\":\"18000\",\"productName\":\"1把钥匙测试\",\"purchaseTime\":1632469387000,\"purchaseTimeMillis\":1632469387000,\"purchaseState\":0,\"developerPayload\":\"FeeHuawei\",\"purchaseToken\":\"0000017c16c20cf10c9ce3c4d8a147de9e4862b9b97bb3496b85b53cf60ff92259758f664659ad5dx434e.1.104738673\",\"consumptionState\":0,\"confirmed\":0,\"currency\":\"CNY\",\"price\":1,\"country\":\"CN\",\"payOrderId\":\"A2d04c9ab8253b6ffaeb1dc8e653f473\",\"payType\":\"4\",\"sdkChannel\":\"1\"}" \
https://api.goowee.cn/v1/orders/deliver

```

## 8 支付订单列表

8.1 接口 `https://api.goowee.cn/v1/orders/list`

8.2 请求方式 POST

8.3 输入

```conf
{
    userId:740699410 ,
    token:
}
```

| 字段名称   | 类型     | 字段必须     | 备注    |
| ------ | ------ | -------- | ----- |
| userId | string | required | 用户Id  |
| token  | string | required | token |

8.4. 输出

```conf
{
    "code":0,
    "message":"OK",
    "data":{
        "orderList":[
            {
                "orderId":"GY202109261625011695shpaul4jax",
                "createTime":1632644701,
                "name":"钥匙X1测试",
                "keys":1,
                "price":0.01,
                "purchaseState":0
            }
        ]
    }
}

# 异常
10000：参数不正常
10001：Token不正确

```

* orderInfo 信息结构说明

| 字段名称          | 类型      | 字段必须     | 备注                            |
| ------------- | ------- | -------- | ----------------------------- |
| orderId       | string  | require  | 订单Id                          |
| createTime    | string  | required | 订单创建时间 例如：2021-01-01 12:00:00 |
| name          | string  | required | 商品名称                          |
| keys          | integer | required | 钥匙购买量                         |
| price         | float   | required | 支付金额                          |
| purchaseState | integer | required | -1：初始化 0：已购买 1：已取消 2：已退款      |

8.5. 接口测试

```conf
# 1. 线上测试
# 获取订单列表信息
curl -i -X POST \
-d "userId=740699410&token=" \
https://api.goowee.cn/v1/orders/list
```

## 9 设置更新

9.1 接口 `https://api.goowee.cn/v1/setting/update`

9.2 请求方式 POST

9.3 输入

```conf
{
    userId:740699410 ,
    token:,
    readingBooks: 3
}
```

| 字段名称         | 类型      | 字段必须     | 备注           |
| ------------ | ------- | -------- | ------------ |
| userId       | string  | required | 用户Id         |
| token        | string  | required | token        |
| readingBooks | integer | option   | 每次阅读数量 1-6 本 |

9.4. 输出

```conf
{
    "code":0,
    "message":"OK"
}

# 异常
10000：参数不正常
10001：Token不正确

```

9.5. 接口测试

```conf
# 1. 线上测试
# 设置参数接口
curl -i -X POST \
-d "userId=740699410&token=&readingBooks=3" \
https://api.goowee.cn/v1/setting/update
```

## 10 头像上传

10.1 接口 `https://api.goowee.cn/v1/images/upload`

10.2 请求方式 POST

10.3 输入

```conf
{
    userId:740699410 ,
    token:,
    type: "icon",
    image: "base64字符串"
}
```

| 字段名称   | 类型              | 字段必须        | 备注              |
| ------ | --------------- | ----------- | --------------- |
| userId | string          | required    | 用户名称            |
| token  | string          | required    | 验证码             |
| type   | string          | required    | 类型 icon:头像 .... |
| image  | string required | 图片base64字符串 |                 |

10.4. 输出

```conf
{
    "code":0,
    "message":"OK",
    "data":{
        "imageUrl":"https://oss.goowee.cn/x.png"
    }
}
```

10.5. 接口测试

```conf
1. 线上测试
curl -i -X POST \
-d "userId=740699410&token=&type=icon&image=...." \
https://api.goowee.cn/v1/images/upload

```

## 10 修改绑定手机号

10.1 接口 `https://api.goowee.cn/v1/users/bind/phone`

10.2 请求方式 POST

10.3 输入

```conf
{"userId": "123", code: "111111", "phoneno":13611778890}
```

| 字段名称    | 类型     | 字段必须               | 备注     |
| ------- | ------ | ------------------ | ------ |
| userId  | string | required           | 用户帐号Id |
| code    | string | required or option | 验证码    |
| phoneno | string | required           | 绑定手机号  |

10.4. 输出

```conf
{
    "code":0,
    "message":"OK",
    "data":{
        "userInfo":{
            "userId":"1073741825",
            "username":"13611778187",
            "nickname":"136******56",
            "gender":"1","birthday":"2015-02-20",
            "age":6,"keys":"0",
            "icon":"https://oss.goowee.cn/Icon_46dc30c9eb1aa22b8f4634006743a91d.jpg?v=51948725.73980427",
            "new":"0"
        }
    }
}
```

* userInfo信息结构说明

| 字段名称     | 类型      | 字段必须               | 备注         |
| -------- | ------- | ------------------ | ---------- |
| userId   | string  | require            | 用户Id       |
| username | string  | required           | 用户名称       |
| nickname | string  | required or option | 用户昵称       |
| gender   | integer | required           | 性别 1:男 2:女 |
| birthday | string  | required           | 生日         |
| keys     | integer | required           | 钥匙         |
| icon     | string  | required           | 用户头像       |
| new      | integer | required           | 是否新用户      |

* token 为当前session信息
* expire session过期时间

10.5. 接口测试

```conf
# 绑定手机号
curl -i -X POST \
-d "userId=1073741825&token=&code=2021&phoneno=13611778890" \
http://localhost:60006/v1/users/bind/phone

```

## 11 反馈信息接收

11.1 接口 `https://api.goowee.cn/v1/users/questions/receiver`

11.2 请求方式 POST

11.3 输入

```conf
{"userId": "123", visitorId:'abcd',types: "1,2,3", "content":"", "contact":"","token":"abc"}
```

| 字段名称      | 类型     | 字段必须               | 备注                  |
| --------- | ------ | ------------------ | ------------------- |
| userId    | string | required           | 用户帐号Id              |
| visitorId | string | option             | 游客Id                |
| types     | string | required           | 问题快捷选择 \[0-8]中一项或几项 |
| content   | string | required           | 内容描述 500字符以内        |
| contact   | string | required or option | 联系方式                |
| token     | string | required           | 当前登录凭证              |

11.4. 输出

```conf
{
    "code":0,
    "message":"OK"
}
```

11.5. 接口测试

```conf
# 绑定手机号
curl -i -X POST \
-d "userId=1073741825&token=&types=1,2,3&content=发生了一个错误，hello world&contact=zhaofei@goowee.cn" \
http://localhost:60006/v1/users/questions/receiver

```

## 12 活动奖励领取

12.1 接口 `https://api.goowee.cn/v1/reward/claim`

12.2 请求方式 POST

12.3 输入

```conf
{"userId": "123", activityId: "60001",token":"abc"}
```

| 字段名称       | 类型      | 字段必须     | 备注                                                    |
| ---------- | ------- | -------- | ----------------------------------------------------- |
| userId     | string  | required | 用户帐号Id                                                |
| activityId | integer | required | 活动Id 60001:880001, // 绑定手机号奖励. 60002:880003 // 问卷调查奖励 |
| token      | string  | required | 当前登录凭证                                                |

12.4. 输出

```conf
{
    "code":0,
    "message":"OK",
    "data": {
     "rewardInfo": [{"activityId": 60001, "reward": 880001}, ...]
    }
}
```

12.5. 接口测试

```conf
# 活动奖励领取
curl -i -X POST \
-d "activityId=60001&userId=1532188470&token=" \
https://api.goowee.cn/v1/reward/claim

```

## 13 完成阅读绘本

13.1 接口 `https://api.goowee.cn/v1/books/complete` 13.2 请求方式 POST

13.3 输入

```conf
{
    userId:740699410 ,
    bookId:880001 ,
    token:
}
```

| 字段名称   | 类型     | 字段必须     | 备注    |
| ------ | ------ | -------- | ----- |
| userId | string | required | 用户Id  |
| bookId | string | required | 绘本Id  |
| token  | string | required | token |

13.4. 输出

```conf
{
    "code":0,
    "message":"OK"
}

# 异常
10000：参数不正常
10001：Token不正确
30001：绘本不存在

```

13.5. 接口测试

```conf
# 1. 线上测试
# 场景初始化接口
curl -i -X POST \
-d "userId=532188470&bookId=880001&token=" \
https://api.goowee.cn/v1/books/complete
```

## 14 苹果支付发货接口

14.1 接口 `https://api.goowee.cn/v1/orders/receiver` 14.2 请求方式 POST

14.3 输入

```conf
{
    userId:740699410 ,
    receipt:abc ,
    token:
}
```

| 字段名称    | 类型      | 字段必须     | 备注               |
| ------- | ------- | -------- | ---------------- |
| userId  | string  | required | 用户Id             |
| receipt | string  | required | Base64 App前端订单数据 |
| env     | integer | option   | 0:正式 1:测试 环境     |
| token   | string  | required | token            |

14.4. 输出

```conf
{
    "code":0,
    "message":"OK",
    "data": {
        "userInfo":{
            "userId":"740699410",
            "username":"13611778890",
            "nickname":"136******56",
            "gender":"0",
            "birthday":"",
            "keys":"0",
            "icon":"",
            "new":"0"
        }
    }
}

# 其他
```

14.5. 接口测试

```conf
# 1. 线上测试
# 场景初始化接口
curl -i -X POST \
-d "userId=532188470&receipt=abc&token=" \
https://api.goowee.cn/v1/orders/receiver
```

## 15 点击听音频

15.1 接口 `https://api.goowee.cn/v1/audio/listen` 15.2 请求方式 POST

15.3 输入

```conf
{
    userId:740699410 ,
    visitorId:"",
    audioId:620001 ,
    token:
}
```

| 字段名称      | 类型     | 字段必须     | 备注    |
| --------- | ------ | -------- | ----- |
| userId    | string | required | 用户Id  |
| visitorId | string | option   | 游客Id  |
| audioId   | string | required | 音频Id  |
| token     | string | required | token |

15.4. 输出

```conf
{
    "code":0,
    "message":"OK"
}

# 异常
10000：参数不正常
10001：Token不正确
30001：音频不存在

```

15.5. 接口测试

```conf
# 1. 线上测试
# 场景初始化接口
curl -i -X POST \
-d "userId=532188470&audioId=620001&visitorId=&token=" \
https://api.goowee.cn/v1/audio/listen
```

## 16 绘本分享

16.1 接口 `https://api.goowee.cn/v1/books/share` 16.2 请求方式 POST

16.3 输入

```conf
{
    userId:740699410 ,
    bookId: ,
    token:
}
```

| 字段名称   | 类型     | 字段必须     | 备注    |
| ------ | ------ | -------- | ----- |
| userId | string | required | 用户Id  |
| bookId | string | required | 绘本Id  |
| token  | string | required | token |

16.4. 输出

```conf
{
    "code":0,
    "message":"OK",
    "data":{
        "userInfo":{
            "userId":"740699410",
            "username":"13611778890",
            "nickname":"136******56",
            "gender":"0",
            "birthday":"",
            "keys":"0",
            "icon":"",
            "new":"0"
        }
    }
}

# 异常
10000：参数不正常
10001：Token不正确

```

* userInfo信息结构说明

| 字段名称     | 类型      | 字段必须               | 备注         |
| -------- | ------- | ------------------ | ---------- |
| userId   | string  | require            | 用户Id       |
| username | string  | required           | 用户名称       |
| nickname | string  | required or option | 用户昵称       |
| gender   | integer | required           | 性别 1:男 2:女 |
| birthday | string  | required           | 生日         |
| keys     | integer | required           | 钥匙         |
| icon     | string  | required           | 用户头像       |
| new      | integer | required           | 是否新用户      |

16.5. 接口测试

```conf
# 1. 线上测试
# 场景初始化接口
curl -i -X POST \
-d "userId=&bookId=&token=" \
https://api.goowee.cn/v1/books/share

```

## 17 绘本事件

17.1 接口 `https://api.goowee.cn/v1/books/trigger` 17.2 请求方式 POST

17.3 输入

```conf
{
    userId:740699410 ,
    bookId:880001 ,
    eventId: 'scene0', # 事件key
    token:
}
```

| 字段名称    | 类型     | 字段必须     | 备注    |
| ------- | ------ | -------- | ----- |
| userId  | string | required | 用户Id  |
| bookId  | string | required | 绘本Id  |
| eventId | string | required | 事件key |
| token   | string | required | token |

17.4. 输出

````conf
{
    "code":0,
    "message":"OK",
    "data":{
        "userEventInfo":{
            "880001": ['eventId1', 'eventId2', ...],
            "880002": ...
        }
    }
}

# 异常
10000：参数不正常
10001：Token不正确

```conf

17.5.  接口测试

```conf
# 1. 线上测试
# 场景初始化接口
curl -i -X POST \
-d "userId=&bookId=&token=" \
https://api.goowee.cn/v1/books/trigger

````


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://doc.goowee.cn/api.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.