# 圈子管理

## 创建圈子

<mark style="color:green;">`POST`</mark> `/circle/circle/create`

**需要登录！**

#### Request Body

| Name         | Type    | Description                       |
| ------------ | ------- | --------------------------------- |
| name         | string  | 名字(1\~30个字)                       |
| cdesc        | string  | 描述(1\~255个字)                      |
| interval     | string  | 打卡间隔(枚举类型：hour, day, week, month) |
| max\_goalnum | integer | 最大目标数                             |
| logo         | string  | logo，暂不支持                         |

{% tabs %}
{% tab title="200 " %}

```javascript
{
    "code": 0,
    "msg": "ok",
    "data": 5
}
```

{% endtab %}
{% endtabs %}

## &#x20;修改圈子

<mark style="color:green;">`POST`</mark> `/circle/circle/update`

&#x20;需要登录！

#### Request Body

| Name  | Type    | Description  |
| ----- | ------- | ------------ |
| id    | integer | ID           |
| name  | string  | 名字(1\~30个字)  |
| cdesc | string  | 描述(1\~255个字) |
| logo  | string  | logo，暂不支持    |

{% tabs %}
{% tab title="200 " %}

```
{
    "code": 0,
    "msg": "ok",
    "data": 5
}
```

{% endtab %}
{% endtabs %}

## &#x20;获取所有圈子列表

<mark style="color:green;">`POST`</mark> `/circle/circle/getalllist`

&#x20;两种分页参数二选一

#### Request Body

| Name  | Type    | Description |
| ----- | ------- | ----------- |
| index | integer | 索引偏移量(>=0)  |
| page  | integer | 页码(>=1)     |

{% tabs %}
{% tab title="200 " %}

```
{
    "code": 0,
    "msg": "ok",
    "data": {
        "list": [
            {
                "id": "1",
                "name": "文学社", //圈子名字
                "cdesc": "aaadddd", //圈子描述
                "logo": "", //logo
                "people_count": "0",//圈子人数
                "punch_count": "0", //打卡数量
                "max_goalnum": "3", //每个人可设置最大目标数
                "user_id": "yonghuid", // 用户ID
                "interval": "Ymd", //时间间隔
                "ctime": "2018-11-18 21:07:32" //创建时间
            }
        ],
        "count": "5"
    }
}
```

{% endtab %}
{% endtabs %}

## &#x20;获取我的圈子列表

<mark style="color:green;">`POST`</mark> `/circle/circle/getmylist`

&#x20;需要登录！

{% tabs %}
{% tab title="200 " %}

```
{
    "code": 0,
    "msg": "ok",
    "data": {
        "list": [
            {
                "id": "1",
                "name": "文学社", //圈子名字
                "cdesc": "aaadddd", //圈子描述
                "logo": "", //logo
                "people_count": "0",//圈子人数
                "punch_count": "0", //打卡数量
                "max_goalnum": "3", //每个人可设置最大目标数
                "user_id": "yonghuid", // 用户ID
                "interval": "Ymd", //时间间隔
                "ctime": "2018-11-18 21:07:32" //创建时间
            }
        ]
    }
}
```

{% endtab %}
{% endtabs %}
