# Nishare 快速使用文档
Nishare 用来把 AI 生成的 HTML、图片、文档或文案发布成可分享链接。
## 最快用法
当用户要求“发布到 Nishare”“生成分享链接”“发给伙伴或客户查看”时，把内容发布到：
```text
POST https://nishare.com/api/ai/publish
```
成功后只返回响应里的 `shareUrl`。失败时返回响应里的 `message`。
## 匿名发布
匿名发布不需要 API Key。适合快速体验。
```bash
curl -s https://nishare.com/api/ai/publish \
-H 'Content-Type: application/json' \
-d '{"title":"AI 生成演示","type":"html","html":"Hello Nishare
"}'
```
匿名发布会直接返回可访问的分享链接。
## 使用 API Key
用户提供 API Key 时，在请求头加入：
```text
X-Nishare-Key: nsk_xxx
```
或：
```text
Authorization: Bearer nsk_xxx
```
带 API Key 发布的内容会进入用户账号，支持管理、Workspace 和后续更新。
## 发布 HTML
```json
{
"title": "页面标题",
"type": "html",
"html": "完整 HTML"
}
```
HTML 必须是完整页面，以 `` 或 `` 开头，不要包 Markdown 代码围栏。
## 发布 Markdown
```json
{
"title": "文档标题",
"type": "markdown",
"markdown": "# Markdown 内容"
}
```
## 发布图片
```json
{
"title": "图片标题",
"type": "image",
"imageDataUrl": "data:image/png;base64,..."
}
```
也可以使用 `imageUrl`。
## 更新项目
更新已有项目需要 API Key：
```text
POST https://nishare.com/api/ai/update
```
```json
{
"projectId": "项目ID",
"title": "更新后的标题",
"type": "html",
"html": "完整 HTML"
}
```
## 推荐给 AI 的提示词
匿名体验：
```text
阅读并学习文档 https://nishare.com/skill.md，把内容归纳做成HTML发布到nishare，返回分享地址！
```
使用 API Key：
```text
阅读并学习文档 https://nishare.com/skill.md，记住API KEY为：nsk_xxx，把nishare使用方法做成HTML发布到nishare，返回分享地址！
```