# Pinterest OAuth 设置

## 1. 创建 Pinterest Developer App

1. 打开 `https://developers.pinterest.com/`。
2. 使用 Pinterest Business 账号登录。
3. 创建或打开一个 app。
4. 记录 `App ID / Client ID` 和 `Client Secret`。
5. 在 app 的 redirect URI 中加入：

```text
http://127.0.0.1:3000/api/auth/pinterest/callback
```

如果你用的是 `localhost:3000` 或生产域名，redirect URI 必须和实际访问地址完全一致。

## 2. 配置本地环境

复制 `.env.example` 为 `.env`，填写：

```text
PINTEREST_CLIENT_ID=...
PINTEREST_CLIENT_SECRET=...
PINTEREST_REDIRECT_URI=http://127.0.0.1:3000/api/auth/pinterest/callback
```

## 3. 启动并授权

```bash
npm run dev
```

打开：

```text
http://127.0.0.1:3000/api/auth/pinterest/start?redirect=1
```

Pinterest 授权完成后会回到 callback 页面，并把 token 信息保存到 `data/db.json`。

## 4. 默认请求的 scopes

当前默认请求：

- `boards:read`
- `boards:write`
- `pins:read`
- `pins:write`
- `user_accounts:read`

后续接入广告、目录、趋势和线索表单时，再增加对应 scopes。

## 5. 状态检查

```text
GET /api/auth/pinterest/status
GET /api/integrations/openclaw/health
```

## 6. 注意

- 不要提交 `.env`。
- `data/db.json` 会保存本地 token，生产化前要改成加密存储。
- Pinterest Developer Guidelines 要求用户知情并选择每项对外动作，发布、关注、评论、消息仍应保留人工确认。
