API 概览

ShareDoMagic 提供 RESTful API，所有操作通过 /api/share 端点完成。

认证

API 使用 MD5 双重哈希认证：

auth = md5(username + md5(password) + YYYYMMDD)

默认账号：share / domagic

接口列表

创建分享

POST /api/share?action=create&auth=<token>

Content-Type: application/json 或 multipart/form-data

JSON Body:

{
  "type": "text",
  "content": "分享内容",
  "code": "可选自定义码",
  "key": "可选密钥"
}

响应:

{
  "success": true,
  "code": "abc123",
  "links": {
    "api": "/api/share/abc123",
    "web": "/s/abc123"
  }
}

查看分享

GET /api/share/<code>?action=read[&key=<密钥>]

更新文本分享

POST /api/share/<code>?action=update&auth=<token>&key=<密钥>

Body: {"content": "新内容"}

删除分享

DELETE /api/share/<code>?action=delete&auth=<token>&key=<密钥>

大小限制

| 类型 | 上限 |

|------|------|

| 文本 | 10 MB |

| 图片 | 100 MB |

| 文件 | 600 MB |

速率限制

内置速率限制防止滥用，超限返回 429。