Nishare API

Use this skill when helping a user or another AI tool publish generated content to Nishare.

Quick Workflow

1. Choose the base URL:
   - Production: https://nishare.com
   - Local development: http://localhost:4173
2. Choose an endpoint:
   - Create a share: POST /api/ai/publish
   - Update an existing project: POST /api/ai/update
3. Choose content type:
   - HTML: full HTML document only
   - Markdown: document text
   - Image: imageDataUrl, imageBase64, or imageUrl
4. Add authentication only when publishing into an account/workspace or updating:
   - X-Nishare-Key: nsk_xxx, or
   - Authorization: Bearer nsk_xxx
5. Return shareUrl to the user on success. On failure, surface message and any matches.

Copyable Agent Prompt

Use this prompt when instructing another AI tool:

把内容发布到 Nishare：POST https://nishare.com/api/ai/publish，成功后返回 shareUrl，失败时返回 message。

For full HTML pages:

请把你生成的完整页面 HTML 通过 POST 发送到 https://nishare.com/api/ai/publish，JSON 格式为 {"title":"页面标题","type":"html","html":"完整页面 HTML"}，然后把响应里的 shareUrl 返回给我。

Essential Examples

Publish HTML:

curl -s https://nishare.com/api/ai/publish \
  -H 'Content-Type: application/json' \
  -d '{"title":"AI 生成演示","type":"html","html":"<!doctype html><html><body><h1>Hello</h1></body></html>"}'

Publish with API Key:

curl -s https://nishare.com/api/ai/publish \
  -H 'Content-Type: application/json' \
  -H 'X-Nishare-Key: nsk_xxx' \
  -d '{"title":"AI 生成演示","type":"html","html":"<!doctype html><html><body><h1>Hello</h1></body></html>"}'

Update a project:

curl -s https://nishare.com/api/ai/update \
  -H 'Content-Type: application/json' \
  -H 'X-Nishare-Key: nsk_xxx' \
  -d '{"projectId":"project_id","title":"更新后的演示","type":"html","html":"<!doctype html><html><body><h1>Updated</h1></body></html>"}'

Detailed Reference

Read references/api.md when you need:

• All accepted payload fields and headers
• Markdown, image, raw HTML, or text examples
• Workspace targeting
• Response shapes
• Validation limits and common errors