bilibili-API-collect/docs/user/contract.md

# 加入老粉计划

> https://api.bilibili.com/x/v1/contract/add_contract

*请求方式：POST*

是否需要登录：`是`

认证方式：Cookie(SESSDATA)

**正文参数 (application/x-www-form-urlencoded)：**

| 参数名      | 类型  | 内容     | 必要性 | 备注  |
|----------|-----|--------|-----|-----|
| aid      | str | `空串`   |     |     |
| up_mid   | str | UP主UID | 必要  |     |
| source   | str | `4`    |     |     |
| scene    | str | `105`  |     |     |
| platform | str | `web`  |     |     |
| mobi_app | str | `pc`   |     |     |
| csrf     | str | 用户csrf | 必要  |     |

**json回复：**

根对象：

| 字段名     | 类型  | 内容   | 备注                      |
|---------|-----|------|-------------------------|
| code    | num | 响应码  | 0：成功<br/>158001：`不满足条件` |
| message | str | 0    |                         |
| ttl     | num | 1    |                         |
| data    | obj | 信息本体 |                         |

`data`对象

| 字段名           | 类型   | 内容                                | 备注  |
|---------------|------|-----------------------------------|-----|
| allow_message | bool | `true`                            |     |
| input_text    | str  | `UP主加油！看好你噢`                      |     |
| input_title   | str  | `感谢你对UP主的特别支持，“老粉”可期！私信留言鼓励下TA吧 ` |     |

**示例：**

```shell
curl --location --request POST 'https://api.bilibili.com/x/v1/contract/add_contract' \
--header 'Cookie: SESSDATA=xxx' \
--header 'Content-Type: application/x-www-form-urlencoded' \
--data-urlencode 'up_mid=2' \
--data-urlencode 'csrf=xxx'
```

<details>
<summary>点击查看</summary>

```json
{
  "code": 0,
  "message": "0",
  "ttl": 1,
  "data": {
    "allow_message": true,
    "input_text": "UP主加油！看好你噢",
    "input_title": "感谢你对UP主的特别支持，“老粉”可期！私信留言鼓励下TA吧 "
  }
}
```

</details>

# 老粉计划发送留言

> https://api.bilibili.com/x/v1/contract/add_message

*请求方式：POST*

认证方式：Cookie (SESSDATA)

**正文参数 (application/x-www-form-urlencoded)：**

| 参数名     | 类型  | 内容     | 必要性 | 备注  |
|---------|-----|--------|-----|-----|
| aid     | str | `空串`   |     |     |
| up_mid  | str | UP主UID | 必要  |     |
| source  | str | `4`    |     |     |
| scene   | str | `105`  |     |     |
| content | str | 留言内容   | 必要  |     |
| csrf    | str | 用户csrf | 必要  |     |

**json回复：**

根对象：

| 字段名     | 类型  | 内容   | 备注                           |
|---------|-----|------|------------------------------|
| code    | num | 响应码  | 0：成功<br/>158005：您跟up主还不是契约关系 |
| message | str | 0    |                              |
| ttl     | num | 1    |                              |
| data    | obj | 信息本体 |                              |

`data`对象

| 字段名           | 类型  | 内容               | 备注  |
|---------------|-----|------------------|-----|
| success_toast | str | `提交成功，UP主已收到留言~` |     |

**示例：**

```shell
curl --location --request POST 'https://api.bilibili.com/x/v1/contract/add_message' \
--header 'Cookie: SESSDATA=xxx' \
--header 'Content-Type: application/x-www-form-urlencoded' \
--data-urlencode 'up_mid=2' \
--data-urlencode 'content=..' \
--data-urlencode 'csrf=xxx'
```

<details>
<summary>点击查看</summary>

```json
{
  "code": 0,
  "message": "0",
  "ttl": 1,
  "data": {
    "success_toast": "提交成功，UP主已收到留言~"
  }
}
```

</details>